ASexpert

ASexpert is a React Native application designed to help students manage their university assignments. It allows users to select a semester, view assignment deadlines, and access the required learning outcomes for each assignment. The app provides a clean interface with a calendar view and individual assignment cards for easy navigation.

Features

• Semester Selection: Choose your semester (e.g., HNC First Sem, First Module).
• Assignment Information: View assignment details for each selected semester.
• Calendar View: Displays assignment start and end dates for assignments.
• Learning Outcomes: Each assignment contains 4 Learning Outcomes (Lo1 to Lo4), displayed on separate pages.
• Notifications Screen: Keep track of upcoming assignments.
• Profile Screen: View and manage your profile.

Future Features

• User Authentication: Personalized features for each user.
• Push Notifications: Notifications for upcoming assignments and deadlines.
• Enhanced Calendar: Flexible calendar with Learning Outcome end dates and periods.
• UI/UX Improvements: Improved design and user experience.
• App Logo: A custom logo for a more professional appearance.

Installation

1. Clone the repository:

   git clone https://github.com/kyawzinthant-coding/AsExpert.git

2. Navigate to the project directory:

   cd asexpert

3. Install dependencies:

   pnpm install

4. Start the development server:

   pnpm start

5. Run on your device or emulator:

   • For iOS:

     pnpm run ios

   • For Android:

     pnpm run android

Contribution Guide

Welcome contributions to ASexpert! Follow the guidelines below to get started.

How to Contribute

1. Fork the repository: Click the "Fork" button at the top right of this page to create a copy of the repository in your GitHub account.

2. Clone your fork: Clone your forked repository to your local machine using the following command:

   git clone https://github.com/yourusername/asexpert.git

3. Create a new branch: Always create a new branch for your changes:

   git checkout -b feature/your-feature-name

4. Make your changes: Develop the feature or fix you want to contribute. Make sure your code is clean and follows the project's style guide.

5. Commit your changes: Write a clear and concise commit message:

   git commit -m "Add feature: description of feature"

6. Push to your fork: Push your changes to your forked repository:

   git push origin feature/your-feature-name

7. Submit a Pull Request (PR): Go to the original repository and click on "New Pull Request". Choose the branch you want to merge from your fork, and submit the PR.

Code Guidelines

• Follow the existing code structure.
• Use clear and concise naming for variables and functions.
• Ensure code is linted and formatted.
• Write comments for any complex logic.
• Test your changes thoroughly.

Issues

If you find a bug or have an idea for an improvement, feel free to create an issue. Make sure to describe the problem or feature in detail.

Getting Help

If you need help or have questions, feel free to reach out by opening a GitHub issue or contacting the project maintainer.