How vulcio/oneverse works
Oneverse is a shared account and collaboration platform whose apps serve worship teams, musicians, and planners. A principal workflow is a musician creating a structured song in Songverse, organizing songs into songbooks or sets, and sharing them with a team; Planiverse supports the parallel event-planning workflow, while screens and live sessions support use at a venue. The API, shared database, and storage underpin these products. The README documents product capabilities and shared-API relationships; sampled source confirms only selected API and storage calls, so other internal links are omitted.
Main entry points: app-shell.tsx Songverse · app.module.ts Oneverse API · index.tsx Planiverse · setlists.service.ts Sets and sharing
Components 23
Accounts and access
- Oneverse account
apps/oneverse/src/routes/index.tsx - Authentication
apps/api/src/auth
Songs and sets
- Songverse
apps/web/src/components/app-shell.tsx - Song charts
packages/core/src/chordpro/parser.ts - Song versions
apps/api/src/song-versions/song-versions.service.ts - Global catalogue
apps/api/src/publishing/publishing.service.ts - Songbooks
apps/api/src/songbooks/songbooks.service.ts - Sets and sharing
apps/api/src/setlists/setlists.service.ts - Arrangements
apps/api/src/arrangements/arrangements.service.ts - Song attachments
apps/api/src/attachments/attachments.service.ts
Planning and teams
- Planiverse
apps/planiverse/src/routes/_protected/organizations/index.tsx - Events and rotas
apps/api/src/team-events/team-events.service.ts - Organizations
apps/api/src/organizations/organizations.service.ts - Teams and roles
apps/api/src/teams/teams.service.ts
Live and screens
- Screens
apps/api/src/screens/screens.service.ts - Live sessions
apps/api/src/sync/sync.server.ts - Operator console
packages/operator/src/components/operator-console.tsx
Shared platform
- Oneverse API
apps/api/src/app.module.ts - PostgreSQL database
packages/db/src/seed.ts - File storage
apps/api/src/storage/storage.service.ts - Organization storage
apps/api/src/own-storage/own-storage.service.ts
Other components
- Musician
- Planner
Connections 24
- Musician → Songverse: uses
- Planner → Planiverse: uses
- Songverse → Oneverse account: signs in with
- Planiverse → Oneverse account: shares accounts
- Oneverse account → Authentication: authenticates through
- Songverse → Oneverse API: uses shared API
- Planiverse → Oneverse API: uses shared API
- Songverse → Song charts: parses charts with
- Songverse → Song versions: manages songs through
- Song versions → Global catalogue: submits songs to
- Songverse → Songbooks: organizes songs in
- Songverse → Sets and sharing: plans services with
- Sets and sharing → Arrangements: uses arrangements
- Planiverse → Events and rotas: plans events through
- Planiverse → Organizations: manages
- Organizations → Teams and roles: organizes
- Oneverse API → PostgreSQL database: uses Prisma
- Oneverse API → File storage: stores files with
- Oneverse API → Organization storage: supports organization buckets
- Organization storage → File storage: moves files through
apps/api/src/own-storage/own-storage.service.ts - Oneverse API → Song attachments: handles attachments through
- Sets and sharing → Screens: displayed on
- Screens → Live sessions: supports live sessions
- Live sessions → Operator console: drives