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

https://github.com/best-team-compfest17/calisfun

πŸ”₯ CalisFun GitHub Monorepo - SEA Academy Compfest 17 - Team 1
https://github.com/best-team-compfest17/calisfun

azure dart expressjs flask flutter jwt mongodb multer nodejs openai python react shadcn-ui tailwindcss typescript vercel vite

Last synced: 3 months ago
JSON representation

πŸ”₯ CalisFun GitHub Monorepo - SEA Academy Compfest 17 - Team 1

Awesome Lists containing this project

README

          



CalisFun Logo


CalisFun


Cerdas Sejak Dini, Seru Sepanjang Hari!






CalisFun - SEA Compfest Academy 17


CalisFun Preview



**CalisFun** is an innovative **learning application** designed to help children practice and improve their **handwriting, spelling, and counting skills** in a fun and engaging way.
The app combines **interactive exercises and AI-powered tools** to make learning enjoyable both for kids and supportive for parents.

Built with a multi-platform ecosystem:
- **Mobile App (Flutter)** β†’ Main platform for children’s learning experience.
- **Web Frontend** β†’ Landing page for SEO visibility, APK download, and **Admin Dashboard**.
- **Backend (Express.js + MongoDB)** β†’ API services for authentication, content management, and progress tracking.
- **AI Services (Flask + Hugging Face + Azure OpenAI)** β†’ OCR for handwriting detection and AI Chatbot assistant.

CalisFun bridges **education and technology**, making foundational learning both **accessible and entertaining**.

CalisFun GitHub Organization - Team 1

---

## πŸ“ƒ Table of Contents
- [πŸ“ CalisFun Repository Documentation](#-calisfun-repository-documentation)
- [πŸ“ˆ Pitch Deck](#-pitch-deck)
- [βš™οΈ Technology Stack](#-technology-stack)
- [🧩 Core Features](#-core-features)
- [πŸš€ Live App Demo](#-live-app-demo)
- [🧰 Getting Started Locally](#-getting-started-locally)
- [πŸš€ Diagram](#-diagram)
- [πŸ‘₯ Owner](#-owner)
- [πŸ“¬ Contact](#-contact)

---

## πŸ“ CalisFun Repository Documentation

> [!TIP]
>
> For more detail and specific documentation, please read the documentation from each of our repository

---

## πŸ“š More Documenation

---

## βš™οΈ Technology Stack

### Frontend Mobile - Technology Stack




image
image


Flutter | Dart | Dio | Riverpod


### Backend - Technology Stack








Node JS | Express JS | MongoDB | JWT | Multer | Vercel | Microsoft Azure



### Frontend Web - Technology Stack







React | TypeScript | Vite | TailwindCSS | ShadcnUI | Vitest


### AI - Technology Stack







Python | Flask | Hugging Face | Microsoft Azure | OpenAI | Docker


---

## 🧩 Core Features

### ✍️ Handwriting Practice (AI + OCR)
- Interactive canvas for kids to practice handwriting.
- Flutter MLKit evaluates written letters/words in real-time.
- Provides instant realtime feedback.

### πŸ”‘ Spelling Game
- Audio-assisted spelling learn.
- Progressive level to help children learn more about how to spell correctly.

### πŸ”’ Counting Challenges
- Interactive counting mini-games.
- Timed challenges to improve **speed and accuracy** in basic math.

### πŸ† Leaderboard & Rewards
- Gamified leaderboard to encourage friendly competition.
- Level up your account and earn streaks for completing daily counting exercise

### πŸ‘¨β€πŸ‘©β€πŸ‘§ Parent Dashboard
- Parents can **track child’s progress** (handwriting accuracy, spelling scores, counting levels).
- Manage child accounts and set study goals.

### 🌐 Web Platform
- Landing page with SEO optimization β†’ shareable and accessible for new users.
- Direct APK download for Android users.
- **Admin Dashboard** for managing questions, content, and user accounts.

### 🧠 AI-Powered Tools
- **AI Chatbot (Azure OpenAI)** β†’ Friendly assistant for Q&A, learning support, or help navigating the app.

---

## πŸš€ Live App Demo

### Frontend - Mobile Download
(please go to the Mobile Repository to download the app)

πŸ‘‰ [Google Drive - CalisFun Mobile Application](https://drive.google.com/drive/folders/1LYj5Aue0JOMmDMeRlu_nA0L04DEDNKlH?usp=sharing)

### Frontend - Website

πŸ‘‰ [https://calis-fun.vercel.app/](https://calis-fun.vercel.app/)

### Backend - Deployed API

πŸ‘‰ [https://calis-fun-backend.vercel.app/](https://calis-fun-backend.vercel.app/)

---

## 🧰 Getting Started Locally

### Prerequisites

General
- **Git**

Frontend - Mobile
- **Dart**
- **Flutter SDK**
- **Android Studio** (optional)

Frontend - Website
- **Node.js** (v16+)

Backend
- **Node.js** (v16+)
- **MongoDB**
- **MongoDB Compass** (optional)
- **Postman** (optional)

AI
- **Python**
- **Docker** (optional)

### Clone the Project - For each service (option 1, recommended)
```bash
Read specific README Documentation in each GitHub Repo
```

### Clone the Project - Using CalisFun Monorepo (option 2, using this repo)
```bash
git clone https://github.com/best-team-compfest17/CalisFun.git
cd CalisFun

# If prefer using shell script

./scripts/setup.sh # Pull from the origin repository (get update changes)

./scripts/dev.sh frontend-web # to run the website
./scripts/dev.sh frontend-mobile # to run the mobile (for now please just use the documentation in CalisFun-Mobile Repository)
./scripts/dev.sh backend # to run the backend
./scripts/dev.sh ai # to run the ai
./scripts/dev.sh dev # run all services

# If prefer using Makefile (configuration needed)

make init # init submodules
make update # update all submodules
make dev # run all services
make frontend-web # to run the website
make frontend-mobile # to run the mobile (for now please just use the documentation in CalisFun-Mobile Repository)
make backend # to run the backend
make ai # to run the ai

```

---

## 🧭 Diagram

*Architecture Diagram of CalisFun*



This is how our application built on and connect cross services.

*Use Case Diagram of CalisFun*



This is all use case that can be done in CalisFun started for user, parent, and admin role.

*Overall Database System Flow (ERD Diagram):*



This diagram shows how the models connected using ERD Diagram

---

## πŸ‘₯ Owner

This Repository is created by Team 1


  • Stanley Nathanael Wijaya - Fullstack Developer

  • Haikal Iman F - Mobile Developer

  • Muhammad Favian Jiwani - Mobile Developer

  • Raditya Ramadhan - Backend Developer

  • Muhammad Ridho Ananda - Mentor


As Final Project for SEA Academy Compfest 17

---

## πŸ“¬ Contact
Have questions or want to collaborate?

- πŸ“§ Email: stanley.n.wijaya7@gmail.com
- πŸ’¬ Discord: `stynw7`

Made with ❀️ by The Calon Best Team