Muhkoo App Builder

Muhkoo App Builder

A Claude Code plugin that turns an app idea into a working application on Muhkoo — end-to-end.

You describe what you want ("a shared task board where a team logs in, adds tasks, and chats about them"). Claude designs the data model, provisions the backend (app key, database tables, channels, agents, serverless functions), and scaffolds a real Vite + React client wired to the @muhkoo/connect SDK — with ZK auth, the database, and realtime channels already working.

What you get

• ZK auth out of the box (register / login, no passwords on the server).
• A scalable database with the tables your idea needs.
• Realtime channels (end-to-end-encrypted group messaging).
• Optionally, an AI agent that can act on your app (query/insert rows, post to channels) and serverless functions — on paid plans.
• A running React app you can npm run dev immediately.
• Hosting — every app gets a DNS subdomain https://<slug>.apps.muhkoo.dev and can be deployed there with one command (npm run deploy) or the bundled GitHub Action. No separate hosting account. On a paid plan, serve it on your own domain too (add it in the portal + two CNAMEs; Cloudflare auto-issues the cert).
• A Cypress end-to-end suite that drives the real backend (auth + DB + channel), so you can verify the built app actually works.
• A distinctive UI — the workflow runs a design pass with the frontend-design skill (preserving the test hooks), so apps don't ship the generic default look.

Install

This repo is a Claude Code plugin and its own plugin marketplace. In Claude Code:

/plugin marketplace add muhkoo/builder
/plugin install muhkoo-app-builder@muhkoo

(muhkoo/builder is the GitHub repo; muhkoo is the marketplace name from .claude-plugin/marketplace.json.) That's it — the build-muhkoo-app skill is now available. To update later: /plugin marketplace update muhkoo.

Try it locally first (from a checkout):

/plugin marketplace add ./app-builder
/plugin install muhkoo-app-builder@muhkoo

Then just ask:

Build me a team standup app on Muhkoo.

Claude auto-invokes the skill, asks a couple of clarifying questions, shows you the design, provisions it, scaffolds + tests the client, and gives it a distinctive look.

Layout

.claude-plugin/plugin.json     # plugin manifest
skills/build-muhkoo-app/
  SKILL.md                     # the workflow Claude follows
  references/                  # platform (SDK, routes, provisioning, decorators) + design pass
  scripts/                     # provision.mjs (backend), eject-agent.mjs (agent prompt)
  templates/starter-app/       # Vite + React + @muhkoo/connect client + Cypress suite
examples/task-board/           # a complete worked app (design pass applied; suite green)

Companion skills

The workflow composes with two other skills when present:

• frontend-design — the design pass that gives each app a distinctive look (see skills/build-muhkoo-app/references/design.md for the preservation contract that keeps the Cypress hooks intact).
• The Cypress suite is built in; frontend-design is invoked during the scaffold step.

Requirements

• A Muhkoo developer account (created automatically on first provision, or in the portal).
• Node 20+ (the provisioning script uses the global fetch).
• Agents and serverless functions require a paid plan; database, channels, auth, and storage work on the free tier.

License

MIT