Getting Started
Start here when you are new to Mika. Keep the first success small: understand the boundary, confirm package state, run the seeded template, then wire Mika into an existing Astro + EmDash app when you are ready.
Read src/ paths as files in the host app. Package imports come from @bnomei/emdash-mika; copied template files become host-owned after copy.
Run The Seeded Template
Section titled “Run The Seeded Template”1. OverviewLearn what Mika provides and what stays host-owned.
2. CompatibilityCheck package state, local workspace mode, and peer ranges before install.
3. Seeded TemplateRun the sibling host app and verify storefront, admin, and agent paths.
Wire An Existing App
Section titled “Wire An Existing App”Use this path after you have an Astro + EmDash app to integrate:
4. InstallRegister Mika with EmDash and choose the first backend strategy.
5. Product PageConnect one host product route to Mika sellables and purchase components.
6. First Integration ChecklistWalk the file copy, config, product page, and verification sequence.
After this path, use Product Authoring for content-to-sellable mapping, Astro Storefront for copied Actions and UI, and Backend And Provider when real provider and repository wiring starts.
Source Anchors
Section titled “Source Anchors”- ⓟ
../emdash-mika/package.json - ⓟ
../emdash-mika/README.md - ⓣ
../emdash-mika-template/package.json - ⓣ
../emdash-mika-template/README.md