WeChat Mini Program Launch Checklist

A practical release checklist for WeChat Mini Program projects before an experience build, client handoff, or template delivery.

This is written for native Mini Program codebases using `app.json`, WXML, WXSS, and page-level JavaScript. It focuses on mistakes that are easy to miss when a Figma or generated UI has just been converted into a real Mini Program.

30 checks before handoff

App structure

1. Confirm every page path in `app.json` exists on disk.
2. Confirm every tabBar path exists and has the expected page folder.
3. Check navigation titles for placeholder copy, wrong language, or duplicated names.
4. Keep `sitemap.json` aligned with pages that should be searchable.
5. Remove dead demo pages from `app.json` before handoff.

WXML

1. Give repeated blocks stable `wx:key` values instead of relying on indexes.
2. Check that each `bindtap` or `catchtap` handler exists in the page JavaScript.
3. Review image `mode` values so banners, cards, and avatars are not cropped by accident.
4. Add empty states for lists that depend on remote data.
5. Test long product names, city names, user names, and prices in the rendered layout.

WXSS

1. Use `rpx` consistently for Mini Program layout spacing.
2. Add bottom safe-area handling for fixed submit bars and tab-like actions.
3. Check fixed bottom buttons against long pages and scrollable panels.
4. Audit `overflow: hidden` on cards that may contain dynamic text.
5. Keep z-index layers predictable for popups, masks, sticky headers, and bottom bars.

JavaScript

1. Check every `wx.navigateTo`, `wx.redirectTo`, and `wx.switchTab` path.
2. Avoid repeated `setData` calls inside tight loops.
3. Remove development `console.log` calls that expose API responses or user data.
4. Confirm API base URLs and feature flags are not pointing at local development hosts.
5. Test lifecycle re-entry: open page, leave, return, and refresh data only where needed.

Assets

1. Find large images that can be compressed before upload.
2. Remove duplicate exported icons or unused design assets.
3. Keep image filenames stable and descriptive.
4. Check placeholder images for production readiness.
5. Check package size before the experience build is shared.

Handoff evidence

1. Capture screenshots for the core happy path.
2. Capture screenshots for empty, loading, and error states.
3. Record any known risks that are intentionally left for later.
4. Include the tested device sizes and WeChat DevTools version in the handoff notes.
5. Never ask reviewers to share private keys, admin passwords, ID documents, payment credentials, or real user data.

Optional quick review

For a small Mini Program project, I can do a quick review and return a Markdown report with file-level findings and a handoff QA list. A sanitized public repository or reduced sample is enough for an initial review.

Request form:

https://webhook.site/0c9ffdaf-2e41-469c-84dd-4b4167cc8f4e

Related free Chinese checklist:

https://telegra.ph/微信小程序上线前检查清单交付前-30-项自查-06-30