KasyKasy

CLI Commands

Full reference for the kasy commands.

Creation and running

CommandDescription
kasy preparePrepares your machine: installs and signs in only what the chosen backend needs
kasy prepare --backend supabaseSupabase CLI + login only (no Firebase/gcloud). Use firebase, api, or all as needed
kasy newCreates a new app (asks for backend, features, credentials)
kasy new --lang enCreates the app in English (also saves CLI language)
kasy new --backend firebase --with revenuecat,sentrySkips prompts with flags
kasy new --configure-laterQuick + skip connecting Firebase/Supabase now (app runs in preview mode; run kasy backend later)
kasy backendConnects the real Firebase/Supabase project for an app created with configure later (same setup as kasy new, without recreating the folder)
kasy setupAlias for kasy new
kasy runRuns with full credentials (recommended)
kasy run --iosiOS simulator
kasy run --androidAndroid emulator
kasy run --webWeb at localhost:5555
kasy run --web --open-browserOpens in the default browser when Flutter is ready
kasy run --web --open-browser --freshDefault browser + clears dev storage (localStorage, sessionStorage, IndexedDB)
kasy run --web --openWeb in an isolated Flutter Chrome window
kasy clear-webClears localhost dev storage (web app must be running)
kasy run --prodProduction config
kasy run --rawRaw output, no spinner
kasy resetUninstalls and reinstalls (tests the first open)
kasy reset --webClears web storage in the default browser
kasy reset --ios / --androidSpecific device
kasy reset --no-reinstallOnly uninstalls

Features

CommandDescription
kasy add <feature>Turns on a feature (e.g., revenuecat, ads, ai_chat)
kasy add --listLists features and which ones are on
kasy remove <feature>Removes a feature and undoes all its changes
kasy remove <feature> --yesRemoves it without confirming
kasy updateShows features with updates available
kasy update <feature>Updates a specific feature
kasy update backendSyncs missing SQL migrations/Edge Functions (Supabase) or Cloud Functions/firestore.rules (Firebase)
kasy update webUpdates the kit scripts in web/index.html (storage clearing, pre-boot theme, iOS Safari height) without touching your title/favicon/splash
kasy featuresLists available backends and features
kasy kanban listReads the project Kanban (Firebase/Supabase); mostly used by AI through MCP
kasy kanban create-task --title "..." --column-id <id>Creates a board task without opening the app

Deploy and diagnostics

CommandFirebaseSupabaseREST API
kasy deployUploads Functions + Firestore rules + Storage rulesUploads Edge Functions + migrations + secretsDoesn't apply (you deploy your own server)
kasy checkValidates secrets + APNs Key + IAMValidates secrets + Edge Functions + JWTValidates local config only
kasy check --fixTries to fix automaticallyTries to fix automaticallyNo effect (no remote server)
kasy doctorChecks environment, dependencies, and project state (all backends)
kasy statusProject summary: backend, active features, pending credentials
kasy validateValidates backend/feature combinations (all backends)

Configuration and versioning

CommandDescription
kasy configureConfigures the App Store ID and other project credentials
kasy configure --statusLists pending credentials only (no wizard)
kasy configure --set SENTRY_DSN=https://... --set RC_TEST_KEY=test_... --yesFills credentials without the wizard (repeatable; MCP)
kasy fix pub-getRuns flutter pub get
kasy fix podsRuns pod install on iOS (Mac)
kasy fix cleanClears Flutter/Xcode cache + flutter clean
kasy release-versionUpdates app_latest_version in Firebase Remote Config
kasy release-version -v 1.4.0Direct version
kasy release-version -v 1.4.0 -f --yesMandatory, no confirmation (CI)
kasy apple-webConfigures Apple login on the web (Firebase or Supabase)
kasy facebookConfigures Facebook login (native + backend)
kasy notifications textEdits the project's local notification texts
kasy docsShows the documentation in the terminal

Visual customization

CommandDescription
kasy icon --image <path.png>Changes the app icon (iOS + Android) and regenerates assets
kasy colorChanges brand primary color in colors.dart
kasy splash --light <path.png> --dark <path.png>Changes the splash logos (light + dark mode) and regenerates assets
kasy favicon --image <path.png>Changes the web favicon and PWA icon

Publishing: iOS (Mac)

CommandDescription
kasy ios configureWizard: Apple's Key ID, Issuer ID, .p8 (once)
kasy ios configure --api-key ... --issuer-id ... --p8 <path>Same, without the wizard (MCP)
kasy ios releaseBumps the build + generates the IPA + sends it to App Store Connect
kasy ios buildOnly generates the IPA (doesn't send it)
kasy ios cleanCleans the Flutter/Xcode cache after a DerivedData error
kasy ios release --version-name 1.0.2Changes the visible version and bumps the build
kasy ios release --no-bumpDoesn't bump the build (rarely used)

Publishing: Android

CommandDescription
kasy android configureWizard: saves android/key.properties (keystore)
kasy android configure --keystore <path.jks> --store-password ...Same, without the wizard (MCP)
kasy android releaseBuilds release AAB and opens Play Console
kasy android build-aabBuilds AAB only (no console)
kasy android build-apk-signedBuilds a signed release APK (sideloading, alternative stores)
kasy android build-apkBuilds an unsigned debug APK (quick test)

Web domain (Firebase Auth)

CommandDescription
kasy domain listLists Firebase Auth authorized domains
kasy domain add app.yourdomain.comAuthorizes a custom web domain
kasy domain remove app.yourdomain.comRemoves a domain

Publishing: Codemagic (no Mac)

CommandDescription
kasy codemagic configureSaves the token + App ID + branch (once)
kasy codemagic configure --token ... --app-id ...Same, without the wizard (MCP)
kasy codemagic releaseTriggers the iOS + Android build in the cloud
kasy codemagic release --iosiOS only
kasy codemagic release --androidAndroid only
kasy codemagic status <buildId>Checks the build's status

The CLI itself

CommandDescription
kasy version / kasy --versionInstalled version
kasy languageChange CLI language (same picker as first run)
kasy language enSet English without opening the picker
kasy licenseView or change CLI activation key. Rules in Key and activation
kasy license --showShow masked key
kasy mcp setupInstalls kasy-mcp and writes your editor's mcp.json (see MCP)
kasy upgradeUpdates the CLI to the latest version
kasy uninstallUninstalls the CLI
kasy help / kasy --helpHelp

Installing the CLI

npm install -g kasy-cli
# or without installing:
npx kasy-cli new

License

Free (no key): prepare, mcp, run, reset, clear-web, doctor, status, features, fix, configure, splash, icon, favicon, apple-web, facebook, release-version, kanban, version, language, license, help, uninstall

Requires a valid key: new, backend, add, remove, deploy, check, validate, docs, ios, android, codemagic, notifications, color, domain. Once you have had a valid key, these keep working on an already created project even after the plan lapses.

Requires a key and an active plan: new, update, upgrade. Creating a new project and updating depend on a current subscription; what is already built keeps running on its own (Firebase/Supabase), with no CLI involved.

Last updated on 08/23/2026