OG
Om Ghante
•FOCUSCurrently working on ScheduleSomething and LayerdEvents algorithmsLearn More
•FOCUSCurrently working on ScheduleSomething and LayerdEvents algorithmsLearn More
•FOCUSCurrently working on ScheduleSomething and LayerdEvents algorithmsLearn More
•FOCUSCurrently working on ScheduleSomething and LayerdEvents algorithmsLearn More
Development • Developer Guide
Development Workflow
DocsdevelopmentDeveloper GuideDevelopment Workflow
GitHub Live Sync

Development Workflow

Live technical documentation fetched from GitHub repository omghante/metapilot/docs/developer/workflow.md

Development Workflow & Helper Scripts

Guidelines for daily development workflows, helper CLI scripts, and git conventions.

Helper CLI Scripts

MetaPilot provides dedicated CLI scripts under 
scripts/
to streamline developer onboarding:

1. 
scripts/generate_fernet_key.py

Generates a valid 32 url-safe base64-encoded Fernet key:
bash
# Print key to stdout
python scripts/generate_fernet_key.py

# Write or update FERNET_KEY in services/api/.env
python scripts/generate_fernet_key.py --write-env

2. 
scripts/create_superadmin.py

Creates a Super Admin user account in the database:
bash
# Interactive mode
python scripts/create_superadmin.py

# Command-line mode
python scripts/create_superadmin.py --email admin@example.com --password SecretPassword123
Alternatively run via Django management command:
bash
python manage.py create_superadmin --email admin@example.com --password SecretPassword123

3. 
scripts/backend.sh

Launches the local Daphne ASGI backend server:
bash
./scripts/backend.sh

Git Branching & Pull Requests

  1. Branch Naming: 
    • feat/<topic>
      (e.g. 
      feat/inbox-reactions
      )
    • fix/<topic>
      (e.g. 
      fix/fernet-dev-fallback
      )
    • docs/<topic>
      (e.g. 
      docs/architecture-lifecycle
      )
  2. Commit Convention:
    • Follow Conventional Commits: 
      <type>(<scope>): <summary>
  3. Pull Request Checklist:
    • All tests pass (
      python manage.py test
      & 
      yarn lint
      ).
    • Documentation updated for modified/new endpoints or settings.