@appsbyme/create-basekit 1.0.3 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appsbyme/create-basekit",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Scaffold Basekit web, mobile, or full-stack apps",
   "type": "module",
   "bin": "./dist/index.cjs",
@@ -19,10 +19,18 @@
     "prepublishOnly": "yarn build"
   },
   "dependencies": {
-    "@appsbyme/basekit-ai-helpers": "^1.0.1",
     "prompts": "^2.4.2"
   },
+  "peerDependencies": {
+    "@appsbyme/basekit-ai-helpers": "^1.0.1"
+  },
+  "peerDependenciesMeta": {
+    "@appsbyme/basekit-ai-helpers": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@appsbyme/basekit-ai-helpers": "^1.0.1",
     "@appsbyme/basekit-tsconfig": "^1.0.0",
     "@types/node": "^24.0.14",
     "@types/prompts": "^2.4.9",
@@ -50,6 +58,6 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   }
 }

package/template-mobile/README.md

@@ -1,6 +1,6 @@
 # Basekit Expo Starter
 
-Production-ready Expo (React Native) app template with authentication, navigation, and shared cross-platform code. The app expects `packages/shared` to be supplied separately; `create-basekit app` provides it in the Basekit monorepo flow.
+Production-ready Expo (React Native) app template with authentication, navigation, and shared cross-platform code. Shared types live in a sibling `packages/shared` package — `create-basekit app --mobile` creates that package for you; standalone `create-basekit mobile` expects you to provide a compatible `@shared` package (this is not a Django/basekit checkout).
 
 ## Features
 
@@ -19,7 +19,7 @@ Production-ready Expo (React Native) app template with authentication, navigatio
 
 ```
 ├── assets/                  # App icons and splash screen
-├── ../packages/shared/      # Required sibling package supplied by the orchestrator
+├── ../packages/shared/      # Shared types/schemas (from app --mobile, or your own)
 ├── src/
 │   ├── App.tsx              # Root component with providers
 │   ├── components/          # Shared UI components

package/template-mobile/_yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

package/template-mobile/src/__mocks__/expo-env.ts

@@ -1 +1,2 @@
-export default {};
+export const env: Record<string, string | undefined> = {};
+export default env;

package/template-mobile/src/features/auth/api/auth.api.ts

@@ -11,7 +11,7 @@ import {
 import type { User, LoginResponse, RegisterResponse } from '@shared/types/user';
 import type { LoginInput, RegisterBaseInput, ForgotPasswordInput, ChangePasswordInput } from '@shared/schemas/auth.schema';
 
-const API_URL = process.env.EXPO_PUBLIC_API_URL || 'http://localhost:8000/api/v1';
+const API_URL = process.env['EXPO_PUBLIC_API_URL'] || 'http://localhost:8000/api/v1';
 
 const mobileHeaders = { 'X-Client-Type': 'mobile' };
 

package/template-mobile/src/features/auth/components/AuthBackButton.tsx

@@ -35,7 +35,8 @@ export function AuthBackButton({
       navigation.goBack();
       return;
     }
-    navigation.navigate(fallback);
+    // Dynamic auth fallback — React Navigation overloads need a narrow cast.
+    navigation.navigate(fallback as never);
   };
 
   return (

package/template-mobile/src/features/auth/guestAuth.ts

@@ -1,3 +1,3 @@
 export function isGuestAuthEnabled(): boolean {
-  return process.env.EXPO_PUBLIC_FF_GUEST_AUTH === 'true';
+  return process.env['EXPO_PUBLIC_FF_GUEST_AUTH'] === 'true';
 }

package/template-mobile/src/lib/certPinning.ts

@@ -15,9 +15,9 @@ import { addBreadcrumb } from '@/lib/sentry';
  * to avoid bricking the app if the leaf cert rotates.
  */
 
-const API_HOST = process.env.EXPO_PUBLIC_API_HOST ?? '';
+const API_HOST = process.env['EXPO_PUBLIC_API_HOST'] ?? '';
 const PIN_HASHES: string[] = JSON.parse(
-  process.env.EXPO_PUBLIC_SSL_PINS ?? '[]',
+  process.env['EXPO_PUBLIC_SSL_PINS'] ?? '[]',
 );
 
 let pinningInitialised = false;

package/template-mobile/src/lib/sentry.ts

@@ -2,7 +2,7 @@ import * as Sentry from '@sentry/react-native';
 import Constants from 'expo-constants';
 
 const DSN = Constants.expoConfig?.extra?.sentryDsn
-  ?? process.env.EXPO_PUBLIC_SENTRY_DSN
+  ?? process.env['EXPO_PUBLIC_SENTRY_DSN']
   ?? '';
 
 let initialised = false;

package/template-mobile/src/services/http.ts

@@ -4,7 +4,7 @@ import { addBreadcrumb } from '@/lib/sentry';
 import { showErrorToast } from '@/components/Toast';
 import i18next from 'i18next';
 
-const API_URL = process.env.EXPO_PUBLIC_API_URL || 'http://localhost:8000/api/v1';
+const API_URL = process.env['EXPO_PUBLIC_API_URL'] || 'http://localhost:8000/api/v1';
 
 export const http = axios.create({
   baseURL: API_URL,

package/template-mobile/src/services/refreshSession.ts

@@ -3,7 +3,7 @@ import axios from 'axios';
 import { addBreadcrumb, captureException } from '@/lib/sentry';
 import { tokenStorage } from '@/lib/storage';
 
-const API_URL = process.env.EXPO_PUBLIC_API_URL || 'http://localhost:8000/api/v1';
+const API_URL = process.env['EXPO_PUBLIC_API_URL'] || 'http://localhost:8000/api/v1';
 
 let inFlight: Promise<string> | null = null;
 

package/template-mobile/src/services/websocket.ts

@@ -6,7 +6,7 @@ export type WSEvent = { type: string; [key: string]: unknown };
 
 type Listener = (event: WSEvent) => void;
 
-const BASE_WS_URL = (process.env.EXPO_PUBLIC_API_URL || 'http://localhost:8000/api/v1')
+const BASE_WS_URL = (process.env['EXPO_PUBLIC_API_URL'] || 'http://localhost:8000/api/v1')
   .replace(/\/api\/v1\/?$/, '')
   .replace(/^http/, 'ws');
 

package/template-web/AGENTS.md

@@ -86,16 +86,16 @@ yarn check          # audit + type-check + lint + stylelint + test
 
 ### Branching & Commits
 
-- Default branch: **main**
+- Default branch: **master**
 - Commits follow **Conventional Commits** (enforced by Commitlint + Husky):
   `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`, `ci`, `build`, `revert`
 - Pre-commit hooks run **lint-staged** (ESLint fix, Stylelint fix, Prettier)
 
 ### CI Pipeline (`.github/workflows/ci.yml`)
 
-Runs on push/PR to `main`:
+Runs on push/PR to `master`:
 
-1. Checkout → Enable Corepack → Setup Node 22 → `yarn install --no-immutable`
+1. Checkout → Enable Corepack → Setup Node 22 → `yarn install --immutable`
 2. `yarn type-check`
 3. `yarn lint` (ESLint)
 4. `yarn stylelint` (Stylelint)
@@ -104,7 +104,7 @@ Runs on push/PR to `main`:
 
 ### Deployment Pipeline (`.github/workflows/release.yml`)
 
-Runs on push to `main`:
+Runs on push to `master`:
 
 1. Same setup as CI
 2. Builds the application

package/template-web/Dockerfile

@@ -13,12 +13,12 @@ WORKDIR /app
 RUN corepack enable
 
 # Copy dependency files first so dependency installation is cached separately.
-COPY package.json .yarnrc.yml ./
+COPY package.json yarn.lock .yarnrc.yml ./
 
 # Install dependencies
 # Uses BuildKit cache for faster rebuilds.
 RUN --mount=type=cache,target=/root/.yarn/berry/cache \
-    yarn install --no-immutable
+    yarn install --immutable
 
 # Copy project files
 COPY . .

package/template-web/_yarnrc.yml

@@ -0,0 +1,4 @@
+nodeLinker: node-modules
+
+# Public @appsbyme packages resolve from registry.npmjs.org (default).
+# No npmScopes needed unless you later switch to a private registry.

package/template-web/docker-compose.yml

@@ -28,7 +28,7 @@ services:
     command: >-
       sh -c "corepack enable
       && corepack prepare yarn@4.12.0 --activate
-      && yarn install --no-immutable
+      && yarn install --immutable
       && yarn dev"
     stdin_open: true
     tty: true

package/template-web/package.json

@@ -9,6 +9,9 @@
   "license": "MIT",
   "type": "module",
   "private": true,
+  "engines": {
+    "node": ">=22"
+  },
   "workspaces": [],
   "scripts": {
     "dev": "vite",

package/template-web/scripts/setup-add-docker.js

@@ -31,10 +31,10 @@ FROM node:22-alpine AS builder
 
 WORKDIR /app
 
-COPY package.json .yarnrc.yml ./
+COPY package.json yarn.lock .yarnrc.yml ./
 
 RUN --mount=type=cache,target=/root/.yarn/berry/cache \\
-    yarn install --no-immutable
+    yarn install --immutable
 
 COPY . .
 
@@ -78,7 +78,7 @@ const DOCKER_COMPOSE = `services:
       - CHOKIDAR_USEPOLLING=true
       - WATCHPACK_POLLING=true
     command: >-
-      sh -c "yarn install --no-immutable
+      sh -c "yarn install --immutable
       && yarn dev"
     stdin_open: true
     tty: true
@@ -240,7 +240,18 @@ function createDockerFiles(rootDir) {
  * @param {string} [options.rootDir]
  * @returns {Promise<{changed: boolean}>}
  */
+function isMonorepoFrontend(rootDir) {
+  return exists(path.join(rootDir, '..', 'packages', 'shared'));
+}
+
 export async function apply({ rootDir = getRootDir() } = {}) {
+  if (isMonorepoFrontend(rootDir)) {
+    logWarn(
+      'Monorepo frontend detected — Docker is owned by frontend/Dockerfile + docker-compose.yml (build context: monorepo root). Skipping.',
+    );
+    return { changed: false };
+  }
+
   if (hasDocker(rootDir)) {
     logWarn('Docker configuration already detected — no changes made.');
     return { changed: false };