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

https://github.com/rizkraf/aksarify

Aksarify is an interactive platform designed to help users measure and improve their Indonesian reading comprehension skills.
https://github.com/rizkraf/aksarify

nextjs postgresql prisma react supabase tailwindcss trpc

Last synced: about 1 year ago
JSON representation

Aksarify is an interactive platform designed to help users measure and improve their Indonesian reading comprehension skills.

Awesome Lists containing this project

README

          

# Aksarify - Platform Uji Pemahaman Bacaan


Aksarify Logo


Uji dan tingkatkan pemahaman bacaan Bahasa Indonesia dalam hitungan menit!

## ๐Ÿ“– Tentang Aksarify

Aksarify adalah platform interaktif yang dirancang untuk membantu pengguna mengukur dan meningkatkan kemampuan pemahaman bacaan Bahasa Indonesia. Dengan metode tes yang efektif dan menyenangkan, Aksarify menawarkan pengalaman belajar yang menarik untuk semua tingkat pembaca.

## ๐Ÿš€ Fitur Utama

- **Tes Kilat** - Satu teks (~200 kata) dan 5 soal pilihan ganda, selesai dalam hitungan menit
- **Beragam Tingkat Kesulitan** - Tersedia tes dengan berbagai level kesulitan
- **Analisis Instan** - Dapatkan hasil dan pembahasan segera setelah menyelesaikan tes
- **Metrik Performa** - Lacak kecepatan membaca, kata per menit, dan tingkat pemahaman
- **Antarmuka Modern** - Pengalaman pengguna yang intuitif dan responsif

## ๐Ÿงช Demo

Kunjungi [https://aksarify.xyz](https://aksarify.xyz) untuk mencoba Aksarify.

## ๐Ÿ› ๏ธ Teknologi

Aksarify dibangun dengan stack teknologi modern:

- **Framework**: [Next.js 15](https://nextjs.org/) dengan App Router
- **Database**: [Supabase PostgreSQL](https://www.supabase.com/) dengan [Prisma ORM](https://prisma.io/)
- **Styling**: [Tailwind CSS](https://tailwindcss.com/) dengan [Shadcn UI](https://ui.shadcn.com/)
- **Backend**: [tRPC](https://trpc.io/) untuk API type-safe
- **Deployment**: Dioptimalkan untuk [Vercel](https://vercel.com/)

## ๐Ÿ’ป Instalasi dan Pengembangan Lokal

### Prasyarat

- Node.js (versi 18 atau lebih tinggi)
- PostgreSQL
- pnpm, npm, yarn, atau bun

### Langkah Instalasi

1. Clone repositori
```bash
git clone https://github.com/rizkraf/aksarify.git
cd aksarify
```

2. Install dependencies
```bash
pnpm install
# atau
npm install
```

3. Salin file environment dan sesuaikan
```bash
cp .env.example .env
# Edit file .env dengan editor pilihan Anda
```

4. Siapkan database
```bash
pnpm prisma migrate dev
# atau
npx prisma migrate dev
```

5. Jalankan seed untuk sampel data (opsional)
```bash
pnpm prisma db seed
# atau
npx prisma db seed
```

6. Jalankan aplikasi dalam mode development
```bash
pnpm dev
# atau
npm run dev
```

7. Buka [http://localhost:3000](http://localhost:3000) di browser Anda

## ๐Ÿ“š Struktur Aplikasi

```
src/
โ”œโ”€โ”€ app/ # Next.js App Router
โ”‚ โ”œโ”€โ”€ api/ # API routes
โ”‚ โ”œโ”€โ”€ result/ # Halaman hasil tes
โ”‚ โ”œโ”€โ”€ test/ # Halaman ujian
โ”œโ”€โ”€ components/ # React components
โ”‚ โ”œโ”€โ”€ result/ # Komponen hasil
โ”‚ โ”œโ”€โ”€ test/ # Komponen ujian
โ”‚ โ””โ”€โ”€ ui/ # Komponen UI umum
โ”œโ”€โ”€ hooks/ # Custom React hooks
โ”œโ”€โ”€ lib/ # Utilitas & helper
โ”œโ”€โ”€ server/ # Backend logic & tRPC
โ”‚ โ””โ”€โ”€ api/ # tRPC API routes
โ””โ”€โ”€ styles/ # Global styles
```