NASMIX is a project-first music production knowledge system for Iraqi and Arabic arrangement workflows.
Development happens on the develop branch. Reusable musical knowledge lives in versioned JSON files under data/.
Every song is created as an independent local project. The project begins with a required Song Brief and then opens a nine-stage workspace:
- Song Brief
- Structure
- Track Plan
- Suno Reference
- Prompt Generation
- Take Review
- Cubase Handoff
- Mix QA
- Export QA
Each project stores its song data, arrangement map, role-first track plan, generated prompts, accepted and rejected decisions, reviewed takes, Cubase handoff notes, QA checks, export state, and activity history.
Changes are saved automatically to IndexedDB with a localStorage fallback. Complete projects can be exported and imported as JSON.
GitHub Pages deployment is configured from the main branch through GitHub Actions.