mobile bluesky app made with flutter
lazurite.stormlightlabs.org/
desertthunder.dev
mobile
bluesky
flutter
1# Agent Guidelines
2
3This document provides a high-level overview for contributors (human and AI agents)
4working on Lazurite.
5
6## Core Documentation Map
7
8- [**Architecture Overview**](./doc/ARCHITECTURE.md):
9 Project structure, layered architecture (Domain, Infrastructure, Application, Presentation),
10 and multi-account isolation.
11- [**Development Workflow**](./doc/DEVELOPMENT_WORKFLOW.md):
12 Build commands, style guide, naming conventions, and commit standards.
13- [**Testing Guide**](./doc/testing/README.md):
14 Test organization, execution via `just`, and troubleshooting.
15- [**Patterns**](./doc/PATTERNS.md):
16 Advanced state management and coding patterns.
17
18## Development Checklist
19
20Before committing and submitting a PR, ensure you have:
21
221. Ran `just check` to format, lint, and test your changes.
232. Verified that all generated code is up to date (`just gen`).
243. Added unit tests for new logic and verified coverage targets (>95%).
254. Followed [Conventional Commits](https://www.conventionalcommits.org/).
26
27## Coding Standards Summary
28
29| Category | Standard |
30| :------------------- | :------------------------------------ |
31| **Language** | Dart with 2-space indentation |
32| **State Management** | Riverpod + Freezed |
33| **Logic Layering** | Strict separation between UI and Data |
34| **Database** | Drift with reactive streams |
35| **Naming** | widgets: `PascalCase` |
36| | members: `lowerCamelCase` |
37| | files: `snake_case` |
38
39For deep dives into specific subsystems, refer to the files in the `doc/` directory.