Skip to content

Latest commit

 

History

History
108 lines (77 loc) · 4.22 KB

README.md

File metadata and controls

108 lines (77 loc) · 4.22 KB

Torotalk

Torotalk Logo

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

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:

Installation

  1. Clone the Repository:

    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 file for details.

Contact

Akarsh Gupta

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