ADHD-friendly productivity ecosystem that works offline-first

Three focused apps for ADHD project management:

1. 🎯 Guidance - Task & project management (Building now)
2. 📚 Knowledge - Personal wiki & notes (Coming Month 4)
3. 📦 Tracking - Inventory & resources (Coming Month 7)

Why ADHD-friendly?

• ⚡ Quick capture - Thought to save in under 3 seconds
• 🏠 Works offline - No internet required, sync is optional
• 🎨 Visual clarity - High contrast, clear feedback
• 🤖 AI-powered - Break down tasks automatically
• 🔐 Private first - Your data stays on your device

Try Altair Guidance (Task Management):

# Clone and run
git clone https://github.com/getaltair/altair.git
cd altair/apps/altair-guidance
flutter pub get
flutter run -d linux  # or macos, windows

You should see: The Altair Guidance app launch with a quick capture screen

• All apps run 100% offline by default
• Enable sync later when you need multi-device access
• Your data stays on your device

• Quick capture - No friction between thought and action
• Visual time tracking - Combat time blindness
• AI task breakdown - Prevent overwhelm
• Neo-brutalist UI - Clear visual hierarchy

• Download and run - No setup required
• Optional sync - Add when you need it
• Fast - Instant saves, sub-second page loads
• Private - You control your data

Task and project management for ADHD

Core features:

• Quick capture (< 3 seconds)
• AI-powered task breakdown
• Visual time tracking
• Offline-first with optional sync

Status: ✅ Month 1 complete (Infrastructure) Next: Month 2 - Core task management

View Guidance README →

Personal wiki and knowledge management

Planned features:

• Markdown-based notes
• Automatic backlinks & graph view
• Daily notes
• Cross-app linking with Guidance

Status: 📋 Planned for Month 4

Inventory and resource management

Planned features:

• Barcode scanning
• Location-based organization
• Smart alerts (low stock, expiration)
• Integrates with tasks and wiki

Status: 📋 Planned for Month 7

Standalone Mode (Default)        Sync Mode (Optional)
┌─────────────────┐             ┌─────────────────┐
│  Flutter App    │             │  Flutter App    │
│       +         │             │       +         │
│    SQLite       │             │ SQLite + Sync   │
└─────────────────┘             └────────┬────────┘
                                         │
                                    ┌────▼────────┐
                                    │  FastAPI    │
                                    │     +       │
                                    │ PostgreSQL  │
                                    └─────────────┘

Key decisions:

• ✅ Local-first - Apps work standalone
• ✅ Progressive - Add features when needed
• ✅ Proven tech - SQLite, PostgreSQL, PowerSync

Architecture Details →

Frontend:

• Flutter (cross-platform)
• SQLite (local database)
• Bloc (state management)

Backend (Optional):

• FastAPI (Python)
• PostgreSQL (server database)
• PowerSync (sync engine)

AI Integration:

• OpenAI (GPT-4)
• Anthropic (Claude)
• Ollama (local models)

• Getting Started - Run Altair Guidance
• Development Roadmap - What's coming next

• Architecture Overview - How it all works
• Data Flow - Understanding data movement
• Component Design - Code structure
• Contributing Guide - How to contribute

Phase 1: Altair Guidance (Months 1-3)

• ✅ Month 1: Foundation complete

  • CI/CD pipeline
  • Project structure
  • Authentication foundation
  • Neo-brutalist UI theme

• ⏳ Month 2: Core features (In Progress)

  • Task management
  • Quick capture
  • Local storage

• 📋 Month 3: AI & polish (Planned)

  • AI task breakdown
  • Beta testing
  • Performance optimization

View Detailed Roadmap →

We welcome contributions from:

• Developers - Flutter, Python, or both
• Designers - UI/UX, especially ADHD-friendly design
• ADHD community - Feedback and testing
• Documentation writers - Help make docs accessible

1. Find an issue - Look for good-first-issue label
2. Fork and clone - Get the code locally
3. Make changes - Follow our coding standards
4. Test thoroughly - Run pre-commit hooks
5. Submit PR - Include clear description

Full Contributing Guide →

• ✅ Conventional commits
• ✅ Comprehensive tests
• ✅ Pre-commit hooks
• ✅ Keep-a-changelog format

Get Support:

• 🐛 Report Issues
• 💬 Discord Community
• 📧 Email Support

Stay Updated:

• 📖 Changelog
• 🐦 x (coming soon)
• 📝 Blog (coming soon)

• altair - Monorepo for all apps

• apps/altair-guidance - Task management
• apps/altair-knowledge - Personal wiki (Phase 2)
• apps/altair-tracking - Inventory (Phase 3)

• packages/altair-ui - UI components & theme
• packages/altair-core - Business logic
• packages/altair-auth - Authentication
• packages/altair-sync - Sync engine integration

All Altair projects are licensed under AGPL-3.0-or-later

This means:

• ✅ Free to use, modify, distribute
• ✅ Must share modifications
• ✅ Network use = distribution (must share code)

View License →

Built for the ADHD community, by the ADHD community

We believe:

• 🏠 Local-first - Your data belongs on your device
• ⚡ Speed matters - Friction kills momentum
• 🎯 Focus is key - One thing at a time, done well
• 🔐 Privacy by default - Sync is opt-in
• 🤝 Open source - Community-driven development

Inspired by:

• Local-first software principles
• The ADHD community's real needs
• Proven open-source tools
• Minne

Powered by:

• Flutter - Cross-platform framework
• FastAPI - Modern Python web framework
• PowerSync - Offline-first sync engine

Made with ☕ for people with ADHD

Status: 🚧 Phase 1 Development (Month 1 Complete)