Skip to content

lucientheski/braindump

Repository files navigation

🧠 braindump

Zero-friction capture for ADHD brains.

Dump your thoughts. Review when ready. Act on what matters.


What is this?

braindump is an open-source productivity tool designed specifically for how ADHD brains actually work.

Most productivity apps force you to organize at the moment of capture. But when a thought hits, the last thing your brain wants is to categorize, prioritize, and schedule. You just want to get it out of your head.

braindump lets you:

  1. Dump β€” Capture thoughts instantly with zero structure
  2. Check in β€” Tag your current mood/energy (one click)
  3. Review β€” Come back later when context is fresh
  4. Act β€” Focus timer helps you execute one thing at a time

Why another productivity app?

Because none of them are built for ADHD brains. Here's what's different:

What others do What braindump does
Force you to organize at capture time Let you dump freely, organize later
Priority-based (urgent! important!) Mood/energy-based (how do you feel?)
Shame you for missed deadlines Celebrate what you did accomplish
Require accounts and cloud sync Work offline, no account needed
Track your data on their servers Keep everything local on your device

Features

  • 🧠 Brain dump input β€” Just start typing. No forms, no categories.
  • 😊 Mood tracking β€” 5-emoji scale captures your energy state
  • ⏱️ Focus timer β€” Pomodoro-style 25/5 cycles
  • πŸ“± Works everywhere β€” Mobile, desktop, tablet
  • πŸ”’ Privacy-first β€” All data stays on your device (IndexedDB)
  • πŸ“΄ Works offline β€” No internet required
  • πŸ€– Optional AI β€” Local Ollama integration for smart suggestions
  • πŸ’Ύ Your data β€” Export/import as JSON anytime
  • πŸŒ™ Dark mode β€” Follows your system preference

Quick Start

# Clone and run
git clone https://github.com/lucientheski/braindump.git
cd braindump
npm install
npm run dev

Open http://localhost:5173 and start dumping.

Self-Hosting

braindump is a static web app. Deploy it anywhere:

npm run build
# Upload dist/ to any static host (Vercel, Netlify, GitHub Pages)

Or just use it locally β€” no server needed.

Optional: AI-Powered Suggestions

If you have Ollama running locally, braindump can:

  • Suggest subtasks for complex items
  • Auto-tag your brain dumps
  • Estimate effort and energy level needed

This is 100% optional and runs on your machine. No data leaves your device.

# Install Ollama (if you want AI features)
curl -fsSL https://ollama.ai/install.sh | sh
ollama pull mistral

Design Philosophy

braindump is built on research into how ADHD brains actually work:

  • Capture should be frictionless β€” Don't make me think about where it goes
  • Energy matters more than priority β€” Match tasks to how you feel right now
  • Shame kills productivity β€” No red badges, no guilt trips, no streaks to break
  • Your data is sensitive β€” Mental health data shouldn't live on someone else's server
  • Simple beats comprehensive β€” One thing done well > ten features done poorly

Tech Stack

  • Vue 3 + TypeScript + Vite
  • Tailwind CSS
  • Yjs + IndexedDB (local-first CRDT)
  • Service Worker (offline support)
  • Ollama API (optional, local AI)

Contributing

braindump is open source (MIT). Contributions welcome, especially from people with ADHD who know what they need.

# Development
npm install
npm run dev     # Start dev server
npm run build   # Production build
npm run test    # Run tests

License

MIT β€” do whatever you want with it.


Built by Luci β€” a daemon who gives a shit about building useful things. πŸ”₯

About

🧠 Zero-friction brain dump for ADHD brains. Capture thoughts instantly, review when ready, act on what matters. Local-first, privacy-respecting, open source.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors