miniprogram-development

Guide WeChat Mini Program structure, configuration, and lifecycle workflows.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mrpersimmon/xiao-han-studio --skill miniprogram-development-mrpersimmon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: miniprogram-development
Source: https://github.com/mrpersimmon/xiao-han-studio/tree/main/.agents/skills/cloudbase/references/miniprogram-development
Command: npx skills add https://github.com/mrpersimmon/xiao-han-studio --skill miniprogram-development-mrpersimmon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps developers correctly build, configure, debug, preview, test, and publish WeChat Mini Programs—especially when CloudBase (wx.cloud) integration and mini-program-specific project structure are required.

Core Features & Use Cases

  • WeChat Mini Program project guidance: Organize mini program pages, components, tabBar, routing, navigation, and project configuration such as project.config.json and appid.
  • DevTools and CI workflows: Follow WeChat Developer Tools workflows for simulator debugging and real-device validation, with miniprogram-ci as an automation fallback where applicable.
  • CloudBase-ready mini program integration: Apply wx.cloud-based client patterns and CloudBase identity/storage/database conventions only when the project explicitly uses CloudBase.

Use case: you need to restructure a mini program feature, fix preview/publish issues in the IDE, and wire the correct project.config.json plus tabBar behavior while ensuring CloudBase rules are applied only if wx.cloud is used.

Quick Start

Ask the agent to update your WeChat Mini Program’s project.config.json, create the required page configuration, and produce a safe CloudBase-aware preview/publish plan.

Frequently Asked Questions about miniprogram-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure project.config.json and appid for a WeChat Mini Program?

To configure a WeChat Mini Program, you set the appid and project configuration in project.config.json, ensuring the project structure aligns with mini-program conventions for pages, components, and tabBar navigation.

How do I set up tabBar navigation and page routing in a WeChat Mini Program?

Setting up tabBar navigation and routing in a WeChat Mini Program involves defining page paths and tabBar entries in the app configuration, applying mini-program-specific lifecycle workflows for correct page transitions.

Can I use miniprogram-ci to automate WeChat Mini Program preview and upload?

Yes, you can use miniprogram-ci as an automation fallback for WeChat Mini Program preview and upload steps, complementing standard WeChat Developer Tools workflows for simulator debugging and real-device validation.

Does WeChat Mini Program development work with CloudBase integration?

WeChat Mini Program development supports CloudBase integration using wx.cloud client patterns, applying CloudBase identity, storage, and database conventions only when explicitly indicated in the project configuration.

Why should I avoid web authentication patterns in WeChat Mini Program projects?

You should avoid web authentication patterns in WeChat Mini Program projects because mini-program-specific conventions require obtaining CloudBase identity via wx context, ensuring correct lifecycle workflows and project structure.

What is the best way to debug a WeChat Mini Program in WeChat Developer Tools?

The best way to debug a WeChat Mini Program is by using WeChat Developer Tools for simulator debugging and real-device validation, ensuring correct project configuration and safe preview or publish workflows.