Skip to content

codedbyaman/aTable

Repository files navigation

aTable logo

Learn math tables in fun way 🧮

Powered by Material You (dynamic light / dark theme), bilingual Text‑to‑Speech, haptic feedback & quizzes.

License CI Stars Min SDK


🖼️ Overview

aTable is a lightweight Android app for students, teachers and parents to practise, quiz and listen to tables in English or Hindi.

aTable.mp4

📑 Contents

Built with Kotlin 1.9, AGP 8, Material 3 and follows Google’s modern Android guidelines.


✨ Features

Category Highlights
Learn & Practise 🎙️ Dual‑language Text‑to‑Speech
📳 Haptic feedback on inputs & correct / wrong answers
🖋️ Chalk‑board theme that adapts to Material You
Quiz ⏱️ Timed rounds with score & streak
📈 Adaptive difficulty (larger numbers as you improve)
Accessibility & UX 🔊 Full TalkBack labels & scalable fonts
🎨 Automatic light / dark theme
✨ Adaptive launcher & shortcut icons

⚡ Quick Start

# 1. Clone your fork
git clone https://github.com/<you>/aTable.git && cd aTable

# 2. Run on a connected device / emulator
./gradlew installDebug

Requires: Android Studio Hedgehog 2023.3.1+ and Android SDK 34.


🏗️ Architecture

app/
 ├── data/          # DataStore helpers, multiplication logic
 ├── ui/            # Activities & XML (Compose migration WIP)
 ├── di/            # Simple service‑locator
 └── util/          # Extensions, constants

MVVM‑lite, single‑module, Jetpack‑only stack.


🤝 Contributing

  1. Fork → create feat/<xyz> branch → commit → push → PR

  2. Follow Conventional Commits (e.g. feat: add dark‑mode toggle)

  3. Format & lint before push:

    ./gradlew ktlintFormat
  4. Describe your change and link any related issue.


🛣️ Roadmap

  • Jetpack Compose UI rewrite
  • Firebase Cloud Sync (progress backup)
  • Customisable quiz lengths
  • Unit & UI tests with Paparazzi / Espresso

🙋‍♂️ Support & Feedback

Feel free to open an issue or vote with 👍 reactions if you’d like a feature prioritised or spot a bug — every suggestion helps!


📬 Contact

Links
Aman LinkedInTwitter / X

Project URL: https://github.com/codedbyaman/aTable


📜 License

This project is licensed under the MIT License — see the full text in LICENSE.


Made with ❤️ and ☕ by @codedbyaman

About

aTable is a lightweight Android app for students, teachers and parents to practise, quiz and listen to tables in English or Hindi.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages