Ovrly

Location-based photo overlays and AR experiences.

Repository Structure

ovrly/
├── ovrly/              # Flutter monorepo (iOS, Android, Web)
│   ├── apps/           # Consumer applications
│   │   ├── ovrly_photo/   # Photo capture with overlays
│   │   ├── ovrly_draw/    # Drawing on overlays
│   │   └── ovrly_web/     # Web version
│   └── packages/
│       └── ovrly_core/    # Shared Flutter code
├── admin/              # React dashboard for managing platform
├── services/           # Backend services
│   └── ovrly-pipeline/    # Image → overlay processing
├── infrastructure/     # AWS CDK infrastructure
├── docs/               # Specifications and documentation
└── tools/              # Development utilities

Getting Started

Flutter Apps (iOS/Android/Web)

cd ovrly
fvm use 3.22.0
melos bootstrap
cd apps/ovrly_photo
flutter run --device-id chrome

Admin Dashboard

cd admin
npm install
npm run dev

Ovrly Pipeline

See services/ovrly-pipeline/README.md

Development Guidelines

See CLAUDE.md for comprehensive development guidelines.

Documentation

• Architecture decisions: docs/specs/
• Implementation plans: docs/plans/
• Design documents: docs/designs/
• Development notes: docs/thoughts/

Voice-Controlled Development

This repo uses voice-triggered Claude agents for feature development via RAM.

Workflow

1. Idea → Capture via voice: "idea for ovrly: add overlay sharing"
2. Brainstorm → Create design doc: "brainstorm the overlay sharing feature"
3. Plan → Create implementation plan: "plan the overlay sharing feature"
4. Implement → Write code: "implement step 1 of the overlay sharing plan"
5. Review → Check progress: "review plan progress"

Current Plans

Plan	Status
Unified Lottie Overlays	In Progress
Music Selection for Videos	In Progress

Voice Commands

Say...	Does...
"what plans exist in ovrly"	Lists active plans
"brainstorm X in ovrly"	Creates design doc
"plan X in ovrly"	Creates implementation plan
"implement X in ovrly"	Writes code, creates PR