create-projx 1.4.0 → 1.4.2

package/README.md

@@ -131,6 +131,8 @@ npx create-projx pin <patterns...>
 npx create-projx unpin <patterns...>
 npx create-projx pin --list
 npx create-projx doctor [--fix]
+npx create-projx gen entity <name>
+npx create-projx sync [--url <url>]
 
 --components <list>    Comma-separated: fastapi,fastify,frontend,mobile,e2e,infra
 --no-git               Skip git init
@@ -174,6 +176,46 @@ npx create-projx doctor --fix   # auto-fix what's possible
 
 Checks: config validity, component markers, baseline ref, stale worktrees, skip pattern coverage.
 
+### Generate Entities
+
+Scaffold a new entity across all components in your project:
+
+```bash
+npx create-projx gen entity invoice                                          # interactive
+npx create-projx gen entity invoice --fields "name:string,amount:number"     # non-interactive
+```
+
+Generates based on what's in your `.projx`:
+
+| Component | Generated |
+| --------- | --------- |
+| `fastapi` | `src/entities/<name>/_model.py` — auto-discovered by registry |
+| `fastify` | `src/modules/<name>/schemas.ts` + `index.ts` + Prisma model + app.ts import |
+| `frontend` | `src/types/<name>.ts` — TypeScript interface + Create/Update variants |
+| `mobile` | `lib/entities/<name>/model.dart` — Dart class with fromJson/toJson/copyWith |
+
+No migrations — run `alembic revision --autogenerate` or `npx prisma migrate dev` when ready.
+
+### Sync Types
+
+Regenerate all frontend/mobile types from a running backend:
+
+```bash
+npx create-projx sync                                              # auto-detects URL
+npx create-projx sync --url http://localhost:8000/api/v1/_meta      # explicit URL
+```
+
+Fetches `/_meta` from your backend, generates typed interfaces for every entity. Run after any backend change — new field, renamed column, new entity.
+
+The generic `api.ts` client accepts type parameters:
+
+```tsx
+import type { Invoice } from '../types/invoice';
+
+const { data } = await api.list<Invoice>('/invoices');    // data: Invoice[]
+const item = await api.get<Invoice>('/invoices', id);     // item: Invoice
+```
+
 ## Rename Component Directories
 
 Rename `fastapi/` to `backend/`? Just rename the folder — the `.projx-component` marker file moves with it. The `update` command auto-discovers where each component lives by scanning for these markers. No config changes needed.

package/dist/index.js

@@ -251,6 +251,35 @@ async function discoverComponentPaths(cwd, components) {
   }
   return paths;
 }
+async function discoverComponentsFromMarkers(cwd) {
+  const components = [];
+  const paths = {};
+  const entries = await readdir(cwd, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (EXCLUDE.has(entry.name)) continue;
+    if (entry.name.startsWith(".")) continue;
+    const full = join(cwd, entry.name);
+    const marker = join(full, COMPONENT_MARKER);
+    if (existsSync(marker)) {
+      try {
+        const data = JSON.parse(await readFile(marker, "utf-8"));
+        const markerComponents = data.components ?? (data.component ? [data.component] : []);
+        for (const mc of markerComponents) {
+          if (COMPONENTS.includes(mc) && !components.includes(mc)) {
+            components.push(mc);
+            paths[mc] = entry.name;
+          }
+        }
+      } catch {
+      }
+    }
+  }
+  for (const c of components) {
+    if (!paths[c]) paths[c] = c;
+  }
+  return { components, paths };
+}
 function render(template, vars) {
   const components = vars.components;
   const projectName = vars.projectName;
@@ -261,12 +290,29 @@ function render(template, vars) {
     const ifMatch = line.match(/^<%\s*if\s*\((.+?)\)\s*\{?\s*%>$/);
     if (ifMatch) {
       const fn = new Function("components", "projectName", `return ${ifMatch[1]}`);
-      stack.push(fn(components, projectName));
+      const result = fn(components, projectName);
+      stack.push({ active: result, matched: result });
+      continue;
+    }
+    const elseIfMatch = line.match(/^<%\s*\}\s*else\s+if\s*\((.+?)\)\s*\{?\s*%>$/);
+    if (elseIfMatch) {
+      if (stack.length > 0) {
+        const top = stack[stack.length - 1];
+        if (top.matched) {
+          top.active = false;
+        } else {
+          const fn = new Function("components", "projectName", `return ${elseIfMatch[1]}`);
+          const result = fn(components, projectName);
+          top.active = result;
+          if (result) top.matched = true;
+        }
+      }
       continue;
     }
     if (/^<%\s*\}\s*else\s*\{?\s*%>$/.test(line)) {
       if (stack.length > 0) {
-        stack[stack.length - 1] = !stack[stack.length - 1];
+        const top = stack[stack.length - 1];
+        top.active = !top.matched;
       }
       continue;
     }
@@ -274,7 +320,7 @@ function render(template, vars) {
       stack.pop();
       continue;
     }
-    if (stack.length > 0 && stack.some((v) => !v)) continue;
+    if (stack.length > 0 && stack.some((v) => !v.active)) continue;
     const replaced = line.replace(
       /<%=\s*([\w.]+)\s*%>/g,
       (_, expr) => {
@@ -908,17 +954,19 @@ async function update(cwd, localRepo) {
   const configPath = join5(cwd, ".projx");
   let config;
   if (existsSync4(configPath)) {
-    config = JSON.parse(await readFile5(configPath, "utf-8"));
+    const raw = JSON.parse(await readFile5(configPath, "utf-8"));
+    const { components: discovered } = await discoverComponentsFromMarkers(cwd);
+    config = { ...raw, components: discovered.length > 0 ? discovered : raw.components };
     p3.log.info(`Found .projx (v${config.version}, components: ${config.components.join(", ")})`);
   } else {
     p3.log.warn("No .projx file found. Detecting components from directories.");
-    const detected = COMPONENTS.filter((c) => existsSync4(join5(cwd, c)));
-    if (detected.length === 0) {
+    const { components: discovered } = await discoverComponentsFromMarkers(cwd);
+    if (discovered.length === 0) {
       p3.log.error("No projx components found. Run 'projx init' first.");
       process.exit(1);
     }
-    config = { version: "0.0.0", components: detected, createdAt: "unknown" };
-    p3.log.info(`Detected: ${detected.join(", ")}`);
+    config = { version: "0.0.0", components: discovered, createdAt: "unknown" };
+    p3.log.info(`Detected: ${discovered.join(", ")}`);
   }
   const componentPaths = await discoverComponentPaths(cwd, config.components);
   for (const c of config.components) {
@@ -1476,7 +1524,7 @@ async function pin(cwd, patterns) {
     process.exit(1);
   }
   const config = JSON.parse(await readFile8(configPath, "utf-8"));
-  const componentPaths = await discoverComponentPaths(cwd, config.components);
+  const componentPaths = (await discoverComponentsFromMarkers(cwd)).paths;
   const rootAdds = [];
   const componentAdds = {};
   for (const pattern of patterns) {
@@ -1533,7 +1581,7 @@ async function unpin(cwd, patterns) {
     process.exit(1);
   }
   const config = JSON.parse(await readFile8(configPath, "utf-8"));
-  const componentPaths = await discoverComponentPaths(cwd, config.components);
+  const componentPaths = (await discoverComponentsFromMarkers(cwd)).paths;
   const rootRemoves = [];
   const componentRemoves = {};
   for (const pattern of patterns) {
@@ -1594,7 +1642,7 @@ async function listPins(cwd) {
     process.exit(1);
   }
   const config = JSON.parse(await readFile8(configPath, "utf-8"));
-  const componentPaths = await discoverComponentPaths(cwd, config.components);
+  const { components: discovered, paths: componentPaths } = await discoverComponentsFromMarkers(cwd);
   let hasAny = false;
   if (config.skip && config.skip.length > 0) {
     hasAny = true;
@@ -1603,7 +1651,7 @@ async function listPins(cwd) {
       p6.log.info(`  ${s}`);
     }
   }
-  for (const component of config.components) {
+  for (const component of discovered) {
     const dir = componentPaths[component];
     const marker = await readComponentMarker(join9(cwd, dir));
     if (marker?.skip && marker.skip.length > 0) {
@@ -1860,10 +1908,11 @@ async function doctor(cwd, fix = false) {
     printReport(allResults);
     process.exit(1);
   }
-  const componentPaths = await discoverComponentPaths(cwd, config.components);
-  allResults.push(...await checkComponents(cwd, config, componentPaths));
+  const { components: discovered, paths: componentPaths } = await discoverComponentsFromMarkers(cwd);
+  const resolvedConfig = { ...config, components: discovered.length > 0 ? discovered : config.components };
+  allResults.push(...await checkComponents(cwd, resolvedConfig, componentPaths));
   allResults.push(...checkGit(cwd, fix));
-  allResults.push(...await checkSkipPatterns(cwd, config, componentPaths));
+  allResults.push(...await checkSkipPatterns(cwd, resolvedConfig, componentPaths));
   printReport(allResults);
   const passed = allResults.filter((r) => r.status === "pass").length;
   const warns = allResults.filter((r) => r.status === "warn").length;
@@ -1918,8 +1967,9 @@ async function diff(cwd, localRepo) {
     p8.log.error("No .projx file found. Run 'npx create-projx init' first.");
     process.exit(1);
   }
-  const config = JSON.parse(await readFile10(configPath, "utf-8"));
-  const componentPaths = await discoverComponentPaths(cwd, config.components);
+  const raw = JSON.parse(await readFile10(configPath, "utf-8"));
+  const { components: discovered, paths: componentPaths } = await discoverComponentsFromMarkers(cwd);
+  const config = { ...raw, components: discovered.length > 0 ? discovered : raw.components };
   const componentSkips = {};
   for (const component of config.components) {
     const dir = componentPaths[component];
@@ -2579,12 +2629,11 @@ async function gen(cwd, entityName, fieldsFlag) {
     p9.log.error("No .projx file found. Run 'npx create-projx init' first.");
     process.exit(1);
   }
-  const projxConfig = JSON.parse(await readFile11(configPath, "utf-8"));
-  const componentPaths = await discoverComponentPaths(cwd, projxConfig.components);
-  const hasFastapi = projxConfig.components.includes("fastapi");
-  const hasFastify = projxConfig.components.includes("fastify");
-  const hasFrontend = projxConfig.components.includes("frontend");
-  const hasMobile = projxConfig.components.includes("mobile");
+  const { components: discovered, paths: componentPaths } = await discoverComponentsFromMarkers(cwd);
+  const hasFastapi = discovered.includes("fastapi");
+  const hasFastify = discovered.includes("fastify");
+  const hasFrontend = discovered.includes("frontend");
+  const hasMobile = discovered.includes("mobile");
   if (!hasFastapi && !hasFastify) {
     p9.log.error("No backend component found. Need fastapi or fastify.");
     process.exit(1);
@@ -2732,7 +2781,7 @@ async function gen(cwd, entityName, fieldsFlag) {
 
 // src/sync.ts
 import { existsSync as existsSync12, readFileSync as readFileSync2 } from "fs";
-import { readFile as readFile12, writeFile as writeFile6, mkdir as mkdir6 } from "fs/promises";
+import { writeFile as writeFile6, mkdir as mkdir6 } from "fs/promises";
 import { join as join13 } from "path";
 import * as p10 from "@clack/prompts";
 function toPascal2(s) {
@@ -2909,15 +2958,9 @@ async function sync(cwd, url) {
     p10.log.error("No .projx file found. Run 'npx create-projx init' first.");
     process.exit(1);
   }
-  const projxConfig = JSON.parse(
-    await readFile12(configPath, "utf-8")
-  );
-  const componentPaths = await discoverComponentPaths(
-    cwd,
-    projxConfig.components
-  );
-  const hasFrontend = projxConfig.components.includes("frontend");
-  const hasMobile = projxConfig.components.includes("mobile");
+  const { components: discovered, paths: componentPaths } = await discoverComponentsFromMarkers(cwd);
+  const hasFrontend = discovered.includes("frontend");
+  const hasMobile = discovered.includes("mobile");
   if (!hasFrontend && !hasMobile) {
     p10.log.error("No frontend or mobile component found. Nothing to sync.");
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-projx",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Scaffold production-grade fullstack projects in seconds. FastAPI, Fastify, React, Flutter, Terraform — with auth, database, CI/CD, E2E tests, and Docker. One command, ready to deploy.",
   "type": "module",
   "bin": {

package/src/templates/docker-compose.dev.yml.ejs

@@ -24,7 +24,7 @@ services:
       - app-network
 <% } %>
 <% if (components.includes('fastapi')) { %>
-  migrate:
+  <%= paths.fastapi %>-migrate:
     build: ./<%= paths.fastapi %>
     command: ['uv', 'run', 'migrate.py']
     environment:
@@ -39,8 +39,7 @@ services:
           cpus: '0.5'
     networks:
       - app-network
-
-  backend:
+  <%= paths.fastapi %>:
     build: ./<%= paths.fastapi %>
     command:
       [
@@ -61,7 +60,7 @@ services:
       - ./<%= paths.fastapi %>/alembic.ini:/app/alembic.ini
       - ./<%= paths.fastapi %>/migrate.py:/app/migrate.py
     depends_on:
-      migrate:
+      <%= paths.fastapi %>-migrate:
         condition: service_completed_successfully
     restart: unless-stopped
     healthcheck:
@@ -83,7 +82,22 @@ services:
       - app-network
 <% } %>
 <% if (components.includes('fastify')) { %>
-  backend-fastify:
+  <%= paths.fastify %>-migrate:
+    build: ./<%= paths.fastify %>
+    command: ['pnpm', 'prisma', 'migrate', 'deploy']
+    environment:
+      - DATABASE_URL=postgresql://dev:dev@db:5432/app
+    depends_on:
+      db:
+        condition: service_healthy
+    deploy:
+      resources:
+        limits:
+          memory: 256M
+          cpus: '0.5'
+    networks:
+      - app-network
+  <%= paths.fastify %>:
     build: ./<%= paths.fastify %>
     command: ['pnpm', 'dev']
     ports:
@@ -96,8 +110,8 @@ services:
     volumes:
       - ./<%= paths.fastify %>/src:/app/src
     depends_on:
-      db:
-        condition: service_healthy
+      <%= paths.fastify %>-migrate:
+        condition: service_completed_successfully
     restart: unless-stopped
     healthcheck:
       test: ['CMD', 'wget', '--spider', '-q', 'http://localhost:3000/api/health']
@@ -121,23 +135,21 @@ services:
     ports:
       - '5173:5173'
     environment:
-<% if (components.includes('fastapi')) { %>
-      - VITE_API_URL=http://localhost:7860
-<% } %>
-<% if (components.includes('fastify') && !components.includes('fastapi')) { %>
+<% if (components.includes('fastify')) { %>
       - VITE_API_URL=http://localhost:3000
+<% } else if (components.includes('fastapi')) { %>
+      - VITE_API_URL=http://localhost:7860
 <% } %>
     volumes:
       - ./<%= paths.frontend %>:/app
       - frontend_node_modules:/app/node_modules
-<% if (components.includes('fastapi')) { %>
+<% if (components.includes('fastify')) { %>
     depends_on:
-      backend:
+      <%= paths.fastify %>:
         condition: service_healthy
-<% } %>
-<% if (components.includes('fastify') && !components.includes('fastapi')) { %>
+<% } else if (components.includes('fastapi')) { %>
     depends_on:
-      backend-fastify:
+      <%= paths.fastapi %>:
         condition: service_healthy
 <% } %>
     healthcheck:
@@ -154,7 +166,6 @@ services:
     networks:
       - app-network
 <% } %>
-
 volumes:
 <% if (components.includes('fastapi') || components.includes('fastify')) { %>
   pgdata:
@@ -162,7 +173,6 @@ volumes:
 <% if (components.includes('frontend')) { %>
   frontend_node_modules:
 <% } %>
-
 networks:
   app-network:
     driver: bridge

package/src/templates/docker-compose.yml.ejs

@@ -1,14 +1,13 @@
 services:
 <% if (components.includes('fastapi')) { %>
-  migrate:
+  <%= paths.fastapi %>-migrate:
     build: ./<%= paths.fastapi %>
     command: ["uv", "run", "migrate.py"]
     env_file:
       - ./<%= paths.fastapi %>/.env
     networks:
       - app-network
-
-  backend:
+  <%= paths.fastapi %>:
     build: ./<%= paths.fastapi %>
     expose:
       - "7860"
@@ -16,7 +15,7 @@ services:
       - ./<%= paths.fastapi %>/.env
     restart: unless-stopped
     depends_on:
-      migrate:
+      <%= paths.fastapi %>-migrate:
         condition: service_completed_successfully
     healthcheck:
       test:
@@ -34,13 +33,23 @@ services:
       - app-network
 <% } %>
 <% if (components.includes('fastify')) { %>
-  backend-fastify:
+  <%= paths.fastify %>-migrate:
+    build: ./<%= paths.fastify %>
+    command: ["pnpm", "prisma", "migrate", "deploy"]
+    env_file:
+      - ./<%= paths.fastify %>/.env
+    networks:
+      - app-network
+  <%= paths.fastify %>:
     build: ./<%= paths.fastify %>
     expose:
       - "3000"
     env_file:
       - ./<%= paths.fastify %>/.env
     restart: unless-stopped
+    depends_on:
+      <%= paths.fastify %>-migrate:
+        condition: service_completed_successfully
     healthcheck:
       test: ["CMD", "wget", "--spider", "-q", "http://localhost:3000/api/health"]
       interval: 30s
@@ -62,14 +71,13 @@ services:
     volumes:
       - letsencrypt:/etc/letsencrypt
       - certbot-www:/var/www/certbot
-<% if (components.includes('fastapi')) { %>
+<% if (components.includes('fastify')) { %>
     depends_on:
-      backend:
+      <%= paths.fastify %>:
         condition: service_healthy
-<% } %>
-<% if (components.includes('fastify') && !components.includes('fastapi')) { %>
+<% } else if (components.includes('fastapi')) { %>
     depends_on:
-      backend-fastify:
+      <%= paths.fastapi %>:
         condition: service_healthy
 <% } %>
     restart: unless-stopped
@@ -81,7 +89,6 @@ services:
       start_period: 10s
     networks:
       - app-network
-
   certbot:
     image: certbot/certbot:latest
     volumes:
@@ -102,7 +109,6 @@ volumes:
   letsencrypt:
   certbot-www:
 <% } %>
-
 networks:
   app-network:
     driver: bridge