https://github.com/akarshguptaa/torotalk
A Spanish Teaching App
https://github.com/akarshguptaa/torotalk
android android-application android-development android-studio androidstudio duolingo language-learning spanish spanish-language spanish-learning
Last synced: 5 months ago
JSON representation
A Spanish Teaching App
- Host: GitHub
- URL: https://github.com/akarshguptaa/torotalk
- Owner: AkarshGuptaa
- License: gpl-3.0
- Created: 2024-04-23T07:15:22.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-10T08:36:15.000Z (almost 2 years ago)
- Last Synced: 2025-02-11T14:24:25.026Z (over 1 year ago)
- Topics: android, android-application, android-development, android-studio, androidstudio, duolingo, language-learning, spanish, spanish-language, spanish-learning
- Language: Kotlin
- Homepage:
- Size: 9.19 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Torotalk
**Torotalk** is an innovative Spanish language teaching app developed in Android Studio using Kotlin. Unlike traditional language learning apps, Torotalk emphasizes understanding the logic behind the language, making it easier and more intuitive to learn Spanish.
## Table of Contents
- [About the Project](#about-the-project)
- [Features](#features)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Usage](#usage)
- [Future Plans](#future-plans)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
## About the Project
Traditional language learning apps often focus on rote memorization, which can be tedious and ineffective. Torotalk takes a different approach by teaching the rules and logic of Spanish, allowing users to understand and construct sentences naturally.
Torotalk's teaching method includes:
- **Rule-Based Learning**: Explaining how English words translate to Spanish using logical rules.
- For example, words ending in "ly" in English are transformed to end with "mente" in Spanish (e.g., "quickly" becomes "rápidamente").
- Words like "preparation" are understood as "preparación" in Spanish, derived from the verb "preparar" (to prepare).
- **Interactive Quizzes**: Reinforcing the learned rules with quizzes after each lesson.
- **Real-time Feedback**: Providing instant correction and scoring to guide learning.
## Features
- **Firebase Authentication**: Secure user sign-up and login.
- **Firestore Integration**: Dynamic storage of quiz questions and answers for easy updates.
- **Text and Quiz Integration**: Lessons followed by quizzes to reinforce learning.
- **Score Tracking**: Keeps track of quiz scores and progress.
- **User-friendly Interface**: Intuitive design for a seamless learning experience.
## Getting Started
### Prerequisites
Ensure you have the following installed:
- [Android Studio](https://developer.android.com/studio)
- [Kotlin](https://kotlinlang.org/)
- [Google Firebase](https://firebase.google.com/)
### Installation
1. **Clone the Repository:**
```bash
git clone https://github.com/yourusername/torotalk.git
```
2. **Open in Android Studio:**
- Open Android Studio and select `File > Open`.
- Navigate to the cloned repository and select the project.
3. **Configure Firebase:**
- Add your `google-services.json` file to the `app` directory.
- Set up Firebase Authentication and Firestore as per your Firebase project settings.
4. **Build the Project:**
- Sync the project with Gradle files and build the project using the `Build` option in Android Studio.
## Usage
1. **Launch the App**:
- Run the app on an emulator or a physical Android device.
2. **Sign Up / Log In**:
- Create an account or log in using your credentials.
3. **Learn and Quiz**:
- Start with the lessons to understand the rules.
- Proceed to quizzes to test your understanding.
- Track your scores and progress as you go through each lesson.
4. **Progression**:
- Continue with subsequent lessons and quizzes to further enhance your Spanish skills.
## Future Plans
Torotalk aims to expand with additional features:
- **90 Total Lessons**: Adding a comprehensive set of lessons covering various aspects of Spanish.
- **Messaging Feature**: Enable users to practice Spanish with native speakers or other learners.
- **AI Companion**: Integrate an AI chat feature for conversational practice.
## Contributing
Contributions are welcome! Please follow these steps:
1. Fork the project.
2. Create your feature branch (`git checkout -b feature/YourFeature`).
3. Commit your changes (`git commit -m 'Add your feature'`).
4. Push to the branch (`git push origin feature/YourFeature`).
5. Open a pull request.
## License
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
## Contact
**Akarsh Gupta**
- [GitHub Profile](https://github.com/AkarshGuptaa)
- [Email](mailto:akarshguptaaa@gmail.com)
YOU WILL NOT BE ABLE TO GET ALL THE QUESTIONS FROM MY GOOGLE FIRESTORE AS YOU WILL HAVE TO ADD IN YOUR OWN GOOGLE LICENSE KEY BY MAKING A NEW FIREBASE AND IMPORT IT IN YOUR ANDROID STUDIO