Guides
Use guides when you are wiring a real host app. They build on the concepts section and point back to source anchors instead of inventing unsupported platform behavior.
Start Or Extend A Storefront
Section titled “Start Or Extend A Storefront”First Integration ChecklistEnd-to-end file copy, config, product page, and verification sequence.
Product AuthoringMap EmDash or host content entries to sellables, prices, stock, and JSON-LD.
Astro StorefrontActions, copied components, pages, and browser form boundaries.
Cart, Wishlist, CheckoutHost-owned request pages and form flows for buyer state.
Account And DownloadsMagic links, account exports, delete requests, downloads, and host session policy.
Wire Providers And Backend Behavior
Section titled “Wire Providers And Backend Behavior”Backend And ProviderBuild the host Mika API with repositories, providers, defaults, and hooks.
Production BackendRepository, provider, notification, idempotency, and maintenance dependencies.
Stripe ProviderWire the optional host-owned Stripe adapter and keep SDK secrets server-side.
Stripe And Webhook CookbookRaw-body verification, idempotency, endpoint shape, and checkout-return checks.
Publish AI Surfaces
Section titled “Publish AI Surfaces”Agent-Ready StorefrontPublish metadata without exposing protected tools by default.
ACP CheckoutProject Mika catalog and checkout semantics into host-owned ACP endpoints.
Deploy And Operate
Section titled “Deploy And Operate”Deployment MatrixCompare Node, Cloudflare, static docs, webhook, storage, and scheduler duties.
Deployment MaintenanceRun scheduled cleanup for email, webhook payloads, ACP sessions, ephemeral rows, account deletes, and stuck leases.
Cloudflare VariantUnderstand the seeded Worker, D1, and R2 deployment sketch.
Admin ActionsExpose trusted Mika operations through EmDash action provider buttons.
TroubleshootingCommon setup, Action, provider, route, and deployment failures.
Start with First Integration Checklist when wiring an existing host app. Use Product Authoring before expanding buyer flows.
Source Anchors
Section titled “Source Anchors”- ⓟ
../emdash-mika/src/server.ts - ⓟ
../emdash-mika/src/api/backend.ts - ⓐ
../emdash-mika/src/templates/astro/README.md - ⓣ
../emdash-mika-template/docs/usage.md