Build a Mini Program

DevDeck can build a WeChat Mini Program, create device preview codes, and—after scan authorization—generate an experience version, submit it for WeChat review, and release it from DevDeck. The production backend is deployed at the same time.

The main path no longer asks you to type an AppID or upload a code-upload private key. After the Mini Program administrator scans and authorizes DevDeck, the Mini Program is bound to the project and the request legal domain is configured for you.

After development authorization, you cannot publish from WeChat

When scanning, grant Mini Program development permission. After that, experience versions, review, and official release all happen in DevDeck. The WeChat Official Accounts Platform will no longer let you upload or release versions yourself.

Before you begin

You need:

• A registered WeChat Mini Program account.
• The Mini Program administrator WeChat account (only the administrator can complete scan authorization).
• Any verification, Mini Program filing, and service category setup WeChat requires for your organization and features.

Login and payment are not finished on this page. After authorization, connect WeChat Pay if you need to collect payments.

Step 1: Create the project

1. On the DevDeck home page, choose Mini Program, describe the app, and create the project.
2. Wait for the initial build to finish.
3. Use the H5 preview first to check pages and basic interactions.

Test WeChat-specific capabilities such as login, payments, and camera access on a real device. Do not rely only on the H5 preview.

Step 2: Scan to authorize

1. In the project, open Preview → Device preview, or the WeChat listing section under Configure → Publish.
2. Select Scan to authorize.
3. Have the Mini Program administrator scan the code and grant Mini Program development permission.
4. Return to DevDeck and confirm the Mini Program name or AppID is shown as authorized.

If authorization is incomplete, scan again and include development permission. After a successful authorization:

• The Mini Program AppID is bound to the current project automatically.
• DevDeck writes https://mp-api.rocksilicon.com to the Mini Program’s request legal domains. You usually do not add this domain yourself.
• Enter only that HTTPS origin. Do not append a project ID, /api, or another path.

Step 3: Preview on a device

After authorization, Preview → Device preview can:

• Generate a preview version for a short-lived device check.
• Generate an experience version to submit the current code as the experience build for fuller device testing.

Scan with a WeChat account that already has access to the Mini Program. Preview codes expire quickly; generate another after one expires.

Step 4: Publish from DevDeck

After you finish changes and device testing:

1. Open Configure → Publish.
2. Review publish readiness and resolve every blocker.
3. Select Publish Project to generate the experience version and deploy the production backend.
4. Open Publish logs if you need to confirm the result.

A successful publish makes the current code the Mini Program’s experience version and deploys the matching production backend. It is not yet live to all WeChat users.

Before review, DevDeck may ask you to complete:

• Mini Program filing (ICP)
• An available service category
• Privacy protection guidelines (contact details, notice method, and API usage can be filled in DevDeck)
• Nickname, avatar, or introduction

Filing, categories, and account profile still happen on the WeChat Official Accounts Platform. Privacy guidelines can be configured in DevDeck.

Step 5: Submit for review and release

When the experience version is ready and account checks pass, stay in DevDeck’s publish panel:

1. Select Submit for review and confirm.
2. Wait for WeChat’s review. You can withdraw a submission while it is in review.
3. If it is rejected, fix the reason in DevDeck, publish a new experience version, and submit again.
4. After approval, select Release.

Later code or backend changes must be published from DevDeck and submitted for review again. Editing the DevDeck project alone does not update the live WeChat version.

Login and payment

Scan authorization is not the same as connecting login or payment:

• WeChat Login is connected automatically after a successful authorization. You do not enter an AppSecret.
• WeChat Pay still requires ordinary-merchant credentials under Connections. See WeChat Pay.

Troubleshooting

You cannot generate an experience version or publish after authorizing

Confirm that Mini Program development permission was granted during the scan. If authorization is incomplete, disconnect and authorize again.

The device page opens, but API requests fail

After authorization, the request legal domain https://mp-api.rocksilicon.com should be written automatically. If requests still fail, check the publish panel for server domain not ready and refresh the account checks. Do not use the WeChat developer tool option to ignore domain validation as proof that a release build will work.

You cannot submit for review

Check blockers in the publish panel: filing, category, privacy guidelines, or account profile. Complete them, then Recheck.

The preview code expired

Return to Preview → Device preview and generate a new code. An expired preview code does not remove an experience version.

DevDeck does not allow publishing

Open Configure → Publish and review the readiness checks. Wait for active builds to finish and resolve incomplete frontend, backend, or runtime configuration.

Fallback: code upload private key

If Open Platform scan authorization is not enabled in the current environment, DevDeck may still ask you to bind an AppID and a code-upload private key. This is a compatibility path, not the recommended flow:

1. In the WeChat Official Accounts Platform, open Management → Development Management → Development Settings → Mini Program Code Upload, download the code-upload private key, and turn off IP allowlist protection.
2. In DevDeck, open Device preview → Configure my Mini Program, enter the AppID, and upload the key.
3. Add https://mp-api.rocksilicon.com yourself under request legal domains.
4. DevDeck will only upload a development version and deploy the backend. Experience version, review, and official release still happen on the WeChat Official Accounts Platform.

Protect the code-upload key. It can preview and upload Mini Program code. Keep the original file secure and never share it in chat or a public link.