Initial commit: Deklinationstrainer German declension trainer

Vite + React app for daily German declension practice with localStorage-backed progress. Includes Coolify deploy instructions. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-17 13:00:57 +02:00
commit a198219bc0
14 changed files with 3249 additions and 0 deletions
@@ -0,0 +1,6 @@
+node_modules
+dist
+.DS_Store
+*.log
+.env
+.env.local
@@ -0,0 +1,38 @@
+# Deklinationstrainer
+
+A daily-practice German declension trainer. Self-hosted so your progress actually saves.
+
+## Deploy to Coolify
+
+### One-time setup
+
+1. Push these files to a git repo (GitHub / Gitea / whatever Coolify is connected to).
+
+2. In Coolify, create a new **Application**:
+   - Source: your git repo
+   - Build pack: **Nixpacks** (auto-detects Vite) or **Static**
+   - Build command: `npm run build`
+   - Publish directory: `dist`
+   - Port: not needed for static output (Coolify serves it directly)
+
+3. Add a domain (e.g. `deklination.yourdomain.com`). Coolify provisions HTTPS via Caddy/Traefik automatically.
+
+4. Deploy. Visit the URL on any device.
+
+### Local dev
+
+```bash
+npm install
+npm run dev    # http://localhost:5173
+npm run build  # outputs to ./dist
+```
+
+## On iPhone
+
+Open the URL in Safari, tap Share → **Add to Home Screen**. It opens fullscreen like a native app, and progress saves in localStorage across reboots, sessions, and app closes.
+
+## Storage
+
+The app tries `window.storage` first (Claude artifact environment), then falls back to `localStorage`. When self-hosted, only localStorage runs, which iOS Safari persists reliably.
+
+To wipe progress: open browser devtools → Application → Local Storage → delete the `gd-v10` key. Or on iPhone: Settings → Safari → Advanced → Website Data → search your domain → delete.
@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width,initial-scale=1.0,viewport-fit=cover" />
+    <meta name="theme-color" content="#f7f7f7" />
+    <meta name="apple-mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-status-bar-style" content="default" />
+    <meta name="apple-mobile-web-app-title" content="Beug" />
+    <title>Beug</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>
@@ -0,0 +1,19 @@
+{
+  "name": "deklinationstrainer",
+  "private": true,
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview --host"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.3.4",
+    "vite": "^5.4.11"
+  }
+}
@@ -0,0 +1,9 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import App from './App.jsx'
+
+createRoot(document.getElementById('root')).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+)
@@ -0,0 +1,6 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [react()],
+})