Skip to content

Latest commit

 

History

History
117 lines (79 loc) · 4.29 KB

README.md

File metadata and controls

117 lines (79 loc) · 4.29 KB
Raw

Ace iT

Past-questions based exam preparation app.

Visit the website.

Screenshot

Table of contents

Inspiration

Most exam questions tend to follow a similar structure to past questions, and some teachers even repeat questions. However, after exams, students often discard their question papers, only to scramble for them when exams approach again.

I recall a moment during my 200-level studies when I overheard a group of students discussing how the structure of their current exam questions matched past questions. They mentioned the usefulness of apps for past JAMB or WAEC questions and wished for a mobile app that could provide easy access to past questions across various subjects.

Realizing this need, I saw an opportunity to create a solution. When the time came to choose a project for my ALX specializations phase, I decided to build a product that would make accessing past questions easier for students. This app aims to help students prepare effectively, ensuring they have the resources they need to succeed.

Getting Started

Follow these instructions to set up and run the Ace iT app on your local machine for development and testing purposes.

  • Requirements

    Ensure you have the following installed:

    • Flutter SDK
    • Dart (included with Flutter)
    • An IDE like VSCode or Android Studio
    • After setting up a new project on Firebase console, download and add valid Google Services configuration file for Firebase integration:
      • Android: google-services.json
      • iOS: GoogleService-Info.plist

  • Installation

    • Clone the repository:

      git clone https://github.com/sixtusagbo/aceit
cd aceit

    • Install Flutter dependencies:

      flutter pub get

    • Set up the environment variables:

      • Copy over the .env.example file to a new file called development.env (or your preferred name).
      • Update the env variables with the appropriate values from Firebase console.

    • Run the code generator:

      To build:

      dart run build_runner build -d

      Run in watch mode if you'll be making more changes:

      dart run build_runner watch -d

    • Run the app

      Make sure you have an emulator running or a physical device connected, then:

      • On CLI: flutter run
      • On VSCode: Ctrl + F5
      • On Android Studio: ``

Technologies

  • Dart (Language)
  • Flutter (Framework)
  • Firebase (BaaS)

Future

There are many features I want to add, this is an MVP for now. Features like:

  • Notifications
  • AI integration

Contributing

You can open an issue or if you wish to add a feature:

  • Fork the repo
  • Create a branch for your new feature ( git checkout -b my-new-feature )
  • Follow the getting started instructions
  • Write the code for your feature
  • Commit your changes (git commit -am 'Added some feature')
  • Push to a new feature branch (git push origin my-new-feature)
  • Create a new Pull Request

Acknowledgements

In a very special way, my acknowledgement goes to the ALX team, to Julien for his never ending stream of encouraging words.

Also, I’d like to specially recognize my colleagues in Listacc here and also my bosses Sir Vincent and Sir Agozie, they’ve given me immense support through this period.

Author

Built with 💖 by Sixtus Miracle Agbo

Twitter | LinkedIn | Youtube | Email