Create a MobyApps miniapp

Scaffold a new Next.js miniapp for MobyApps WebView with app chrome, i18n, theme, and packaging scripts. Next.js is the current scaffold example — miniapps are not limited to it (React, Vue, vanilla JS, and other WebView-ready stacks work too).

Prerequisites

Node.js 20+
pnpm (recommended)
Install @mobyapps packages — .npmrc with @mobyapps:registry=https://npm.mobyapps.dev/

Greenfield scaffold

pnpm create @mobyapps/miniapp@1.1.2 my-miniapp
cd my-miniapp
pnpm install

The scaffold includes:

Included	Notes
App-kit	`@/components/ui/app/*`, hooks, types — pre-installed (no extra `shadcn add`)
i18n	`next-intl` with `en` + `ru`
Theme	`next-themes` + safe-area providers
CSS layers	`styles/globals.css`, `miniapp-theme.css`, `miniapp-dark.css`
Build	`pnpm miniapp` → `dist/miniapp.zip`
Publish	`pnpm publish` → upload to MobyApps backend (via `@mobyapps/build-utils`)
Cursor rule	`.cursor/rules/mobyapps-miniapp.mdc`

Configure

Edit mobyapps.mjs:

export default {
  id: "your-miniapp-id",
  api_key: "your-api-key",
};

Add shadcn primitives (optional)

App-kit does not include every shadcn primitive. Add what you need:

npx shadcn@latest add button card dialog

Develop and release

pnpm dev
pnpm miniapp      # build + zip
pnpm publish      # build + zip + upload to MobyApps backend