Validation

Use these tools to verify your MiniApp meets requirements.

CLI

mini-kit doctor         # schema, assets, categories, budgets
mini-kit lint-copy      # banned terms and CTA rules
mini-kit lighthouse     # mobile profile inside webview harness

Manual checks

Test iOS and Android devices
Light and dark themes
3G, Wi‑Fi, offline
Error states, retries, and guest mode flows

CI example (GitHub Actions)

name: Validate MiniApp
on: [push, pull_request]
jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: "18" }
      - run: npm i -g @base/minikit-cli
      - run: mini-kit doctor --strict
      - run: mini-kit lint-copy

Pass criteria

Quality Checklist: all items checked
Budgets: within limits (JS, images, TBT, CLS)
Copy: no banned terms; outcome‑oriented CTAs
Assets: dimensions and byte caps match spec