skills.rest
williamwang25
williamwang25COMMUNITY
Explore all skills by this author →
GitHub

miniprogram-development

Guide WeChat Mini Program project structure, configuration, debugging, and publishing workflows.

Updated May 14, 2026
Search Tags:#debugging#wx.cloud#wechat mini program#miniprogram-ci#cloudbase integration#preview publishing#tabBar routing
One-click install
npx skills add https://github.com/williamwang25/ams-admin --skill miniprogram-development-williamwang25
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: miniprogram-development
Source: https://github.com/williamwang25/ams-admin/tree/main/.windsurf/skills/cloudbase/references/miniprogram-development
Command: npx skills add https://github.com/williamwang25/ams-admin --skill miniprogram-development-williamwang25

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the friction of building, debugging, previewing, testing, and releasing WeChat Mini Programs by giving you platform-accurate guidance and CloudBase-aware workflows when needed.

Core Features & Use Cases

  • Mini Program project workflow guidance: Organizes what to check and how to proceed across structure, configuration, and release steps (e.g., pages, routing, tabBar, assets, and project config).
  • Debug/preview/publish pathways: Helps you choose the right path between WeChat Developer Tools and miniprogram-ci, and sets expectations for real-device validation.
  • CloudBase integration rules: Applies CloudBase-specific requirements only when the project explicitly uses CloudBase (wx.cloud, environment setup, permissions, and OPENID-based identity).
  • Agent-ready conventions and guardrails: Prevents common mistakes like mixing web auth assumptions into mini programs and applying CloudBase constraints to non-CloudBase projects.

Quick Start

Use the miniprogram-development skill to help you implement and configure the required page files, project.config.json, and preview/publishing steps for a WeChat Mini Program project.

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 page routing for a WeChat Mini Program?▼

To configure WeChat Mini Program projects, you must correctly handle project.config.json and page configuration files to define routing and optional tabBar assets, preventing build and release issues. Proper structure ensures reliable preview and publishing workflows.

What is the best way to preview and publish WeChat Mini Programs using miniprogram-ci?▼

The best way to preview and publish WeChat Mini Programs is choosing between WeChat Developer Tools for debugging and miniprogram-ci for automated workflows. Real-device validation is expected before final release to ensure platform reliability.

How do I integrate wx.cloud and CloudBase in WeChat Mini Programs?▼

To integrate CloudBase in WeChat Mini Programs, apply wx.cloud specific rules for environment setup, permissions, and OPENID-based identity only when the project explicitly requests it. This prevents mixing web auth assumptions into mini program scenarios.

Can I apply CloudBase constraints to non-CloudBase WeChat Mini Program projects?▼

No, you cannot apply CloudBase constraints to non-CloudBase WeChat Mini Program projects. Agent-ready guardrails prevent applying wx.cloud requirements and CloudBase-specific constraints to standard projects that do not explicitly use them.

Why does my WeChat Mini Program build fail during tabBar configuration?▼

WeChat Mini Program builds fail during tabBar configuration due to incorrect project.config.json handling and missing optional tabBar asset decisions. Proper page configuration and routing setup prevent these common build and release issues.

Related Skills

Explore More Software Engineering Skills→
AYin-ZAYin-Z
1

miniprogram-development

Build and maintain WeChat Mini Programs with CloudBase integration.

Community
Advanced
yyds-xyyds-x

miniprogram-development

Guide WeChat Mini Program development, debugging, preview, and deployment with CloudBase.

Community
Advanced
xongtaoxongtao

auth-wechat-miniprogram

Authenticates WeChat Mini Program users via cloud.getWXContext() in functions.

Community
Intermediate
partme-aipartme-ai
610

uniapp-mini-guide

Guide uni-app mini program development with configuration, components, and API usage.

Official
Basic