Altair

ADHD-friendly productivity ecosystem with local-first architecture

What is Altair?

Altair is a three-app ecosystem designed specifically for people with ADHD who need powerful task management, knowledge organization, and inventory tracking. Built with a local-first philosophy—your data stays on your device by default, with optional sync when you need it.

The Three Apps

1. Altair Guidance 🎯 — Task and project management

   • Quick capture (< 3 seconds thought-to-save)
   • AI-powered task breakdown
   • Visual time tracking for time blindness
   • Offline-first, works without internet

2. Altair Knowledge 📚 — Personal wiki and knowledge management (Phase 2)

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

3. Altair Tracking 📦 — Inventory and resource management (Phase 3)

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

Key Features

• 🏠 Local-first — Works offline, data stays on your device
• 🔄 Optional sync — Multi-device sync when you need it (PowerSync)
• 🎨 Neo-brutalist UI — High contrast, clear visual feedback
• 🤖 AI-powered — Task breakdown, prioritization (OpenAI, Anthropic, Ollama)
• ⚡ Fast — Instant captures, < 1s page loads
• 🔐 Private — Your data, your control

Architecture

altair/
├── apps/                    # Flutter applications
│   ├── altair-guidance/     # Task management (Phase 1)
│   ├── altair-knowledge/    # Wiki (Phase 2)
│   └── altair-tracking/     # Inventory (Phase 3)
├── packages/                # Shared Flutter packages
│   ├── altair-ui/          # UI components & theme
│   ├── altair-core/        # Business logic & models
│   ├── altair-auth/        # Authentication
│   └── altair-sync/        # PowerSync integration
├── services/                # Backend services (optional)
│   ├── auth-service/       # FastAPI authentication
│   ├── sync-service/       # PowerSync backend
│   └── ai-service/         # AI proxy (optional)
├── infrastructure/          # Deployment configs
│   ├── docker/             # Docker Compose
│   ├── nginx/              # Reverse proxy
│   └── scripts/            # Automation scripts
└── docs/                    # Documentation

Quick Start

Prerequisites

• Flutter 3.0+ (for desktop/mobile development)
• Python 3.12+ (for backend services)
• uv (Python package manager)
• mise (optional, for version management)

Running Altair Guidance (Standalone)

# Navigate to the Guidance app
cd apps/altair-guidance

# Get dependencies
flutter pub get

# Run on Linux desktop
flutter run -d linux

# Run on Android (requires connected device/emulator)
flutter run -d android

Development Setup

# Clone the repository
git clone https://github.com/getaltair/altair.git
cd altair

# Install pre-commit hooks
pre-commit install

# Run all tests
./scripts/test-all.sh

# Build all apps
./scripts/build-all.sh

Development Roadmap

Phase 1: Altair Guidance (Months 1-3)

• ✅ Month 1: Infrastructure & auth
• ⏳ Month 2: Core task management
• ⏳ Month 3: AI features & beta

Phase 2: Altair Knowledge (Months 4-6)

• ⏳ Wiki foundation
• ⏳ Smart connections
• ⏳ External brain features

Phase 3: Altair Tracking (Months 7-9)

• ⏳ Basic inventory
• ⏳ Smart tracking
• ⏳ Ecosystem integration

See DEVELOPMENT-ROADMAP.md for details.

Documentation

• Architecture Overview — System design principles
• Data Flow — How data moves through the system
• Component Design — Component structure
• Deployment Guide — Deployment options
• Development Roadmap — Timeline and milestones

Technology Stack

Frontend

• Flutter — Cross-platform UI framework
• SQLite — Local database (via sqflite)
• PowerSync — Client-side sync engine
• Bloc — State management

Backend (Optional)

• FastAPI — Python web framework
• PostgreSQL — Server database
• PowerSync Service — Sync coordinator
• Redis — Caching layer

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Workflow

1. Create a feature branch (git checkout -b feature/amazing-feature)
2. Make changes following our conventions
3. Run linters and tests (pre-commit run --all-files)
4. Commit with conventional commits (git commit -m "feat: add amazing feature")
5. Push and create a pull request

Code Standards

• Conventional Commits — For commit messages
• Keep a Changelog — For CHANGELOG.md updates
• Pre-commit hooks — Automated linting and formatting
• Comprehensive tests — Unit, widget, and integration tests
• Inline documentation — Following language-specific standards

License

This project is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later) - see the LICENSE file for details.

Acknowledgments

• Built for the ADHD community, by the ADHD community
• Inspired by local-first software principles
• Powered by Flutter, FastAPI, and PowerSync

Support

• 📖 Documentation: docs/
• 🐛 Issues: GitHub Issues
• 💬 Discord: Join our community
• 📧 Email: support@getaltair.com

---

Status: 🚧 Phase 1 Development (Month 1: Foundation)

Made with ❤️ for the ADHD community