WeChat Mini Program Full-Stack Toolkit

What it solves

WeChat Mini Program projects often get stuck on engineering details rather than single APIs: unclear app.json subpackage structure, main bundle approaching 2MB, inconsistent cloud env, openid passed from client to server, deprecated wx.getUserInfo usage, missing 'worklet' declarations in Skyline animations, and missing checks for payments, sharing, and analytics. This skill organizes those problems into actionable references instead of abstract guidance.

How it works

It follows a “read the relevant reference first, then code” workflow. Core capabilities include:

• Project initialization: directory structure, project.config.json, app.json, and baseline config.
• Cloud development: CRUD, aggregation, transactions, permission rules, and correct use of cloud.DYNAMIC_CURRENT_ENV.
• Auth and payments: avatar/nickname button flow, cloud-function auth, JSAPI orders, payment callbacks, refunds, and signature debugging.
• Subpackages and performance: subpackage analysis with analyze_subpackages.py, 2MB limits, cross-package require, precise setData, and WXS optimization.
• Advanced scenarios: Skyline Worklet animations, live/RTC, cloud hosting, content safety, app handoff, hardware features, and optional CI/CD.

The key step is mapping the task to the right document: cloud-dev.md for cloud, payment.md for payments, advanced-render.md for Skyline. When an error appears, it matches the common error table to identify root causes such as env, permissions, signatures, Worklet declarations, and subpackage paths.

Boundaries

It targets WeChat Mini Programs, especially cloud development, subpackages, Skyline, WXS, and CI/CD. It is not suitable for Douyin/Alipay mini programs, web-side WeChat login, or merchant-backend direct integration that requires server SDKs. Account registration, AppID, merchant account, and cloud environment activation still require manual work; the skill focuses on code structure, configuration, troubleshooting, and engineering checks.