33 lines
1.3 KiB
Markdown
33 lines
1.3 KiB
Markdown
# 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.
|