The Avatar Brothers
Vision
Animated motion comic website and iOS app telling the story of two brothers — Lucas and Marcus — who become dual Avatars. Episodes play as animated comic strips on page load: fight scenes, facial expressions, dialogue boxes. Character identity is the foundation. No UI chrome, no controls — just the story. Public site at theavatarbrothers.com.
User Stories
| Key | Role | Summary | Success Metric |
|---|---|---|---|
| episode-viewing | Viewer (Lucas/Marcus) | Watch animated comic episodes play on page load | Episode plays start-to-finish with expressions, dialog, transitions |
| project-bootstrap | Developer (Lucas) | Docs, infra, and pipeline deployed | theavatarbrothers.com serves a page, CI/CD works |
Architecture
Rails 8 monolith + Hotwire + GSAP. SVG characters with swappable expressions. Episodes are Rails views with embedded GSAP timelines. Content model: Season → Episode → Scene.
| Layer | Technology |
|---|---|
| Framework | Rails 8 monolith |
| Interactivity | Hotwire (Turbo + Stimulus) |
| Animation | GSAP (GreenSock) |
| Art | SVG characters with expressions |
| Database | PostgreSQL (CNPG) |
| iOS | Turbo Native |
| CI/CD | Woodpecker CI → Harbor → ArgoCD |
| DNS | theavatarbrothers.com via godaddy-tofu |
| Ingress | Tailscale Funnel |
| Auth | None — public site |
Key decisions: No Capacitor (Turbo Native for iOS). No PWA. No user accounts. Episodes auto-play on load.
Board
board-the-avatar-brothers
Status
Docs merged (PR #5). Architecture, user stories, and Episode 1 scene breakdown in place. Next: infra bootstrap (#2), then hello world landing page (#7).
Milestones
None yet.
Repos
| Repo | Platform | Role | Status |
|---|---|---|---|
| <a href="https://forgejo.tail5b443a.ts.net/ldraney/the-avatar-brothers">the-avatar-brothers</a> | Forgejo | App repo | Docs merged, no app code yet |