crt-ship 0.1.0: CLI, Claude Code skills and templates for shipping mobile games to Google Play and the App Store

This commit is contained in:
CRTkafa 2026-10-10 20:29:20 +08:00
commit 3cd31b7601
64 changed files with 4509 additions and 0 deletions

View file

@ -0,0 +1,138 @@
// crt-ship config for one game. Everything game-specific lives here; credentials NEVER do (they go in env vars or
// .crt-ship/credentials.json, which must stay gitignored). Paths are relative to this file.
// The type import is optional: it only works when crt-ship is installed in the project (bun add -d <repo url>).
import type { ShipConfig } from 'crt-ship';
const config: ShipConfig = {
app: {
name: 'Example Game',
copyright: '2026 Example Studio',
privacyPolicyUrl: 'https://example.com/privacy',
supportUrl: 'https://example.com',
marketingUrl: 'https://example.com',
// Developer website on Play: the same domain must serve /app-ads.txt if the game shows ads
website: 'https://example.com',
contactEmail: 'support@example.com',
},
// id = your folder / copy key; play = Play language code(s); apple = App Store Connect locale
languages: [
{ id: 'en', play: 'en-US', apple: 'en-US' },
{ id: 'tr', play: 'tr-TR', apple: 'tr' },
{ id: 'es', play: ['es-ES', 'es-419'], apple: 'es-ES' },
{ id: 'ja', play: 'ja-JP', apple: 'ja' },
{ id: 'ar', play: 'ar', apple: 'ar-SA', rtl: true },
],
play: {
packageName: 'com.example.game',
defaultLanguage: 'en-US',
listing: 'store/listing.md',
icon: 'store/icons/play-512.png',
},
apple: {
bundleId: 'com.example.game',
// appId: '1234567890', // Apple ID of the app record; looked up by bundle id when left out
listing: 'store/appstore.md',
reviewShots: 'store/iap-review',
info: {
categories: { primary: 'GAMES', primarySubOne: 'GAMES_CASUAL', primarySubTwo: 'GAMES_PUZZLE', secondary: 'ENTERTAINMENT' },
ageRating: { advertising: true }, // everything else NONE / false
contentRights: 'DOES_NOT_USE_THIRD_PARTY_CONTENT',
free: true,
reviewNotes: [
'Single-player game. No account or login is needed; there is no user-generated content or chat.',
'In-app purchases: Home > Shop. Restore Purchases is in Settings.',
'Ads: optional rewarded videos and interstitials between rounds. The App Tracking Transparency prompt is shown before the ad SDK starts.',
'Privacy policy: Settings > Privacy.',
].join('\n\n'),
},
},
// Same ids on both stores. Prices: USD base; Play converts per region, Apple equalizes from the USA. Overrides set a
// region by hand (Apple needs an existing price point with exactly that value).
products: [
{
id: 'com.example.game.remove_ads', type: 'non_consumable', usd: 2.99,
overrides: [{ region: 'TR', currency: 'TRY', price: 99.99 }],
listings: {
en: { title: 'Remove Ads', description: 'Removes interstitial ads for good.' },
tr: { title: 'Reklamları Kaldır', description: 'Ara reklamları kalıcı olarak kaldırır.' },
},
reviewScreenshot: 'store/iap-review/shop.png',
},
{
id: 'com.example.game.coins_small', type: 'consumable', usd: 0.99,
listings: {
en: { title: '500 Coins', description: 'A small bag of coins.' },
tr: { title: '500 Altın', description: 'Küçük bir kese altın.' },
},
reviewScreenshot: 'store/iap-review/shop.png',
},
],
// Google Play Data safety. Types not listed = not collected. Purposes: functionality, analytics, communications,
// fraud, advertising, personalization, account. Typical F2P game with an analytics SDK + ad mediation:
dataSafety: {
collectsData: true,
encryptedInTransit: true,
deletionRequest: true, // e.g. "email us"; no accounts, so no account deletion URL needed
accountCreation: ['PSL_ACM_NONE'],
data: {
PSL_APPROX_LOCATION: { shared: true, collect: ['analytics', 'advertising', 'fraud'], share: ['analytics', 'advertising', 'fraud'] },
PSL_USER_INTERACTION: { shared: true, collect: ['analytics', 'advertising'], share: ['analytics', 'advertising'] },
PSL_OTHER_APP_ACTIVITY: { shared: false, collect: ['functionality'] },
PSL_PERFORMANCE_DIAGNOSTICS: { shared: true, collect: ['analytics', 'advertising', 'fraud'], share: ['analytics', 'advertising', 'fraud'] },
PSL_DEVICE_ID: { shared: true, collect: ['functionality', 'analytics', 'advertising', 'fraud'], share: ['analytics', 'advertising', 'fraud'] },
PSL_PURCHASE_HISTORY: { shared: false, collect: ['functionality', 'fraud'] },
},
},
renders: 'store/renders',
shots: {
copy: 'store/shots/copy.json',
frames: 'store/shots/frames', // <lang>/phone/<name>.png, <lang>/tablet/<name>.png
out: 'store/renders',
logo: 'store/shots/logo.png', // optional: hero scene + feature graphic
fonts: { title: 'Lilita One', body: 'Montserrat' },
// phone: { w: 440, h: 902, dpr: 3 }, // raw frame size in CSS px (screen below a 54 px status bar)
scenes: [
{ id: 'hero', palette: 'fire', hero: true, over: 34, frames: [{ src: 'hero.png', rotate: -4 }],
badges: [{ y: 0.42, side: 'l', icon: 'flag', iconBg: 'red', rot: -4 }, { y: 0.66, side: 'r', icon: 'offline', iconBg: 'red', rot: 3 }] },
{ id: 'play', palette: 'violet', frames: [{ src: 'gameplay.png', rotate: 3 }],
badges: [{ y: 0.3, side: 'l', icon: 'bolt', iconBg: 'gold', rot: -3 }, { y: 0.7, side: 'r', hot: true, rot: 4 }] },
{ id: 'levels', palette: 'sky', frames: [{ src: 'level-b.png', scale: 0.82 }, { src: 'level-a.png', x: -31, dy: 10, scale: 0.7, rotate: -8 }, { src: 'level-c.png', x: 31, dy: 10, scale: 0.7, rotate: 8 }],
badges: [{ y: 0.66, side: 'r', icon: 'map', iconBg: 'blue', rot: 3 }] },
{ id: 'stars', palette: 'gold', frames: [{ src: 'results.png', rotate: -3 }],
badges: [{ y: 0.42, side: 'l', stars: true, rot: -3 }] },
],
feature: { frame: 'hero.png', palette: 'fire' },
capture: {
baseUrl: 'http://127.0.0.1:5173',
query: 'lang={lang}&noads=1&seed=1',
shots: {
'hero': { path: '/?level=12', waitFor: "window.game && game.state === 'playing'", delayMs: 1500, device: 'both' },
'gameplay': { path: '/?level=3', delayMs: 2500, device: 'both' },
'level-a': { path: '/?level=20', delayMs: 2000 },
'level-b': { path: '/?level=40', delayMs: 2000 },
'level-c': { path: '/?level=60', delayMs: 2000 },
'results': { path: '/?level=5&result=3', delayMs: 2000, device: 'both' },
},
},
},
icons: {
composite: 'store/icon/icon.png', // 1024 opaque
foreground: 'store/icon/foreground.png', // 1024 RGBA, subject on transparent
background: 'store/icon/background.png', // 1024 opaque
out: 'store/icons',
web: 'public/icons',
// capacitorAssets: 'native/assets',
// capacitorCommand: 'bunx @capacitor/assets generate --assetPath native/assets',
// androidRes: 'native/android/app/src/main/res',
},
};
export default config;