# Mindlist — Free Open-Source Neurolist Alternative (BYOK)

PWA built with Vite + React + TS + Tailwind + Dexie. Local-first, no backend, no tracking.

## Features
- Magic Subtasks Easy/Medium/Hard with Life Context shaping
- Brain Dump AI Import, AI Edit chat patching
- Single-task Focus playlist timer + voice announcements + dynamic end-time + Wake Lock
- Task Library reuse, calendar export (.ics with VALARM), dark mode, offline heuristic fallback
- BYOK OpenRouter, default `deepseek/deepseek-v4.1-flash` (`response_format: json_object`)

## BYOK setup
1. Get a key at https://openrouter.ai/keys
2. Open ⚙️ Settings in the app, paste key, confirm model `deepseek/deepseek-v4.1-flash`
3. Key is stored in `localStorage` only (`mindlist.or.key`), sent directly to `https://openrouter.ai/api/v1/chat/completions`. Never committed.

> The example key in `../Openrouter.md` is revoked/placeholder — do not reuse.

## Dev
```bash
cd app
npm install
npm run dev      # http://localhost:5173
npx vitest run
npm run build    # PWA in dist/
```

## Deploy
Static hosting: `npm run build` → deploy `dist/` to GitHub Pages / Netlify / Vercel. PWA installable on Android via browser → Add to Home screen. Optional Capacitor/TWA wrapper for Play Store later.

## License
MIT — free for personal + commercial use.