A calm, opinionated system for independent artists to finish their music, understand what matters, and release with confidence.
Most music doesn't fail because it's bad. It fails because artists lack clear, trusted feedback and prioritisation before release. They are often overwhelmed by fragmented tools and contradictory advice.
totalaud.io is a second opinion before release — a finishing mirror for both music and strategy. It is a decision-support system designed to reduce cognitive, emotional, and creative friction.
- Finish — Receive human-framed finishing notes from multiple perspectives (Producer, Mix, Listener, Industry). No quality scores, just insights to help you finish with confidence.
- Release (Timeline) — Model your release as a multi-week narrative rather than a single drop. Focus on sequencing, momentum, and timing.
- Leverage (Intel) — Treat relationships as creative capital. Uses structured data reasoning to turn messy contact lists into actionable memory and insight.
- Pitch — A single source of narrative truth for your bios, pitches, and social copy. Ensure consistency and maintain your unique voice across all channels.
totalaud.io is built as a modern, high-performance monorepo focused on stability and a premium user experience.
- Core Framework: Next.js 15 (App Router)
- Language: TypeScript 5 (Strict Mode)
- Styling: Tailwind CSS with a curated Slate Cyan & Matte Black palette.
- State Management: Zustand for lightweight, reactive workspace state.
- Database / Auth: Supabase for PostgreSQL, Auth, and Edge Functions.
- Motion: Framer Motion for calm, cinematic transitions.
- Monorepo Tooling: Turborepo + pnpm workspaces.
- Deployment: Railway for robust infrastructure.
totalaud.io/
├── apps/
│ └── aud-web/ # Main workspace application
│ ├── src/app/ # Next.js 15 App Router
│ ├── src/components/ # Mode-specific components (Ideas, Scout, Timeline, Pitch)
│ └── src/stores/ # Zustand state slices
├── packages/
│ └── core/
│ ├── ai-provider/ # LLM abstraction (Claude 3.5/4.5)
│ ├── supabase/ # Typed database client & RLS
│ ├── logger/ # Structured, level-based logging
│ └── integrations/ # External API connectors
└── supabase/ # Database migrations & seed data
- Node.js 20+
- pnpm 9+
- Supabase CLI (for local development)
# Install dependencies
pnpm install
# Start development servers
pnpm devVisit:
- Workspace:
http://localhost:3000 - Supabase Studio:
http://localhost:54323
Copy the example environment file and add your keys (Supabase, Anthropic):
cp .env.example .env.localtotalaud.io maintains high standards for code health and maintainability.
- Current Audit Score: 70/100 (February 2026 Audit)
- British English: Mandatory for all UI copy, comments, and documentation (
colour,optimise,behaviour). - Validated Config: Runtime environment variable validation via Zod.
- Structured Logging: Level-based logging (debug, info, warn, error) using the
@total-audio/loggerpackage. - Type Safety: strict TypeScript enforcement and Zod validation for all API inputs.
pnpm lint # Run ESLint across all packages
pnpm format # Format code with Prettier
pnpm typecheck # Verify TypeScript across the monorepo
pnpm build # Production build (Turborepo)
pnpm test # Run Vitest suite- Phase 1: Foundation (Monorepo, Supabase, Auth)
- Phase 2: Workspace Core (Ideas Mode, Workspace Routing)
- Phase 3: Scout & Intel (Contact Management & Discovery)
- Phase 4: Finish & Perspectives (Finishing Notes system)
- Phase 5: Release Multi-Week Timeline (Advanced Sequencing)
- Phase 6: Pitch Coach & Storytelling (Narrative consistency system)
- Phase 7: Public Beta (Target: April 2026)
- PRD.md — Product Requirements & Specifications
- VISION.md — Canonical source of project truth
- CODEBASE_AUDIT_2026.md — Latest technical audit and status
- CLAUDE.md — Configuration and development rules for AI assistants
Proprietary — © 2026 Total Audio