@cellajs/create-cella 0.2.2 → 0.3.0

package/README.md

@@ -4,7 +4,7 @@ CLI tool to scaffold a new Cella project from the template.
 
 ## Overview
 
-This CLI creates a new Cella project by downloading the latest template, setting up your development environment, and configuring git with upstream tracking for future syncs.
+This CLI creates a new Cella project by downloading the latest template, scaffolding your project, and configuring git with upstream tracking for future syncs. It runs no shell commands and requires no `git` binary — git operations use [isomorphic-git](https://github.com/isomorphic-git/isomorphic-git) and the template is fetched and extracted in-process.
 
 ## Usage
 
@@ -24,15 +24,23 @@ Running without arguments starts interactive mode, prompting for:
 pnpm create @cellajs/cella [directory] [options]
 ```
 
+| Option | Description |
+| --- | --- |
+| `--template <path>` | Use a custom template (local path or `github:user/repo`) |
+| `--port-offset <number>` | Set the port offset (0-490 in steps of 10) |
+| `--admin-email <email>` | Set the admin email for the initial seed user |
+| `-v, --version` | Output the current version |
+| `-h, --help` | Display the help message |
+
 ## What It Does
 
-1. Downloads latest Cella template via [giget](https://github.com/unjs/giget)
-2. Cleans template files (removes cella-specific docs, configs)
-3. Installs dependencies with `pnpm install`
-4. Generates initial database migrations
-5. Initializes git repository with initial commit
-6. Creates optional working branch
-7. Adds Cella as upstream remote for future syncs
+1. Downloads the latest Cella template as a GitHub tarball and extracts it in-process (no `git` binary, no shell)
+2. Cleans template files (removes cella-specific docs, configs) and interpolates the project config
+3. Initializes a git repository with an initial commit via isomorphic-git
+4. Creates an optional working branch
+5. Adds Cella as the upstream remote for future syncs
+
+Dependency installation and migration generation are **not** run automatically — after scaffolding, run `pnpm install`, then `pnpm generate` (the CLI prints these next steps on success).
 
 ## Development
 
@@ -45,6 +53,9 @@ pnpm ts
 # Lint
 pnpm lint:fix
 
+# Try it out
+pnpm try
+
 # Run tests
 pnpm test
 

package/configs/default-config.ts.template

@@ -14,6 +14,10 @@ import type { ConfigMode, RequiredConfig, S3ConfigInput } from '../src/config-bu
 // Re-export for external consumers
 export { roles, hierarchy } from './hierarchy-config';
 
+// Set these early for reuse
+const entityTypes = ['user', 'organization', 'attachment', 'page'] as const;
+const productEntityTypes = ['attachment', 'page'] as const;
+
 export const config = {
 
   /******************************************************************************
@@ -21,13 +25,13 @@ export const config = {
    ******************************************************************************/
 
   /** All entity types in the app - must match hierarchy.allTypes. */
-  entityTypes: ['user', 'organization', 'attachment', 'page'] as const,
+  entityTypes,
 
   /** Context entities with memberships - must match hierarchy.contextTypes. */
   contextEntityTypes: ['organization'] as const,
 
   /** Product/content entities - must match hierarchy.productTypes. */
-  productEntityTypes: ['attachment', 'page'] as const,
+  productEntityTypes,
 
   /**
    * Product entity types tracked for seen/unseen counts.
@@ -53,7 +57,11 @@ export const config = {
    * Entity embeddings: declares which entities are embedded as ID arrays inside
    * other entities. Forks extend when adding new embedding relationships.
    */
-  entityEmbeddings: [] as readonly { readonly embeddedEntity: string; readonly hostEntity: string; readonly hostColumn: string }[],
+  entityEmbeddings: [] as readonly {
+    readonly embeddedEntity: (typeof productEntityTypes)[number];
+    readonly hostEntity: (typeof productEntityTypes)[number];
+    readonly hostColumn: string;
+  }[],
 
   /**
    * User menu structure of context entities with optional nested subentities.
@@ -111,6 +119,22 @@ export const config = {
   yjsUrl: 'wss://yjs.__project_slug__.example.com',
   /** AI service base URL */
   aiUrl: 'https://ai.__project_slug__.example.com',
+  /**
+   * Per-service toggles and public URLs. `enabled` controls whether the service
+   * is wired up; `publicUrl` is the externally reachable endpoint.
+   */
+  services: {
+    frontend: { enabled: true as boolean, publicUrl: 'https://__project_slug__.example.com' },
+    backend: { enabled: true as boolean, publicUrl: 'https://api.__project_slug__.example.com' },
+    cdc: { enabled: true as boolean },
+    yjs: { enabled: false as boolean, publicUrl: 'wss://yjs.__project_slug__.example.com' },
+    ai: { enabled: false as boolean, publicUrl: 'https://ai.__project_slug__.example.com' },
+  },
+
+  // Cost escape hatch: when true the backend (MODE=api) also boots every enabled
+  // service in-process — one VM for previews/small forks. Default false keeps the
+  // split (one service per process). cdc co-hosting forfeits API blue-green.
+  singleVM: false as boolean,
 
   /** About page URL */
   aboutUrl: '/about',
@@ -145,6 +169,8 @@ export const config = {
   maintenance: false,
   /** Cookie version - increment when changing cookie structure to invalidate old cookies */
   cookieVersion: 'v1',
+  /** Persisted client query-cache shape - bump on a breaking change to a cached entity so clients wipe stale cache. See info/SCHEMA_EVOLUTION.md */
+  clientCacheVersion: 'v1',
 
   /******************************************************************************
    * FEATURE FLAGS
@@ -165,10 +191,6 @@ export const config = {
     uploadEnabled: false as boolean,
     /** Customer support chat widget (Gleap). Unrelated to the AI module. */
     chatSupport: false as boolean,
-    /** Yjs realtime collaboration */
-    yjs: false as boolean,
-    /** AI capability layer: tool registry + model runner + MCP endpoint. */
-    ai: false as boolean,
   },
 
   /******************************************************************************
@@ -281,6 +303,8 @@ export const config = {
   googleMapsKey: '',
   /** Matrix homeserver URL for chat integration */
   matrixURL: 'https://matrix-client.matrix.org',
+  /** Maple.dev public ingest key, safe to embed in the frontend bundle (empty disables frontend export) */
+  maplePublicIngestKey: '',
 
   /******************************************************************************
    * THEMING & UI
@@ -354,7 +378,7 @@ export const config = {
     bankAccount: '',
     googleMapsUrl: '',
     scheduleCallUrl: '',
-    blueskyUrl: '',
+    socialUrl: '',
     blueskyHandle: '',
     element: '',
     githubUrl: '',