codz-cli 0.1.0 → 0.1.3

package/README.md

@@ -2,7 +2,7 @@
 
 A project-aware CLI that learns how your project is built, then makes the same structural change the same way every time. It runs offline, never uploads code, shows a diff before writing anything, and can undo every change.
 
-Adapters for **Next.js**, **Flutter**, **React Native** and **Android (Kotlin)**: new projects (`codz create`), API endpoints (add, import, update, rename, remove), screens and forms, routes, mocks, tests, locales, theme values and project health checks, all with a diff first, `--plan`/`apply`, `undo` and `--json`. MIT licensed.
+Adapters for **Next.js**, **React (Vite)**, **Flutter**, **React Native**, **Android (Kotlin)** and **iOS (SwiftUI)**: new projects (`codz create`, opening on a demo screen in the architecture you pick), API endpoints (add, import, update, rename, remove), screens and forms, routes, mocks, tests, locales, theme values and project health checks, all with a diff first, `--plan`/`apply`, `undo` and `--json`. MIT licensed.
 
 ## Requirements
 
@@ -75,9 +75,11 @@ codz create shop-app --type android --architecture retrofit-hilt --org com.acme
 codz create shop-app --type react-native --flavor expo --architecture axios-react-query
 codz create shop_app --type flutter --architecture riverpod --primary "#0F766E"
 codz create shop-app --type nextjs --architecture fetch-helper --tailwind --dry-run
+codz create shop-web --type react --architecture axios-react-query
+codz create shop-app --type ios --architecture urlsession --org com.acme
 ```
 
-`create` asks for the project type (Flutter, Next.js, React Native, Android), then the architecture for that type, the project name, the organization id (for app ids and packages), the API base URL and the type's own options (Tailwind for Next.js, Expo or the React Native CLI). It runs the platform's own creator (`flutter create`, `create-next-app`, `create-expo-app`, the React Native CLI), applies the architecture with the same `setup` as below, writes `codz.config.yaml`, sets the theme color, installs dependencies and makes the first git commit. Without the platform tool, or with `--offline`, codz writes a minimal project of its own instead. Android has no command-line creator, so codz always writes Android Studio's Empty Activity project itself (Kotlin, Jetpack Compose, a version catalog, Navigation Compose with a Home screen) and adds the Gradle wrapper when Gradle is installed. `--dry-run` lists the steps; `--no-install` and `--no-git` skip those steps.
+`create` asks for the project type (Flutter, Next.js, React (Vite), React Native, Android, iOS), then the architecture for that type, the project name, the organization id (for app ids and packages), the API base URL and the type's own options (Tailwind for Next.js, Expo or the React Native CLI). It runs the platform's own creator (`flutter create`, `create-next-app`, `create-expo-app`, the React Native CLI), applies the architecture with the same `setup` as below, writes `codz.config.yaml`, sets the theme color, installs dependencies and makes the first git commit. Without the platform tool, or with `--offline`, codz writes a minimal project of its own instead. Android has no command-line creator, so codz always writes Android Studio's Empty Activity project itself (Kotlin, Jetpack Compose, a version catalog, Navigation Compose with a Home screen) and adds the Gradle wrapper. React (Vite) and iOS also use built-in templates: Vite's react-ts project, and Xcode 16's SwiftUI App project (a synchronized source folder, so files codz adds are part of the app without editing the project file). Every project opens on a demo task list written in the chosen architecture (a Riverpod notifier, a GetX module, a Cubit, a Hilt or Koin ViewModel, a TanStack Query hook, an ObservableObject...), on sample data, so you start from a working example of the pattern; `codz feature add` and `codz api add` replace the sample data with your API. `--dry-run` lists the steps; `--no-install` and `--no-git` skip those steps.
 
 | Type | Architectures |
 | --- | --- |

package/dist/core/commands.js

@@ -77,7 +77,7 @@ export const FLAGS = {
     // setup / init
     architecture: { value: '<id>', desc: 'Flutter: getx, riverpod, bloc, get_it. Next.js: fetch-helper, plain-fetch. React Native and React: fetch-helper, axios, axios-react-query. Android: retrofit-hilt, retrofit-koin, retrofit. iOS: urlsession' },
     // create
-    type: { value: '<type>', desc: 'Project type: flutter, nextjs, react-native, android', choices: ['flutter', 'nextjs', 'react-native', 'android'] },
+    type: { value: '<type>', desc: 'Project type: flutter, nextjs, react, react-native, android, ios', choices: ['flutter', 'nextjs', 'react', 'react-native', 'android', 'ios'] },
     flavor: { value: '<expo|bare>', desc: 'React Native: Expo (default) or the React Native CLI', choices: ['expo', 'bare'] },
     org: { value: '<com.example>', desc: 'Organization in reverse-domain form, for app ids (default com.example)' },
     tailwind: { desc: 'Next.js: use Tailwind CSS' },
@@ -112,7 +112,7 @@ export const FLAGS = {
 export const GLOBAL_FLAGS = ['json', 'cwd', 'root', 'no-color', 'help', 'h', 'version', 'v'];
 export const CHANGE_FLAGS = ['dry-run', 'plan', 'yes', 'y', 'allow-dirty', 'no-format', 'no-verify', 'commit', 'commit-message', 'open'];
 export const COMMAND_LIST = [
-    { group: 'Start', cmd: 'create', usage: '[name] [--type <type>] [--architecture <id>]', summary: 'Create a new project and set it up: pick the type, architecture, name and options, then codz runs the platform creator and applies the architecture', flags: ['type', 'architecture', 'base-url', 'org', 'tailwind', 'flavor', 'primary', 'offline', 'no-install', 'no-git', 'dry-run', 'yes', 'y'], notes: ['Asks for anything not given as an option. Architectures: Flutter riverpod, getx, bloc, get_it, none; Next.js fetch-helper, plain-fetch, none; React Native fetch-helper, axios-react-query, axios, none (--flavor expo or bare); Android retrofit-hilt, retrofit-koin, retrofit, none (Kotlin, Jetpack Compose, version catalog). Without the platform creator (flutter, npx) or with --offline, codz writes a minimal project itself; Android always uses the built-in template (the Android Studio Empty Activity project plus Navigation Compose).'] },
+    { group: 'Start', cmd: 'create', usage: '[name] [--type <type>] [--architecture <id>]', summary: 'Create a new project and set it up: pick the type, architecture, name and options, then codz runs the platform creator and applies the architecture', flags: ['type', 'architecture', 'base-url', 'org', 'tailwind', 'flavor', 'primary', 'offline', 'no-install', 'no-git', 'dry-run', 'yes', 'y'], notes: ['Asks for anything not given as an option. Architectures: Flutter riverpod, getx, bloc, get_it, none; Next.js fetch-helper, plain-fetch, none; React Native fetch-helper, axios-react-query, axios, none (--flavor expo or bare); Android retrofit-hilt, retrofit-koin, retrofit, none (Kotlin, Jetpack Compose, version catalog); React (Vite) fetch-helper, axios, axios-react-query, none; iOS urlsession, none (SwiftUI, Xcode 16 project). The app opens on a demo screen written in the chosen architecture, on sample data. Without the platform creator (flutter, npx) or with --offline, codz writes a minimal project itself; Android, React (Vite) and iOS always use the built-in templates.'] },
     { group: 'Start', cmd: 'init', usage: '[--root <folder>] [--force]', summary: 'Detect the framework, scan, write codz.config.yaml; offers to set up an API layer when there is none', flags: ['force', 'architecture', 'base-url', 'yes', 'y'] },
     { group: 'Start', cmd: 'setup', usage: '[--architecture <id>] [--base-url <url>]', summary: 'Create the API layer for a fresh project', flags: ['architecture', 'base-url'], change: true },
     { group: 'Start', cmd: 'explain', usage: '[--rescan]', summary: 'Show routes, endpoints, models, locales and conventions', flags: ['rescan'] },

package/dist/skills/create.js

@@ -13,11 +13,12 @@ import { existsSync, mkdirSync, readdirSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { addGradleWrapper, androidPackage, androidSkeleton } from "./androidSkeleton.js";
 import { ADAPTERS } from "../adapters/index.js";
-import { applyChangeSet } from "../core/changeset.js";
+import { applyChangeSet, buildChangeSet } from "../core/changeset.js";
 import { ToolError } from "../core/types.js";
 import { DART_RESERVED } from "../input/naming.js";
 import { detectProject, initFiles, writeInitFiles } from "./init.js";
 import { planSetup } from "./setup.js";
+import { planDemo } from "./createDemo.js";
 import { planThemeSet } from "./theme.js";
 import { runTool, toolMissing } from "../core/proc.js";
 const NONE = { id: 'none', label: 'None', description: 'No API layer yet; set one up later with codz setup' };
@@ -139,6 +140,234 @@ function reactNativeSkeleton(o) {
     }
     return files;
 }
+/** React web app with Vite and TypeScript (what npm create vite gives you, react-ts template). */
+function reactSkeleton(o) {
+    const files = new Map();
+    const title = o.name.split(/[-_.]/).filter(Boolean).map((w) => w[0].toUpperCase() + w.slice(1)).join(' ');
+    files.set('package.json', JSON.stringify({
+        name: o.name,
+        private: true,
+        version: '0.0.0',
+        type: 'module',
+        scripts: { dev: 'vite', build: 'tsc -b && vite build', preview: 'vite preview', test: 'vitest run' },
+        dependencies: { react: '^18.3.1', 'react-dom': '^18.3.1' },
+        devDependencies: { '@types/react': '^18.3.12', '@types/react-dom': '^18.3.1', '@vitejs/plugin-react': '^4.3.4', typescript: '~5.6.2', vite: '^6.0.1', vitest: '^2.1.8' },
+    }, null, 2) + '\n');
+    files.set('index.html', `<!doctype html>\n<html lang="en">\n  <head>\n    <meta charset="UTF-8" />\n    <meta name="viewport" content="width=device-width, initial-scale=1.0" />\n    <title>${title}</title>\n  </head>\n  <body>\n    <div id="root"></div>\n    <script type="module" src="/src/main.tsx"></script>\n  </body>\n</html>\n`);
+    files.set('vite.config.ts', `import { defineConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\n\nexport default defineConfig({\n  plugins: [react()],\n})\n`);
+    files.set('tsconfig.json', JSON.stringify({ compilerOptions: { target: 'ES2020', lib: ['ES2020', 'DOM', 'DOM.Iterable'], module: 'ESNext', moduleResolution: 'bundler', jsx: 'react-jsx', strict: true, noEmit: true, allowImportingTsExtensions: true, skipLibCheck: true, isolatedModules: true }, include: ['src'] }, null, 2) + '\n');
+    files.set('src/vite-env.d.ts', '/// <reference types="vite/client" />\n');
+    files.set('src/main.tsx', `import { StrictMode } from 'react'\nimport { createRoot } from 'react-dom/client'\nimport App from './App.tsx'\n\ncreateRoot(document.getElementById('root')!).render(\n  <StrictMode>\n    <App />\n  </StrictMode>,\n)\n`);
+    files.set('src/App.tsx', `function App() {\n  return (\n    <main>\n      <h1>${title}</h1>\n    </main>\n  )\n}\n\nexport default App\n`);
+    files.set('.gitignore', 'node_modules\ndist\n*.local\n.codz/\n');
+    return files;
+}
+/** The Swift name of an iOS app: shop-app → ShopApp. */
+export const iosAppName = (name) => name.split(/[-_]/).filter(Boolean).map((w) => w[0].toUpperCase() + w.slice(1)).join('');
+/**
+ * A SwiftUI app as Xcode 16's App template makes it: one target whose sources
+ * are a synchronized folder (new files are part of the app without editing the
+ * project file), an asset catalog, and a generated Info.plist.
+ */
+function iosSkeleton(o) {
+    const app = iosAppName(o.name);
+    const bundle = `${o.org}.${o.name.replace(/[^a-zA-Z0-9]/g, '')}`;
+    const files = new Map();
+    // Object ids: 24 hex digits, fixed so a project made twice is the same.
+    const id = (n) => `C0DE${String(n).padStart(20, '0')}`;
+    const [project, mainGroup, productsGroup, appGroup, target, product, sources, frameworks, resources, projectList, targetList, projDebug, projRelease, targetDebug, targetRelease] = Array.from({ length: 15 }, (_, i) => id(i + 1));
+    const common = [
+        'ALWAYS_SEARCH_USER_PATHS = NO;',
+        'ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;',
+        'CLANG_ENABLE_MODULES = YES;',
+        'CLANG_ENABLE_OBJC_ARC = YES;',
+        'COPY_PHASE_STRIP = NO;',
+        'ENABLE_STRICT_OBJC_MSGSEND = YES;',
+        'ENABLE_USER_SCRIPT_SANDBOXING = YES;',
+        'GCC_C_LANGUAGE_STANDARD = gnu17;',
+        'IPHONEOS_DEPLOYMENT_TARGET = 17.0;',
+        'LOCALIZATION_PREFERS_STRING_CATALOGS = YES;',
+        'SDKROOT = iphoneos;',
+    ];
+    const projSettings = (debug) => [
+        ...common,
+        ...(debug
+            ? ['DEBUG_INFORMATION_FORMAT = dwarf;', 'ENABLE_TESTABILITY = YES;', 'GCC_OPTIMIZATION_LEVEL = 0;', 'ONLY_ACTIVE_ARCH = YES;', 'SWIFT_ACTIVE_COMPILATION_CONDITIONS = "DEBUG $(inherited)";', 'SWIFT_OPTIMIZATION_LEVEL = "-Onone";', 'MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;']
+            : ['DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";', 'ENABLE_NS_ASSERTIONS = NO;', 'SWIFT_COMPILATION_MODE = wholemodule;', 'VALIDATE_PRODUCT = YES;', 'MTL_ENABLE_DEBUG_INFO = NO;']),
+    ];
+    const targetSettings = [
+        'ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;',
+        'ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;',
+        'CODE_SIGN_STYLE = Automatic;',
+        'CURRENT_PROJECT_VERSION = 1;',
+        'ENABLE_PREVIEWS = YES;',
+        'GENERATE_INFOPLIST_FILE = YES;',
+        `INFOPLIST_KEY_CFBundleDisplayName = ${app};`,
+        'INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;',
+        'INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;',
+        'INFOPLIST_KEY_UILaunchScreen_Generation = YES;',
+        'INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";',
+        'INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";',
+        'LD_RUNPATH_SEARCH_PATHS = (\n\t\t\t\t\t"$(inherited)",\n\t\t\t\t\t"@executable_path/Frameworks",\n\t\t\t\t);',
+        'MARKETING_VERSION = 1.0;',
+        `PRODUCT_BUNDLE_IDENTIFIER = ${bundle};`,
+        'PRODUCT_NAME = "$(TARGET_NAME)";',
+        'SWIFT_EMIT_LOC_STRINGS = YES;',
+        'SWIFT_VERSION = 5.0;',
+        'TARGETED_DEVICE_FAMILY = "1,2";',
+    ];
+    const config = (key, name, settings) => [`\t\t${key} /* ${name} */ = {`, '\t\t\tisa = XCBuildConfiguration;', '\t\t\tbuildSettings = {', ...settings.map((x) => `\t\t\t\t${x}`), '\t\t\t};', `\t\t\tname = ${name};`, '\t\t};'];
+    const phase = (key, isa, name) => [`\t\t${key} /* ${name} */ = {`, `\t\t\tisa = ${isa};`, '\t\t\tbuildActionMask = 2147483647;', '\t\t\tfiles = (', '\t\t\t);', '\t\t\trunOnlyForDeploymentPostprocessing = 0;', '\t\t};'];
+    const pbx = [
+        '// !$*UTF8*$!',
+        '{',
+        '\tarchiveVersion = 1;',
+        '\tclasses = {',
+        '\t};',
+        '\tobjectVersion = 77;',
+        '\tobjects = {',
+        '',
+        '/* Begin PBXFileReference section */',
+        `\t\t${product} /* ${app}.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = ${app}.app; sourceTree = BUILT_PRODUCTS_DIR; };`,
+        '/* End PBXFileReference section */',
+        '',
+        '/* Begin PBXFileSystemSynchronizedRootGroup section */',
+        `\t\t${appGroup} /* ${app} */ = {`,
+        '\t\t\tisa = PBXFileSystemSynchronizedRootGroup;',
+        `\t\t\tpath = ${app};`,
+        '\t\t\tsourceTree = "<group>";',
+        '\t\t};',
+        '/* End PBXFileSystemSynchronizedRootGroup section */',
+        '',
+        '/* Begin PBXFrameworksBuildPhase section */',
+        ...phase(frameworks, 'PBXFrameworksBuildPhase', 'Frameworks'),
+        '/* End PBXFrameworksBuildPhase section */',
+        '',
+        '/* Begin PBXGroup section */',
+        `\t\t${mainGroup} = {`,
+        '\t\t\tisa = PBXGroup;',
+        '\t\t\tchildren = (',
+        `\t\t\t\t${appGroup} /* ${app} */,`,
+        `\t\t\t\t${productsGroup} /* Products */,`,
+        '\t\t\t);',
+        '\t\t\tsourceTree = "<group>";',
+        '\t\t};',
+        `\t\t${productsGroup} /* Products */ = {`,
+        '\t\t\tisa = PBXGroup;',
+        '\t\t\tchildren = (',
+        `\t\t\t\t${product} /* ${app}.app */,`,
+        '\t\t\t);',
+        '\t\t\tname = Products;',
+        '\t\t\tsourceTree = "<group>";',
+        '\t\t};',
+        '/* End PBXGroup section */',
+        '',
+        '/* Begin PBXNativeTarget section */',
+        `\t\t${target} /* ${app} */ = {`,
+        '\t\t\tisa = PBXNativeTarget;',
+        `\t\t\tbuildConfigurationList = ${targetList} /* Build configuration list for PBXNativeTarget "${app}" */;`,
+        '\t\t\tbuildPhases = (',
+        `\t\t\t\t${sources} /* Sources */,`,
+        `\t\t\t\t${frameworks} /* Frameworks */,`,
+        `\t\t\t\t${resources} /* Resources */,`,
+        '\t\t\t);',
+        '\t\t\tbuildRules = (',
+        '\t\t\t);',
+        '\t\t\tdependencies = (',
+        '\t\t\t);',
+        '\t\t\tfileSystemSynchronizedGroups = (',
+        `\t\t\t\t${appGroup} /* ${app} */,`,
+        '\t\t\t);',
+        `\t\t\tname = ${app};`,
+        '\t\t\tpackageProductDependencies = (',
+        '\t\t\t);',
+        `\t\t\tproductName = ${app};`,
+        `\t\t\tproductReference = ${product} /* ${app}.app */;`,
+        '\t\t\tproductType = "com.apple.product-type.application";',
+        '\t\t};',
+        '/* End PBXNativeTarget section */',
+        '',
+        '/* Begin PBXProject section */',
+        `\t\t${project} /* Project object */ = {`,
+        '\t\t\tisa = PBXProject;',
+        '\t\t\tattributes = {',
+        '\t\t\t\tBuildIndependentTargetsInParallel = 1;',
+        '\t\t\t\tLastSwiftUpdateCheck = 1600;',
+        '\t\t\t\tLastUpgradeCheck = 1600;',
+        '\t\t\t\tTargetAttributes = {',
+        `\t\t\t\t\t${target} = {`,
+        '\t\t\t\t\t\tCreatedOnToolsVersion = 16.0;',
+        '\t\t\t\t\t};',
+        '\t\t\t\t};',
+        '\t\t\t};',
+        `\t\t\tbuildConfigurationList = ${projectList} /* Build configuration list for PBXProject "${app}" */;`,
+        '\t\t\tdevelopmentRegion = en;',
+        '\t\t\thasScannedForEncodings = 0;',
+        '\t\t\tknownRegions = (',
+        '\t\t\t\ten,',
+        '\t\t\t\tBase,',
+        '\t\t\t);',
+        `\t\t\tmainGroup = ${mainGroup};`,
+        '\t\t\tminimizedProjectReferenceProxies = 1;',
+        '\t\t\tpreferredProjectObjectVersion = 77;',
+        `\t\t\tproductRefGroup = ${productsGroup} /* Products */;`,
+        '\t\t\tprojectDirPath = "";',
+        '\t\t\tprojectRoot = "";',
+        '\t\t\ttargets = (',
+        `\t\t\t\t${target} /* ${app} */,`,
+        '\t\t\t);',
+        '\t\t};',
+        '/* End PBXProject section */',
+        '',
+        '/* Begin PBXResourcesBuildPhase section */',
+        ...phase(resources, 'PBXResourcesBuildPhase', 'Resources'),
+        '/* End PBXResourcesBuildPhase section */',
+        '',
+        '/* Begin PBXSourcesBuildPhase section */',
+        ...phase(sources, 'PBXSourcesBuildPhase', 'Sources'),
+        '/* End PBXSourcesBuildPhase section */',
+        '',
+        '/* Begin XCBuildConfiguration section */',
+        ...config(projDebug, 'Debug', projSettings(true)),
+        ...config(projRelease, 'Release', projSettings(false)),
+        ...config(targetDebug, 'Debug', targetSettings),
+        ...config(targetRelease, 'Release', targetSettings),
+        '/* End XCBuildConfiguration section */',
+        '',
+        '/* Begin XCConfigurationList section */',
+        `\t\t${projectList} /* Build configuration list for PBXProject "${app}" */ = {`,
+        '\t\t\tisa = XCConfigurationList;',
+        '\t\t\tbuildConfigurations = (',
+        `\t\t\t\t${projDebug} /* Debug */,`,
+        `\t\t\t\t${projRelease} /* Release */,`,
+        '\t\t\t);',
+        '\t\t\tdefaultConfigurationIsVisible = 0;',
+        '\t\t\tdefaultConfigurationName = Release;',
+        '\t\t};',
+        `\t\t${targetList} /* Build configuration list for PBXNativeTarget "${app}" */ = {`,
+        '\t\t\tisa = XCConfigurationList;',
+        '\t\t\tbuildConfigurations = (',
+        `\t\t\t\t${targetDebug} /* Debug */,`,
+        `\t\t\t\t${targetRelease} /* Release */,`,
+        '\t\t\t);',
+        '\t\t\tdefaultConfigurationIsVisible = 0;',
+        '\t\t\tdefaultConfigurationName = Release;',
+        '\t\t};',
+        '/* End XCConfigurationList section */',
+        '\t};',
+        `\trootObject = ${project} /* Project object */;`,
+        '}',
+        '',
+    ].join('\n');
+    files.set(`${app}.xcodeproj/project.pbxproj`, pbx);
+    files.set(`${app}/${app}App.swift`, `import SwiftUI\n\n@main\nstruct ${app}App: App {\n    var body: some Scene {\n        WindowGroup {\n            ContentView()\n        }\n    }\n}\n`);
+    files.set(`${app}/ContentView.swift`, `import SwiftUI\n\nstruct ContentView: View {\n    var body: some View {\n        Text("${app}")\n            .padding()\n    }\n}\n\n#Preview {\n    ContentView()\n}\n`);
+    files.set(`${app}/Assets.xcassets/Contents.json`, '{\n  "info" : {\n    "author" : "xcode",\n    "version" : 1\n  }\n}\n');
+    files.set(`${app}/Assets.xcassets/AccentColor.colorset/Contents.json`, '{\n  "colors" : [\n    {\n      "idiom" : "universal"\n    }\n  ],\n  "info" : {\n    "author" : "xcode",\n    "version" : 1\n  }\n}\n');
+    files.set(`${app}/Assets.xcassets/AppIcon.appiconset/Contents.json`, '{\n  "images" : [\n    {\n      "idiom" : "universal",\n      "platform" : "ios",\n      "size" : "1024x1024"\n    }\n  ],\n  "info" : {\n    "author" : "xcode",\n    "version" : 1\n  }\n}\n');
+    files.set('.gitignore', 'xcuserdata/\nDerivedData/\n.DS_Store\n.codz/\n');
+    return files;
+}
 const npmName = (name) => (/^[a-z0-9][a-z0-9._-]*$/.test(name) && name.length <= 214 ? null : 'Use lowercase letters, digits, dots, dashes and underscores, starting with a letter or digit (for example my-app).');
 export const PROJECT_TYPES = [
     {
@@ -220,6 +449,42 @@ export const PROJECT_TYPES = [
         install: () => null,
         framework: 'android',
     },
+    {
+        id: 'react',
+        label: 'React (Vite)',
+        description: 'React web app with Vite, TypeScript and React Router',
+        architectures: [
+            { id: 'fetch-helper', label: 'Fetch helper', description: 'src/api/client.ts with apiFetch<T>() and ApiError; API URL in src/config/env.ts' },
+            { id: 'axios', label: 'axios', description: 'An axios instance in src/api/client.ts; API functions call it' },
+            { id: 'axios-react-query', label: 'axios + TanStack Query', description: 'The axios instance, a query hook per endpoint, QueryClientProvider around the app' },
+            { ...NONE, label: 'Plain React', description: 'No API layer or router yet; add one later with codz setup' },
+        ],
+        checkName: npmName,
+        needsOrg: false,
+        options: [],
+        // codz writes the react-ts template itself (npm create vite asks questions in some versions).
+        creator: () => null,
+        skeleton: reactSkeleton,
+        install: () => ({ cmd: process.platform === 'win32' ? 'npm.cmd' : 'npm', args: ['install'], label: 'npm install' }),
+        framework: 'react',
+    },
+    {
+        id: 'ios',
+        label: 'iOS (SwiftUI)',
+        description: 'Native iPhone and iPad app in Swift with SwiftUI (open it in Xcode 16 or newer)',
+        architectures: [
+            { id: 'urlsession', label: 'URLSession + async/await', description: 'APIClient with send<T>() over URLSession and JSONDecoder; ObservableObject view models' },
+            { ...NONE, label: 'Plain SwiftUI', description: 'No API layer yet; add one later with codz setup' },
+        ],
+        checkName: (n) => (/^[a-z][a-z0-9-]*$/.test(n) ? null : 'Use lowercase letters, digits and dashes, starting with a letter (for example shop-app); the app is then called ShopApp.'),
+        needsOrg: true,
+        options: [],
+        // Xcode has no command-line project creator; codz writes the App template itself.
+        creator: () => null,
+        skeleton: iosSkeleton,
+        install: () => null,
+        framework: 'ios',
+    },
 ];
 export function projectType(id) {
     const t = PROJECT_TYPES.find((x) => x.id === id);
@@ -317,6 +582,21 @@ export async function createProject(o, log = () => { }) {
         writeInitFiles(dir, initFiles(dir, adapter, d.map.conventions), false);
     }
     steps.push('Wrote codz.config.yaml');
+    // 2b. The first screen: a demo in the architecture just set up, instead of the template's counter.
+    if (o.architecture !== 'none') {
+        if (t.id === 'flutter' && o.architecture === 'getx') {
+            // The GetX module (binding, controller, view and its route) comes from module add.
+            const { planModuleAdd } = await import("./module.js");
+            const mod = await planModuleAdd(dir, adapter, { name: 'home', initial: true });
+            applyChangeSet(dir, mod, { allowDirty: true, verify: false, format: false, adapter });
+        }
+        const demo = planDemo({ dir, type: t.id, architecture: o.architecture, name: o.name, androidPackage: t.id === 'android' ? androidPackage(o.org, o.name) : undefined, iosApp: t.id === 'ios' ? iosAppName(o.name) : undefined });
+        if (demo) {
+            const cs = buildChangeSet(dir, 'create', { files: demo.files, summary: demo.summary, warnings: [], generated: [], rewrites: demo.rewrites, ...(demo.deletes ? { deletes: new Set(demo.deletes) } : {}) });
+            applyChangeSet(dir, cs, { allowDirty: true, verify: false, format: false, adapter });
+            steps.push(...demo.summary);
+        }
+    }
     // 3. Theme.
     if (o.primary && t.id === 'android')
         steps.push(`Theme: primary color ${o.primary}`);