https://github.com/manya7547/num_quest
Bilingual gaming app
https://github.com/manya7547/num_quest
Last synced: over 1 year ago
JSON representation
Bilingual gaming app
- Host: GitHub
- URL: https://github.com/manya7547/num_quest
- Owner: Manya7547
- Created: 2024-05-20T22:08:05.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-26T00:05:01.000Z (over 1 year ago)
- Last Synced: 2025-02-26T00:27:25.066Z (over 1 year ago)
- Language: Dart
- Size: 5.52 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Num Quest
Num Quest is a bilingual educational application designed to teach number theory concepts to Hispanic Spanish-speaking children. The app includes lessons, practice exercises, and educational games to help children learn math and English.
# Features
- Bilingual Support: English and Spanish language options.
- Lessons: Detailed explanations of number theory concepts.
- Practice: Interactive exercises to reinforce learning.
- Play: Fun educational games to make learning enjoyable.
- Voice-overs: Narration available in both languages.
- Quizzes: Assess understanding with quizzes.
- Flashcards: Visual aids for learning numbers and concepts.
# Getting Started
Follow these instructions to set up and run the Num Quest project on your local machine.
## Prerequisites
- Flutter SDK: Make sure Flutter is installed. You can download it from Flutter's official website.
- Dart SDK: Dart is included with Flutter, so no separate installation is needed.
- VS Code: Install Visual Studio Code from here.
- Android Studio / Xcode: Required for Android/iOS emulators. Follow the installation guides for Android Studio here and Xcode here.
## Installation
Clone the Repository
git clone https://github.com/yourusername/num-quest.git
Navigate to the Project Directory:
cd num-quest
Install Dependencies:
flutter pub get
## Running the Application
### Using VS Code
- Open the Project in VS Code
- Launch VS Code and open the num-quest project folder.
- Open the Integrated Terminal
- You can open the terminal in VS Code by selecting Terminal > New Terminal from the top menu.
- Run the App
In the terminal, type the following command to start the app:
flutter run
This will build the project and launch it in the connected simulator or device.
### Using a Simulator
For Android:
- Open Android Studio
- Launch Android Studio and start an Android Emulator from the AVD Manager (Tools > AVD Manager).
- Run the App
- In the terminal, type: flutter run
- The app will build and deploy to the selected emulator.
For iOS:
- Open Xcode
- Launch Xcode and start an iOS Simulator from the Xcode > Preferences > Components menu.
- Run the App
- In the terminal, type: flutter run
- The app will build and deploy to the selected simulator.
Additional Notes
- Ensure your device or emulator/simulator is running before executing flutter run.
- For debugging, you can use the VS Code debugger by setting breakpoints and running the app in debug mode.