# 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.

## Stripe checkout

Beug uses public Stripe Checkout or Payment Link URLs, supplied through environment variables. Do not put Stripe secret keys in this Vite app.

Create one product in Stripe, for example `Beug Premium`, with three prices:

- Weekly subscription: `$2.99` every week
- Yearly subscription: `$9.99` every year
- Lifetime access: `$19.99` one-time payment

Create a Payment Link or Checkout link for each price. Set the success redirect URL to:

```text
https://beug.george1.dev/?checkout=success
```

Set the cancel URL to:

```text
https://beug.george1.dev/
```

Then add these public URLs in the deployment environment:

```bash
VITE_STRIPE_YEARLY_URL=https://buy.stripe.com/...
VITE_STRIPE_LIFETIME_URL=https://buy.stripe.com/...
VITE_STRIPE_WEEKLY_URL=https://buy.stripe.com/...
```

The current v1 unlock is intentionally simple: after Stripe redirects back with `?checkout=success`, Beug stores the unlock in this browser's localStorage. This avoids accounts for the tiny-app version, but it is a soft paywall. A stricter version needs a small backend, Stripe webhooks, and account or email-based entitlement lookup.