> ## Documentation Index
> Fetch the complete documentation index at: https://docs.remind.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# Development Guide

> Setup guides, coding standards, and development workflows

# Development Guide

Welcome to the development documentation for Remind Tools. This guide covers everything you need to start developing, from environment setup to deployment.

## Quick Start

<Steps>
  <Step title="Clone Repository">
    ```bash theme={null}
    git clone https://github.com/design4pro/remind_tools.git
    cd remind_tools
    ```
  </Step>

  <Step title="Install Dependencies">
    ```bash theme={null}
    # Install Flutter and Dart
    ./scripts/dev_setup.sh

    # Bootstrap Melos workspace
    melos bootstrap
    ```
  </Step>

  <Step title="Run Development">
    ```bash theme={null}
    # Run Trips app
    melos run trips:dev

    # Run Money app
    melos run money:dev
    ```
  </Step>
</Steps>

## Documentation Structure

<CardGroup cols={2}>
  <Card title="Environment Setup" icon="laptop" href="/development/environment-setup">
    Complete development environment configuration
  </Card>

  <Card title="Git Flow" icon="code-branch" href="/development/git-flow">
    Branching strategy and version control
  </Card>

  <Card title="GitHub Standards" icon="github" href="/development/github-issues-standards">
    Issue and PR guidelines
  </Card>

  <Card title="Melos Workspace" icon="layer-group" href="/development/melos-workspace">
    Monorepo management with Melos
  </Card>

  <Card title="Supabase Setup" icon="database" href="/development/supabase-setup">
    Backend configuration and database setup
  </Card>

  <Card title="Claude Commands" icon="terminal" href="/development/claude-commands-guide">
    AI-assisted development commands
  </Card>
</CardGroup>

## Development Workflow

### Branch Strategy

We follow Git Flow:

* `main` - Production-ready code
* `develop` - Integration branch
* `feature/*` - New features
* `bugfix/*` - Bug fixes
* `release/*` - Release preparation
* `hotfix/*` - Production fixes

### Code Quality

<Tabs>
  <Tab title="Testing">
    ```bash theme={null}
    # Run all tests
    melos test

    # Run with coverage
    melos run coverage
    ```
  </Tab>

  <Tab title="Formatting">
    ```bash theme={null}
    # Check formatting
    melos run format

    # Fix formatting
    melos run format:fix
    ```
  </Tab>

  <Tab title="Analysis">
    ```bash theme={null}
    # Run analyzer
    melos run analyze

    # Apply fixes
    melos run fix
    ```
  </Tab>
</Tabs>

## Key Commands

### Development

* `melos run trips:dev` - Run Trips app in debug mode
* `melos run money:dev` - Run Money app in debug mode
* `melos run generate` - Run code generation

### Build & Deploy

* `melos run build:all` - Build for all platforms
* `melos run build:android` - Build Android APK
* `melos run build:ios` - Build iOS
* `melos run build:web` - Build web version

### Utilities

* `melos clean` - Clean all packages
* `melos run upgrade` - Upgrade dependencies
* `melos run audit` - Security audit

## Best Practices

1. **Code Style**
   * Follow Dart effective style guide
   * Use meaningful variable names
   * Write self-documenting code

2. **Testing**
   * Maintain 80%+ code coverage
   * Write unit, widget, and integration tests
   * Use golden tests for UI consistency

3. **Documentation**
   * Document public APIs
   * Update documentation with features
   * Use clear commit messages

4. **Performance**
   * Profile before optimizing
   * Use const constructors
   * Implement lazy loading


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.