How razaele0003/pacana works
Pacana is a local-first focus timer and time journal, with an interactive capybara companion, available as a web app and a Windows desktop app. The main workflow enters the app, operates the timer and journal in the Pacana workspace, and persists state locally; the engine handles timer and checkpoint reconciliation, with schedule utilities supporting clock-aligned runs. The README documents progress/XP, photo reflections, backups, ringtones, fullscreen mode, and offline use. Some feature branches are represented by their documented UI or subsystem; desktop wiring and unsampled implementation details are not inferred.
Main entry points: pacana.tsx Pacana workspace · model.ts App state model · autonomous-controller.ts Autonomous behavior · engine.ts Focus engine
Components 21
App entry
- Web entry
app/page.tsx - Landing page
components/landing.tsx - Workspace entry
app/app/page.tsx - Windows app
desktop/main.cjs
Focus workspace
- Pacana workspace
components/pacana.tsx - Focus engine
core/engine.ts - Clock scheduling
core/schedule.ts - App state model
core/model.ts - Fullscreen timer
components/fullscreen-timer.tsx - Journal photos
components/log-photo.tsx - Ringtone browser
components/ringtone-browser.tsx
Cappy companion
- Interactive companion
components/interactive-companion.tsx - Autonomous behavior
lib/capy-npc/autonomous-controller.ts - Movement geometry
lib/capy-npc/obstacle-manager.ts - Capybara sprite
components/capy-sprite.tsx - Companion sounds
lib/companion-sound.ts
Local services
- Local state store
data/store.ts - Backup validation
data/backup.ts - Browser audio
adapters/browser.ts - Ringtone definitions
core/ringtones.ts
Other components
- User
Connections 26
- User → Web entry: opens
README.md - Web entry → Landing page: renders
app/page.tsx - User → Workspace entry: opens
README.md - Workspace entry → Pacana workspace: renders
app/app/page.tsx - Pacana workspace → Focus engine: reconciles state
components/pacana.tsx - Pacana workspace → Clock scheduling: gets day key
components/pacana.tsx - Pacana workspace → Local state store: transacts state
components/pacana.tsx - Pacana workspace → Browser audio: unlocks audio
components/pacana.tsx - Pacana workspace → Fullscreen timer: renders
components/pacana.tsx - Pacana workspace → Interactive companion: renders
components/pacana.tsx - Pacana workspace → Ringtone browser: renders
components/pacana.tsx - Pacana workspace → Journal photos: uses
components/pacana.tsx - Focus engine → Clock scheduling: gets next clock
core/engine.ts - Focus engine → App state model: uses state types
core/engine.ts - Local state store → App state model: stores state
data/store.ts - Local state store → Backup validation: uses validation
data/store.ts - Backup validation → App state model: validates state
data/backup.ts - Browser audio → App state model: uses settings
adapters/browser.ts - Browser audio → Ringtone definitions: plays definitions
adapters/browser.ts - Ringtone browser → App state model: uses ringtone types
components/ringtone-browser.tsx - Ringtone browser → Ringtone definitions: shows choices
components/ringtone-browser.tsx - Interactive companion → Autonomous behavior: controls behavior
components/interactive-companion.tsx - Interactive companion → Capybara sprite: renders
components/interactive-companion.tsx - Autonomous behavior → Capybara sprite: uses poses
lib/capy-npc/autonomous-controller.ts - Autonomous behavior → Companion sounds: plays cues
lib/capy-npc/autonomous-controller.ts - Autonomous behavior → Movement geometry: uses geometry
lib/capy-npc/autonomous-controller.ts