IKOU is an interactive web application designed to help users learn and practice Japanese hiragana and katakana characters through engaging exercises and a user-friendly interface.
- 📝 Learn both hiragana and katakana character sets
- 🔊 Audio pronunciation for each character
- 🎮 Interactive practice modes with real-time feedback
- 📊 Track your learning progress and scores
- 📱 Responsive design for desktop and mobile devices
- Next.js 15.3
- React 19
- TypeScript
- Tailwind CSS
- Prisma ORM with PostgreSQL
- Shadcn UI components
- Node.js 18.x or later
- npm or yarn
- PostgreSQL database
-
Clone the repository:
git clone https://github.com/yourusername/ikou.git cd ikou -
Install dependencies:
npm install
-
Set up environment variables by creating a
.envfile in the root directory:DATABASE_URL="your-database-connection-string" NEXT_PUBLIC_AUDIO_PATH="/audio" -
Set up the database:
npx prisma migrate dev
-
Start the development server:
npm run dev
The application will be available at http://localhost:3000.
ikou/
├── public/ # Static files and audio
│ └── audio/ # Character pronunciation audio files
├── src/
│ ├── app/ # Next.js app router pages
│ ├── components/ # Reusable UI components
│ │ └── jp/ # Japanese learning components
│ ├── lib/ # Utility functions and shared logic
│ └── prisma/ # Database schema and migrations
└── ...
- Navigate to the practice section to start learning
- Select characters to hear their pronunciation
- Complete exercises to test your knowledge
- Track your progress through the scoring system
npm testnpm run buildThe application can be deployed to Vercel or any other Next.js compatible hosting service:
npm run build
npm run startContributions are welcome! Please feel free to make issues a 6258 nd to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
- Thanks to all contributors who have helped with the development
- Japanese language resources and audio materials
npm run dev