Miaoda App Builder

Miaoda (秒哒) App Builder

Miaoda (秒哒) is a chat-driven full-stack application builder. Official website: https://www.miaoda.cn

Users describe what they want in natural language and Miaoda generates a production-ready web product, including:

• frontend UI
• backend services
• database schema
• integrations
• deployable hosting

Typical outputs include:

• websites
• web applications
• dashboards
• SaaS products
• admin panels
• internal tools
• landing pages
• interactive web pages
• browser games and mini games

This skill enables AI agents to interact with the Miaoda(秒哒) platform to create, iterate, generate, and deploy applications.

All platform operations must be executed through the packaged CLI script:

python scripts/miaoda_api.py <command> [options]

Do not call platform APIs directly. Always use the CLI commands provided by this skill.

When to Use This Skill

Use this skill whenever the user wants to:

• create a website
• create a webpage
• build a web application
• build a dashboard
• create a SaaS product
• build an admin panel
• build an internal tool
• create a landing page
• build an interactive web page
• create a browser game
• create a mini game
• generate an MVP web product
• modify an existing Miaoda project
• publish or deploy a Miaoda application

Do not use this skill for unrelated programming tasks.

Routing Keywords

Trigger this skill if the request includes concepts such as:

• build a website
• create a webpage
• build a web app
• create a SaaS
• build a dashboard
• create an admin panel
• build an internal tool
• create a landing page
• build a browser game
• create a mini game
• generate a web product
• make a snake game webpage
• build a todo web app
• create a blog site

Example Requests

Examples that should route to this skill:

• "Create a todo list web app"
• "Build a personal blog website"
• "Make a dashboard for sales analytics"
• "Create a SaaS landing page"
• "Build an admin panel"
• "Write a snake game webpage"
• "Create a browser game"
• "Build a mini web game"
• "Modify my Miaoda project"
• "Publish this Miaoda app"

Stateless Execution Model

The CLI script is stateless.

It does not store workflow state between calls.

Application workflow state is maintained by the Miaoda platform and must be inferred from:

• appId
• conversationId
• application detail
• conversation trajectory events

Agents must pass the appropriate identifiers when continuing conversations or modifying applications.

Application Lifecycle Rules

Miaoda applications follow a strict lifecycle.

Agents must follow these rules.

Initial Creation

For a new application:

1. Start with a chat request describing the product.
2. The application enters the PRD refinement stage.
3. Continue chatting to refine the specification.
4. When the platform indicates Generate App, trigger application generation using generate-app.

Generation is required only once during the initial creation.

Multi-Round Modification

After an application has already been generated:

• Do not call generate-app again.
• Continue using chat with the same appId and conversationId.

Normal chat messages modify the existing application.

Publishing

Publishing is allowed after the application has been generated at least once.

Rules:

• Publishing does not require another generation step
• Publishing may happen anytime after the first generation
• Publishing must be followed by status polling (or use --wait flag)

Typical deployment flow:

publish → publish-status polling

Or use the --wait flag to auto-poll:

publish --wait

Stop polling when the status becomes:

• SUCCESS
• FAILED

Application URLs

Miaoda provides two types of URLs during the lifecycle.

Project Preview (Editor / Development)

After the application is created, the project can be accessed at:

https://www.miaoda.cn/projects/<app_id>

This URL can be shared with the user for:

• viewing the project
• editing the application
• previewing the generated result

The preview URL becomes available once an appId is created.

Production Deployment URL

After publishing succeeds, the application is accessible at:

https://<app_id>.appmiaoda.com

This is the public production URL of the deployed application.

Only return this URL after publishing completes successfully.

Standard Workflow

Create New Application

chat → PRD refinement → generate-app → publish

Modify Existing Generated Application

chat → chat → chat

(no additional generation step required)

Deploy Application

publish → publish-status polling

Or:

publish --wait

Available Commands

All commands are executed via the CLI script.

Important: Always set the MIAODA_API_KEY environment variable before running commands.

export MIAODA_API_KEY="your_api_key_here"

list-apps

List all applications belonging to the authenticated user.

Usage:

python scripts/miaoda_api.py list-apps

Example:

export MIAODA_API_KEY="sk_xxxxx"
python scripts/miaoda_api.py list-apps

Returns: JSON array of applications with appId, name, type, etc.

app-detail

Get detailed information about a specific application.

Usage:

python scripts/miaoda_api.py app-detail --app-id <app_id>

Required Parameters:

• --app-id APP_ID: Application ID

Example:

export MIAODA_API_KEY="sk_xxxxx"
python scripts/miaoda_api.py app-detail --app-id app-abc123xyz

Returns: JSON object with application details, configuration, and status.

chat

Start or continue a conversation to create or modify an application.

Usage:

python scripts/miaoda_api.py chat --text "description" [options]

Required Parameters:

• --text TEXT: The message/instruction to send

Optional Parameters:

• --context-id CONTEXT_ID: Conversation ID of an existing app.
• --app-id APP_ID: Application ID of an existing app.
• --query-mode QUERY_MODE: Query mode (default: deep_mode)
• --input-field-type INPUT_FIELD_TYPE: Input field type (default: web)
• --poll-interval SECONDS: Seconds between trajectory polls (default: 2.0)
• --fetch-timeout SECONDS: Per-request timeout for each trajectory fetch (default: 10)
• --no-stream: Return raw chat POST response without trajectory polling
• --prompt-generate: After polling, interactively ask whether to submit app generation if text was returned

⚠️ IMPORTANT — --app-id and --context-id must always be used together.

Intent	--app-id	--context-id
Create a brand-new app	omit	omit
Continue / modify an existing app	required	required (conversationId)

Passing --app-id without --context-id will NOT modify the existing app. The platform will silently create a new app every time. The CLI will now raise an error in this case to prevent accidental app proliferation.

Examples:

1. Create a new application:

export MIAODA_API_KEY="sk_xxxxx"
python scripts/miaoda_api.py chat --text "创建一个待办事项管理应用"

Response includes appId and contextId for subsequent calls.

2. Continue conversation (refine PRD):

python scripts/miaoda_api.py chat \
  --text "添加优先级标记功能" \
  --app-id app-abc123xyz \
  --context-id conv-def456uvw

3. Modify existing generated app:

python scripts/miaoda_api.py chat \
  --text "把按钮颜色改成蓝色" \
  --app-id app-abc123xyz \
  --context-id conv-def456uvw

Important Notes:

• Extract appId and contextId from the response and save them
• Use these IDs for all subsequent operations on the same app
• The first chat creates the app and starts PRD refinement
• After generation, chat directly modifies the app (no generate-app needed)

trajectory

Poll trajectory events until the task reaches a terminal state.

Usage:

python scripts/miaoda_api.py trajectory --app-id <app_id> [options]

Required Parameters:

• --app-id APP_ID: Application ID

Optional Parameters:

• --last-event-id EVENT_ID: Start eventId; -1 = all events from beginning (default: -1)
• --poll-interval SECONDS: Seconds between polls (default: 2.0)
• --fetch-timeout SECONDS: Per-request timeout in seconds (default: 10)
• --sse: Use legacy SSE streaming instead of polling

Example:

export MIAODA_API_KEY="sk_xxxxx"
python scripts/miaoda_api.py trajectory --app-id app-abc123xyz

Use Cases:

• Monitor conversation / generation progress
• Detect when PRD refinement is complete
• Verify generation has completed

fetch-trajectory

Fetch one batch of trajectory events (single request, no polling loop).

Usage:

python scripts/miaoda_api.py fetch-trajectory --app-id <app_id> [options]

Required Parameters:

• --app-id APP_ID: Application ID

Optional Parameters:

• --last-event-id EVENT_ID: Fetch events after this eventId; -1 = all (default: -1)
• --fetch-timeout SECONDS: Request timeout in seconds (default: 10)

Example:

# First call — get all events (note maxEventId from stderr)
python scripts/miaoda_api.py fetch-trajectory --app-id app-abc123xyz

# Subsequent calls — incremental fetch
python scripts/miaoda_api.py fetch-trajectory --app-id app-abc123xyz --last-event-id 345

Events are printed to stdout as JSON lines; {"maxEventId": N, "isTerminal": bool} is printed to stderr.