create-feltdb 0.4.13 → 0.4.14

package/dist/cli.js

@@ -73,6 +73,14 @@ async function prompt(message) {
     const interface_ = readline.createInterface({ input: process.stdin, output: process.stdout });
     return new Promise(resolve => interface_.question(message, value => { interface_.close(); resolve(value.trim()); }));
 }
+async function promptForProjectName(defaultName = 'feltdb-app') {
+    while (true) {
+        const value = (await prompt(`What should we name your FeltDB app? (${defaultName}): `)) || defaultName;
+        if (/^[a-z0-9][a-z0-9-]*$/.test(value))
+            return value;
+        console.log('Use lowercase letters, numbers, and dashes (for example: customer-portal).');
+    }
+}
 async function promptSecret(message) {
     if (!process.stdin.isTTY || !process.stdout.isTTY)
         return '';
@@ -207,7 +215,7 @@ Deployment Target (Explicit):
                           Requires production FeltDB instance or self-host
 
   --self-host             Dedicated FeltDB server with Docker Compose
-                          Best for: Production deployments, multi-user systems
+                          Best for: Staging first, then explicit production promotion
                           Generates Docker Compose with persistent /data volume
 
   --managed               Managed FeltDB runtime
@@ -245,10 +253,12 @@ Learn more: https://github.com/rkendel1/feltdb`);
     }
     // Find project name (first non-flag argument)
     let projectName = 'feltdb-app';
+    let projectNameProvided = false;
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
         if (!arg.startsWith('-')) {
             projectName = arg;
+            projectNameProvided = true;
             break;
         }
         // Skip next arg if current arg is a flag that takes a value
@@ -260,10 +270,16 @@ Learn more: https://github.com/rkendel1/feltdb`);
     const shouldInstall = !args.includes('--no-install');
     const shouldStart = !args.includes('--no-start');
     let options = parseArgs(args);
+    if (!projectNameProvided && !shouldAutoYes && process.stdin.isTTY && process.stdout.isTTY) {
+        projectName = await promptForProjectName(projectName);
+    }
+    if (!/^[a-z0-9][a-z0-9-]*$/.test(projectName)) {
+        throw new Error('Application names must use lowercase letters, numbers, and dashes.');
+    }
     const runtimeDescriptions = {
         'browser': 'Browser with IndexedDB (local-first, no server)',
         'node': 'Node.js server (server-side authority)',
-        'self-hosted': 'Self-hosted with Docker Compose (production)',
+        'self-hosted': 'Self-hosted with Docker Compose (staging)',
         'managed': 'Managed FeltDB service (hosted persistence, sync, and workloads)',
     };
     if (!runtimeDescriptions[options.runtime]) {
@@ -286,6 +302,7 @@ Learn more: https://github.com/rkendel1/feltdb`);
     console.log(`Capabilities:  ${options.capabilities}`);
     console.log('\n═══════════════════════════════════════════════\n');
     const projectDir = path.resolve(process.cwd(), projectName);
+    let projectCreated = false;
     try {
         await createProject({
             projectName,
@@ -298,6 +315,7 @@ Learn more: https://github.com/rkendel1/feltdb`);
             webllm: options.webllm,
             capabilities: options.capabilities,
         });
+        projectCreated = true;
         if (options.runtime === 'managed') {
             console.log('\n☁️  Setting up your managed FeltDB account...\n');
             const email = process.env.FELTDB_MANAGED_EMAIL || (shouldAutoYes ? '' : await prompt('Email: '));
@@ -341,7 +359,9 @@ Learn more: https://github.com/rkendel1/feltdb`);
         }
     }
     catch (error) {
-        console.error('❌ Failed to create project:', error);
+        console.error(projectCreated
+            ? `❌ The project was created at ${projectDir}, but setup or startup failed:`
+            : '❌ Failed to create project:', error);
         process.exit(1);
     }
 }

package/dist/create.js

@@ -3,7 +3,6 @@
  */
 import fs from 'fs';
 import path from 'path';
-import { fileURLToPath } from 'url';
 import { randomBytes } from 'crypto';
 import { feltdbPackageRange } from './package-versions.js';
 import { generateDockerCompose, generateDockerfile, generateDockerIgnore, generateDotEnvLocal, generateFeltDBDockerfile, generateStudioDockerfile, } from './docker-compose-generator.js';
@@ -1218,7 +1217,8 @@ VITE_FELTDB_MANAGED_NAMESPACE=
 VITE_FELTDB_MANAGED_ENVIRONMENT=production
 
 # Override the default self-hosted container image
-# Example: ghcr.io/rkendel1/feltdb:latest
+# By default the server image is built locally from the bundled source.
+# Example override: your-registry.example/feltdb:staging
 FELTDB_IMAGE=
 
 # Node environment
@@ -1239,11 +1239,8 @@ NODE_ENV=development
         fs.writeFileSync(path.join(projectDir, 'Dockerfile'), generateDockerfile(dockerConfig, framework));
         fs.writeFileSync(path.join(projectDir, 'Dockerfile.feltdb'), generateFeltDBDockerfile(dockerConfig));
         fs.writeFileSync(path.join(projectDir, 'Dockerfile.studio'), generateStudioDockerfile(dockerConfig));
-        const serverSource = fileURLToPath(new URL('./server-source', import.meta.url));
-        fs.cpSync(serverSource, path.join(projectDir, '.feltdb', 'server-source'), { recursive: true });
         fs.writeFileSync(path.join(projectDir, '.dockerignore'), generateDockerIgnore());
         const dockerEnvironment = generateDotEnvLocal(dockerConfig, randomBytes(32).toString('hex'));
-        fs.writeFileSync(path.join(projectDir, '.env.docker'), dockerEnvironment);
         // Docker Compose loads .env automatically; it is already excluded from git.
         fs.writeFileSync(path.join(projectDir, '.env'), dockerEnvironment);
     }
@@ -1497,7 +1494,8 @@ Verify vector database connection and that embeddings are enabled in capabilitie
 - Check out example projects in the templates
 - Join the community Discord for support
 `;
-    fs.writeFileSync(path.join(projectDir, 'RUNTIME_GUIDE.md'), runtimeGuide);
+    // Keep generated projects focused; the runtime guide lives in FeltDB's docs.
+    void runtimeGuide;
     // Create .gitignore
     const gitignore = `node_modules/
 dist/

package/dist/docker-compose-generator.js

@@ -14,16 +14,33 @@ export function generateDockerCompose(config) {
     build:
       context: .
       dockerfile: Dockerfile.feltdb
+      args:
+        FELTDB_VERSION: ${config.version}
     container_name: \${COMPOSE_PROJECT_NAME}-feltdb
     environment:
       FELTDB_APP_NAME: \${FELTDB_APP_NAME:-${config.appName}}
       FELTDB_APP_ID: \${FELTDB_APP_ID:-${config.appId}}
       FELTDB_VERSION: \${FELTDB_VERSION:-${config.version}}
+      FELTDB_ENVIRONMENT: \${FELTDB_ENVIRONMENT:-staging}
       FELTDB_PEERS: \${FELTDB_PEERS:-}
       FELTDB_MASTER_KEY: \${FELTDB_MASTER_KEY}
       NODE_ENV: \${NODE_ENV:-production}
     ports:
       - "\${FELTDB_API_PORT:-${config.port}}:7700"
+    command:
+      - feltdb-server
+      - --host
+      - 0.0.0.0
+      - --port
+      - "7700"
+      - --namespace
+      - \${FELTDB_APP_ID:-${config.appId}}
+      - --data
+      - /data/feltdb.log
+      - --allow-origin
+      - http://127.0.0.1:\${APP_PORT:-5173}
+      - --allow-origin
+      - http://127.0.0.1:\${STUDIO_PORT:-${config.studioPort}}
     volumes:
       - feltdb_data:/data
       - ./feltdb.flow:/app/feltdb.flow:ro
@@ -106,11 +123,13 @@ volumes:
 `;
 }
 export function generateFeltDBDockerfile(config) {
-    return `# FeltDB server source is bundled with create-feltdb for a reproducible build.
+    return `# Build the matching FeltDB server without adding engine source to the application.
 FROM rust:1.96-alpine AS builder
-RUN apk add --no-cache pkgconf openssl-dev musl-dev
+RUN apk add --no-cache nodejs npm pkgconf openssl-dev musl-dev
 WORKDIR /source
-COPY .feltdb/server-source/ ./
+ARG FELTDB_VERSION=${config.version}
+RUN npm install --global "create-feltdb@\${FELTDB_VERSION}" \
+ && cp -R "\$(npm root --global)/create-feltdb/dist/server-source/." /source/
 RUN cargo build -p feltdb-server --release --locked
 
 FROM alpine:3.22
@@ -191,6 +210,7 @@ COMPOSE_PROJECT_NAME=${config.appName.toLowerCase().replace(/[^a-z0-9]/g, '-')}
 FELTDB_APP_NAME=${config.appName}
 FELTDB_APP_ID=${config.appId}
 FELTDB_VERSION=${config.version}
+FELTDB_ENVIRONMENT=staging
 FELTDB_API_PORT=${config.port}
 FELTDB_REPLICATION_PORT=${config.replicationPort}
 FELTDB_PEERS=
@@ -203,8 +223,6 @@ FELTDB_API_URL=http://feltdb:7700
 # Studio Configuration
 STUDIO_PORT=${config.studioPort}
 
-# Runtime
-NODE_ENV=production
 `;
 }
 export function generateHealthCheckScript() {

package/dist/package-versions.js

@@ -1,4 +1,4 @@
 // One release train keeps generated applications installable. The repository
 // validation script checks these values against every workspace manifest.
-export const FELTDB_PACKAGE_VERSION = '0.4.13';
+export const FELTDB_PACKAGE_VERSION = '0.4.14';
 export const feltdbPackageRange = `^${FELTDB_PACKAGE_VERSION}`;

package/package.json

@@ -2,7 +2,7 @@
   "name": "create-feltdb",
   "private": false,
   "description": "Create a new FeltDB application with one command",
-  "version": "0.4.13",
+  "version": "0.4.14",
   "license": "MIT",
   "bin": {
     "create-feltdb": "bin/create-feltdb.js"