German Quiz Builder is a modern vocabulary learning and quiz application designed for German learners.
The project helps users practice German vocabulary through interactive quizzes, level-based word lists, favorites, mistake tracking, and personal notes.
- German vocabulary practice from A1 to B2
- Interactive multiple-choice quiz system
- Turkish meanings for German words
- Favorite words list
- Mistake tracking for repeated practice
- Personal notes for custom example sentences
- Question series options
- Mobile-friendly responsive design
- Clean and modern user interface
- Built with React and TypeScript
- React
- TypeScript
- Vite
- Tailwind CSS
- shadcn/ui
- React Router
- LocalStorage
- pnpm
German-Quiz-Builder/
├── artifacts/
│ └── german-quiz/
│ ├── src/
│ │ ├── components/
│ │ ├── data/
│ │ ├── hooks/
│ │ ├── pages/
│ │ └── App.tsx
│ ├── package.json
│ └── vite.config.ts
├── README.md
└── package.json
Main Functions
Vocabulary Practice
Users can study German words according to their language level.
Quiz Mode
Users can answer multiple-choice questions and practice vocabulary actively.
Favorites
Important or difficult words can be saved for later review.
Mistake Tracking
Incorrect answers are saved so users can repeat weak vocabulary areas.
Personal Notes
Users can write their own example sentences or notes to remember words more easily.
Installation
Clone the repository:
git clone https://github.com/marslan93/German-Quiz-Builder.git
Go to the project folder:
cd German-Quiz-Builder
Install dependencies:
pnpm install
Start the development server:
pnpm dev
Alternative Start Command
cd artifacts/german-quiz
pnpm install
pnpm dev
Build
pnpm build
Preview Production Build
pnpm preview
Purpose of the Project
The purpose of this project is to create a practical German learning tool for daily vocabulary training.
The application helps learners:
* repeat German words regularly
* identify weak vocabulary areas
* save important words
* create personal example sentences
* improve vocabulary through active recall
Future Improvements
* user login system
* cloud database integration
* spaced repetition algorithm
* progress statistics
* pronunciation support
* example sentences for each word
* admin panel for vocabulary management
* export/import function
* AI-supported sentence generation
* mobile app version
Author
Mücahit Arslan
Electrical Engineer with experience in technical systems, e-commerce, SEO, and software-supported learning projects.
GitHub: https://github.com/marslan93
License
This project is currently developed for educational and portfolio purposes.