An open API service indexing awesome lists of open source software.

https://github.com/codedbyaman/atable

Math Table generator for everyone
https://github.com/codedbyaman/atable

Last synced: 11 months ago
JSON representation

Math Table generator for everyone

Awesome Lists containing this project

README

          


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.

https://github.com/user-attachments/assets/0248a482-66dd-4abc-bbcc-40f8445376df

---
## 📑 Contents
- [Overview](#overview)
- [Features](#features)
- [Quick Start](#quick-start)
- [Architecture](#architecture)
- [Contributing](#contributing)
- [Roadmap](#roadmap)
- [Support & Feedback](#support--feedback)
- [Contact](#contact)
- [License](#license)

Built with **Kotlin 1.9**, **AGP 8**, **Material 3** and follows Google’s [modern Android guidelines](https://developer.android.com/guide).

---

## ✨ 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

```bash
# 1. Clone your fork
git clone https://github.com//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

```text
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/` branch → commit → push → PR**
2. Follow **[Conventional Commits](https://www.conventionalcommits.org)** (e.g. `feat: add dark‑mode toggle`)
3. Format & lint **before push**:

```bash
./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** | [LinkedIn](https://www.linkedin.com/in/aman-kumar-2a809753/) • [Twitter / X](https://twitter.com/codedbyaman) |

> **Project URL:**

---

## 📜 License

This project is licensed under the **MIT License** — see the full text in [`LICENSE`](LICENSE).

---

Made with ❤️ and ☕ by @codedbyaman