create-feltkit 0.3.9 → 0.3.11

package/bin/create.js

@@ -49,7 +49,7 @@ try {
     console.log(dim("The dev server prints your app URL and a dashboard link. State lives in .feltkit/development/state."));
     console.log(dim("README.md covers running, testing, deploying, and every feltkit command."));
   }
-  console.log(dim("Using a coding agent? `npx feltkit skills install` (after npm install) adds the FeltKit skills for Claude Code."));
+  console.log(dim("Using a coding agent? `npx feltkit skills install` (after npm install) adds the FeltKit skills for Claude Code; restart the Claude Code session afterwards to load them."));
 } catch (error) {
   console.error(`${red("✗")} ${error.message}`);
   if (error.hint) console.error(`  hint: ${error.hint}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-feltkit",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "description": "Create a FeltKit application: npm create feltkit@latest my-app (add -- --template managed for Managed FeltDB)",
   "license": "MIT",
   "type": "module",

package/template/README.md

@@ -38,6 +38,7 @@ start over.
 |---|---|
 | `feltkit/app.ts` | The application: its name, roles and permissions, dev users, enabled services, collections |
 | `feltkit/projects.ts`, `feltkit/tasks.ts` | Functions: queries (read) and mutations (write). A function is `<module>:<export>`, e.g. `tasks:create` |
+| `feltkit/_*.ts` | Helpers shared by function modules (business rules, formatting). A file whose name starts with `_` is not loaded as a function module |
 | `feltkit/_generated/api.ts` | Typed references to every function. Regenerated by `feltkit dev` and `feltkit codegen`; don't edit it |
 | `src/` | The React frontend. Colors are tokens in `src/styles.css`, each `light-dark(light, dark)`; the top bar's switch (`src/theme.tsx`) picks light, dark, or the system setting, remembered per browser and applied before first paint by `public/theme.js` |
 | `tests/` | Tests, each against a fresh FeltDB instance |
@@ -240,8 +241,10 @@ without their FeltDB settings.
    `MAILPORT_API_KEY`), and `auth.providers` for "Continue with Google / GitHub" (client id in
    `feltkit/app.ts`, client secret as `FELTKIT_CREDENTIAL_<ID>_CLIENT_SECRET`).
 
-   **On AppBoundry** (`npx feltkit build --target appboundry`, then `appboundry run tasks.app`),
-   AppBoundry's operators create users with your app's roles and issue their sessions:
+   **On AppBoundry** (`npx feltkit build --target appboundry`, then `appboundry run tasks.app` with
+   AppBoundry built from its repository: no npm release reads the format yet; to test the artifact
+   itself, use `createArtifactTestApp("tasks.app")` from `@feltdb/feltkit/testing`), AppBoundry's
+   operators create users with your app's roles and issue their sessions:
 
    ```bash
    appboundry admin users add you --role member --state <installation>
@@ -289,6 +292,21 @@ To move non-secret configuration between environments, use
 To deploy on Managed FeltDB, where no host keeps state, start from
 `npm create feltkit@latest <dir> -- --template managed`; its README walks through setup.
 
+## Portability (AppBoundry)
+
+`npx feltkit build --target appboundry` compiles the app into `tasks.app`, which runs without
+this project or FeltKit. A plain `npx feltkit build` warns about anything that would block it.
+An artifact refuses (the build names the file and line):
+
+- `ctx.agent`, `ctx.unsafe`, `ctx.afterCommit`, `ctx.db.sequence`: they need the FeltKit server;
+- `app.integration(...)` and `auth.authenticate`;
+- Node built-ins in `feltkit/`;
+- `Intl`, `toLocaleString`, `localeCompare`: the artifact has no locale data, so format for
+  people in the frontend.
+
+It also leaves out Studio, `/mcp`, API keys, schedules and webhook delivery. To run your tests
+against the artifact itself: `createArtifactTestApp("tasks.app")` from `@feltdb/feltkit/testing`.
+
 ## Commands
 
 npm scripts:

package/template/package.json

@@ -13,7 +13,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@feltdb/feltkit": "0.3.9",
+    "@feltdb/feltkit": "0.3.11",
     "react": "19.2.0",
     "react-dom": "19.2.0"
   },

package/template-managed/package.json

@@ -20,10 +20,10 @@
     "deploy:fly": "node scripts/deploy-fly.mjs"
   },
   "dependencies": {
-    "@feltdb/feltkit": "0.3.9"
+    "@feltdb/feltkit": "0.3.11"
   },
   "devDependencies": {
-    "@feltdb/core": ">=0.17.1 <1.0.0",
+    "@feltdb/core": ">=0.18.0 <1.0.0",
     "@types/node": "22.19.1",
     "typescript": "5.9.3"
   }