KAppMaker KAppMaker — Config
Configuration lives at ~/.config/kappmaker/config.json. Almost every "command failed" that is
not a store-side error traces back here, so this is also the first stop when a credential error
appears.
The commands
kappmaker config list— show all valueskappmaker config get <key>/set <key> <value>— read / write one valuekappmaker config path— where the file liveskappmaker config init— interactive wizard; also offers App Store and Adapty defaults at the end
Prefer config set per key over config init when driving the CLI for a user — init is fully
interactive and hard to guide through. Keys are prompted inline on first use anyway, so
pre-configuring is optional; a missing key is never a fatal error.
Valid keys: templateRepo, bundleIdPrefix, androidSdkPath, organization, falApiKey,
imgbbApiKey, openaiApiKey, ascAuthName, ascKeyId, ascIssuerId, ascPrivateKeyPath,
appleId, googleServiceAccountPath, revenuecatApiKey, revenuecatProjectId,
iosCertsRepo, iosCertsRepoToken.
Where each key comes from
| Key | Where to get it |
|---|---|
falApiKey |
https://fal.ai/dashboard/keys |
imgbbApiKey |
https://api.imgbb.com (free) |
openaiApiKey |
https://platform.openai.com/api-keys |
ascKeyId + ascIssuerId + ascPrivateKeyPath |
App Store Connect → Users and Access → Integrations → App Store Connect API |
appleId |
The user's Apple ID email |
googleServiceAccountPath |
Google Cloud Console → IAM → Service Accounts → Keys → JSON, then grant access in Play Console → Users and permissions. Used by kappmaker publish --platform android and the entire gpc group. |
revenuecatApiKey |
RevenueCat dashboard → Project settings → API keys → V2 (secret sk_…; v1 keys don't work). Per-project key — this global value is a single-app shortcut. Multi-app accounts: kappmaker revenuecat setup --api-key sk_... saves each app's key into ~/.config/kappmaker/revenuecat-keys.json by bundle ID. |
iosCertsRepo |
Private repo holding Apple signing certificates, shared by every app on ONE Apple Developer account (default <owner>/apple-certificates). Set once by kappmaker ios-ci init. Certificates are account-scoped and Apple allows only 3, so a per-app store locks you out on the fourth app. |
iosCertsRepoToken |
PAT with read access to that repo — the runner's built-in GITHUB_TOKEN cannot reach a second repository. Set once, reused by every app. |
revenuecatProjectId |
Rarely needed — a project-scoped key already identifies its project. Only for unusual account-wide keys that see several. |
Store and provider defaults
Global default product sets, reused by every new app:
kappmaker config appstore-defaults --init— interactive App Store defaults. Re-running backfills credit-pack IAPs missing from pre-1.4 defaults.kappmaker config appstore-defaults --save <file>— save a JSON file as the defaultskappmaker config adapty-defaults --init— Adapty defaults from the built-in template (subs + 3 credit packs + Credits Paywall +credits_packplacement). Re-running backfills whichever ofproducts/paywalls/placementsis empty.kappmaker config adapty-defaults --save <file>— save a JSON file as the defaults
Where this sits in the flow
- Before this: — (this is the zeroth step;
createtriggersconfig inititself if no config exists yet). - After this: any other kappmaker skill — they all read this config.