{"id":50633403,"url":"https://github.com/linnhtetwin/deutsch-meister","last_synced_at":"2026-06-07T00:03:48.082Z","repository":{"id":353968868,"uuid":"1137183070","full_name":"linnhtetwin/deutsch-meister","owner":"linnhtetwin","description":"Interactive platform to master German cases, articles, and verb usage with quizzes, dictionary, and grammar guides","archived":false,"fork":false,"pushed_at":"2026-05-16T13:04:44.000Z","size":458,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-16T15:13:15.760Z","etag":null,"topics":["akkusativ","dativ","edtech","education","genitiv","german-cases","german-grammar","german-learning","grammar","language-learning"],"latest_commit_sha":null,"homepage":"https://deutsch-meister.pages.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/linnhtetwin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-19T03:06:30.000Z","updated_at":"2026-05-16T13:04:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/linnhtetwin/deutsch-meister","commit_stats":null,"previous_names":["linnhtetwin/deutsch-meister"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/linnhtetwin/deutsch-meister","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linnhtetwin%2Fdeutsch-meister","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linnhtetwin%2Fdeutsch-meister/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linnhtetwin%2Fdeutsch-meister/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linnhtetwin%2Fdeutsch-meister/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linnhtetwin","download_url":"https://codeload.github.com/linnhtetwin/deutsch-meister/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linnhtetwin%2Fdeutsch-meister/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34003817,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["akkusativ","dativ","edtech","education","genitiv","german-cases","german-grammar","german-learning","grammar","language-learning"],"created_at":"2026-06-07T00:03:47.400Z","updated_at":"2026-06-07T00:03:48.077Z","avatar_url":"https://github.com/linnhtetwin.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🇩🇪 Deutsch Meister\n\n**Master the German Case System \u0026 Articles**\n\nA comprehensive learning platform for German grammar, specializing in verbs, nouns, and the German case system (Dativ, Akkusativ, Genitiv).\n\n[View Online](https://deutsch-meister.pages.dev/) • [Features](#features) • [Getting Started](#getting-started) • [Technologies](#technologies) • [License](#license)\n\n[![License: Apache v2](https://img.shields.io/badge/License-apache%20v2-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)\n\n\u003c/div\u003e\n\n---\n\n## Features\n\n✨ **Interactive Learning Modules**\n- 📚 **Wörterbuch (Dictionary)** – Browse and search the growing verb/noun database with lazy‑loading infinite scroll, relevance‑aware sorting and advanced filters (Dativ, Akkusativ, Genitiv, Wechselpräposition → Akk/Dativ, Präpositionalverb → Akk/Dativ, Intransitiv, Modalverb, plus nouns/adjectives/adverbs). Search looks through example sentences and full verb conjugations for smarter results.\n- ❓ **Verb Quiz** – Master German verbs with multiple quiz modes: Classic, Wechselpräpositionen, Genitiv‑Meister (rare Genitiv verbs), and Chaos Mix. Real‑time feedback plus a **streak counter** keeps you motivated.\n- 🎓 **Nomen Quiz** – Practice German article selection (Der, Die, Das) with instant feedback, streak tracking and a built‑in educational section full of gender heuristics and tips.\n- 📖 **Anleitung (Guide)** – Comprehensive grammar reference featuring declension tables, sentence‑structure rules (V2, TeKaMoLo, subclauses), adverb explanations and handy gender‑ending cheat sheets.\n\n🎨 **User Experience**\n- Clean, intuitive interface with German cultural styling\n- Real-time feedback on quiz answers\n- Streak counter to track your progress\n- Responsive design for mobile and desktop\n\n⚙️ **Built with Modern Tech**\n- React 19 + TypeScript\n- Vite for blazing-fast development\n- Tailwind CSS for styling\n- Lucide React icons\n- Google Gemini API integration\n\n---\n\n## Getting Started\n\n### Prerequisites\n\n- **Node.js** (v16 or higher)\n- **npm** or **yarn**\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/yourusername/deutsch-meister.git\n   cd deutsch-meister\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Configure environment variables**\n   \n   Create a `.env.local` file in the root directory (these files are ignored by Git for security):\n   ```env\n   VITE_GEMINI_API_KEY=your_gemini_api_key_here\n   ```\n   You can also use other `.env` variants like `.env.development.local` or `.env.production.local` – the gitignore prevents them from being accidentally committed.\n\n\u003e ⚠️ **Security tip:** never commit API keys or other secrets. The app reads from `import.meta.env` at build time, so local files or environment variables on the hosting platform are sufficient.\n\n4. **Start development server**\n   ```bash\n   npm run dev\n   ```\n\n   The app will be available at `http://localhost:3000`\n\n### Build for Production\n\n```bash\nnpm run build\n```\n\nPreview the production build:\n```bash\nnpm run preview\n```\n\n### Deploy to Cloudflare Pages\n\n```bash\nnpm run deploy\n```\n\n---\n\n## Project Structure\n\n```\ndeutsch-meister/\n├── components/              # React components\n│   ├── DictionaryView.tsx   # Dictionary/search interface\n│   ├── VerbQuiz.tsx         # Verb quiz with multiple modes\n│   ├── NounQuiz.tsx         # Noun/article quiz\n│   ├── GuideView.tsx        # Grammar guide\n│   └── WordCard.tsx         # Reusable word card component\n├── App.tsx                  # Main app component\n├── data.ts                  # Verb and noun database\n├── types.ts                 # TypeScript type definitions\n├── index.tsx                # React entry point\n├── vite.config.ts           # Vite configuration\n└── public/                  # Static assets\n```\n\n---\n\n## Technologies\n\n- **Frontend Framework**: [React 19](https://react.dev)\n- **Language**: [TypeScript](https://www.typescriptlang.org)\n- **Build Tool**: [Vite 6](https://vitejs.dev)\n- **Styling**: [Tailwind CSS](https://tailwindcss.com)\n- **Icons**: [Lucide React](https://lucide.dev)\n- **AI**: [Google Gemini API](https://ai.google.dev)\n- **Hosting**: [Cloudflare Pages](https://pages.cloudflare.com)\n\n---\n\n## Available Scripts\n\n| Command | Description |\n|---------|-------------|\n| `npm run dev` | Start development server |\n| `npm run build` | Build for production |\n| `npm run preview` | Preview production build |\n| `npm run deploy` | Build and deploy to Cloudflare Pages |\n\n---\n\n## Learning Resources\n\nThis app focuses on mastering:\n\n- **German Cases** (Fälle):\n  - Nominativ (Nominative)\n  - Dativ (Dative)\n  - Akkusativ (Accusative)\n  - Genitiv (Genitive)\n\n- **German Articles**:\n  - Definite articles: Der, Die, Das\n  - Case agreement and article changes\n\n- **Verb Categories**:\n  - Standard dative/accusative verbs\n  - Wechselpräposition verbs (two-way prepositions)\n  - Genitive verbs\n  - Prepositional verbs\n  - Intransitive verbs\n\n- **Additional Grammar Topics**:\n  - Declension tables for adjectives, pronouns and articles\n  - Sentence structure rules (V2, TeKaMoLo, subclauses)\n  - Adverbs and their order\n  - Gender-ending heuristics and cheat‑sheets\n\n---\n\n## Contributing\n\nContributions are welcome! Feel free to:\n- Report bugs and issues\n- Suggest new features (e.g. more case filters, verb/noun entries, etc.)\n- Improve the grammar database\n- Submit pull requests\n\n\u003e 🔐 **Security:** please avoid adding any private credentials or keys to commits. Use environment variables or secure storage when testing APIs.\n\n---\n\n## License\n\nThis project is licensed under the Apache License v2.0 (Apache-2.0). See the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nMade with ❤️ for German learners worldwide\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinnhtetwin%2Fdeutsch-meister","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinnhtetwin%2Fdeutsch-meister","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinnhtetwin%2Fdeutsch-meister/lists"}