pal-e-docs

Project: my-vibes-world

project-my-vibes-world Project Page

active project-page
Project

Vision

Creative vibe pages at myvibes.world — each page is a standalone experience pairing a phrase with music, designed to be shared as a single link on Instagram. Built on the full pal-e-platform stack. Future path to native iOS app via turbo-ios.

User Stories

Key Role Story Success Metric
instagram-visitor Visitor Tap an Instagram link, land on a full-screen vibe page with phrase + music, no friction Page loads <2s on mobile, works in Instagram in-app browser
create-vibe Lucas Add a new vibe page with a Rails route, controller, and view, push to main, live in minutes New vibe deployed within one CI/CD cycle
tone-audio Lucas Layer custom Tone.js audio effects on any vibe page beyond just the Spotify track Ambient audio triggers on user interaction
native-app Visitor Download the app, tap an Instagram link, it opens in the native app instead of browser Universal Links route to turbo-ios shell

Architecture

Architecture docs live in the repo: docs/architecture.md. Key decisions:
  • Rails 8 + Hotwire (Turbo + Stimulus) — server-rendered pages with SPA-like interactivity
  • Importmap Rails for ESM imports, no bundler
  • Propshaft asset pipeline
  • Tone.js for Web Audio synthesis and ambient effects
  • Spotify Embed API for streaming tracks
  • Puma application server
  • Full pipeline: Woodpecker CI → Harbor → ArgoCD → k3s → Tailscale Funnel → Caddy
  • Future iOS: turbo-ios native Swift shell with WKWebView (same pattern as landscaping-assistant-ios)

Board

See board-my-vibes-world

Status

2026-06-18: Repo created. Docs scaffold merged. PR #9 merged — fixed architecture docs from Vite to Rails 8 stack, removed .claude-no-enforce. Deployment overlay merged. DNS and service registration PRs approved, pending infra apply. Not yet live.

Milestones

  • 2026-06-18 — Repo created, docs scaffold, infra PRs
  • 2026-06-18 — PR #9: Architecture docs corrected to Rails 8 stack

Repos

Repo Platform Role Status
<a href="https://forgejo.tail5b443a.ts.net/ldraney/my-vibes-world">ldraney/my-vibes-world</a> Forgejo Application code Active