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:

  1. Ran just check to format, lint, and test your changes.
  2. Verified that all generated code is up to date (just gen).
  3. Added unit tests for new logic and verified coverage targets (>95%).
  4. 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.