mindlist/README-MINDLIST.md

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

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.