mobile bluesky app made with flutter
lazurite.stormlightlabs.org/
mobile
bluesky
flutter
Agent Guidelines#
This document provides a high-level overview for contributors (human and AI agents) working on Lazurite.
Core Documentation Map#
- Architecture Overview: Project structure, layered architecture (Domain, Infrastructure, Application, Presentation), and multi-account isolation.
- Development Workflow: Build commands, style guide, naming conventions, and commit standards.
- Testing Guide:
Test organization, execution via
just, and troubleshooting. - Patterns: Advanced state management and coding patterns.
Development Checklist#
Before committing and submitting a PR, ensure you have:
- Ran
just checkto format, lint, and test your changes. - Verified that all generated code is up to date (
just gen). - Added unit tests for new logic and verified coverage targets (>95%).
- Followed Conventional Commits.
Coding Standards Summary#
| Category | Standard |
|---|---|
| Language | Dart with 2-space indentation |
| State Management | Riverpod + Freezed |
| Logic Layering | Strict separation between UI and Data |
| Database | Drift with reactive streams |
| Naming | widgets: PascalCase |
members: lowerCamelCase |
|
files: snake_case |
For deep dives into specific subsystems, refer to the files in the doc/ directory.