@agent-native/core 0.7.2 → 0.7.6

package/docs/content/{resources.md → workspace.md}

@@ -1,11 +1,28 @@
 ---
-title: "Workspace Resources"
-description: "SQL-backed workspace files for notes, skills, custom agents, scheduled tasks, and instructions."
+title: "Workspace"
+description: "Claude-Code-level customization per user — skills, memory, instructions, custom agents, scheduled jobs, MCP servers — backed by SQL, not a filesystem."
 ---
 
-# Workspace Resources
+# Workspace
 
-The **Workspace** tab is where you and the agent share persistent files — notes, instructions, skills, custom agents, and scheduled jobs. Files live in the database (not the filesystem), so they persist across sessions, work in serverless/edge deploys, and can be edited from both the UI and the agent.
+Every agent-native app ships with a **workspace**: the customization layer that makes the agent yours. It contains team instructions (`AGENTS.md`), per-user memory (`learnings.md`), skills the agent pulls in on demand, custom sub-agents, scheduled jobs, and connected MCP servers — everything you'd expect from a Claude Code / Codex setup.
+
+The twist: **it's SQL rows, not filesystem files.** Each user gets their own workspace stored in the database. There's no dev-box to spin up, no container per user, no files to mount. A multi-tenant SaaS can give every user a fully-customizable agent for essentially free, because all of it is rows — personal memory, personal MCP servers, personal skills, personal sub-agents — and the shared codebase hosts all of them at once.
+
+| Claude Code / Codex              | Agent-native workspace                             |
+| -------------------------------- | -------------------------------------------------- |
+| Files on your local disk         | Rows in a shared SQL database                      |
+| One codebase per developer       | One codebase, many users                           |
+| Needs a dev-box or container     | Runs on any serverless/edge host                   |
+| Customization at `~/.claude/`    | Customization per-user, scoped `u:<email>:…`       |
+| Per-project `CLAUDE.md` / skills | Per-app `AGENTS.md` + per-user `learnings.md`      |
+| MCP config in a JSON file        | MCP config in JSON _or_ the settings UI, per scope |
+
+Same capabilities. Different economics. See [Cloneable SaaS](/docs/cloneable-saas) for why this matters for SaaS.
+
+## The Workspace tab {#the-tab}
+
+The **Workspace** tab in the agent sidebar is where you and the agent share persistent files — notes, instructions, skills, custom agents, and scheduled jobs. Files live in the database (not the filesystem), so they persist across sessions, work in serverless/edge deploys, and can be edited from both the UI and the agent.
 
 ## TL;DR {#tldr}
 
@@ -13,19 +30,19 @@ The **Workspace** tab is where you and the agent share persistent files — note
 - Create files with the `+` menu. Upload with the upload button. Edit inline (visual or code view).
 - **Personal** is just you. **Shared** is your team/org.
 - The agent can read, write, and rename any of these files as part of a conversation.
-- Special files the agent always reads: `AGENTS.md` (team rules) and `learnings.md` (per-user).
+- Special files the agent always reads: `AGENTS.md` (team rules) and `learnings.md` (per-user memory the agent auto-updates when you correct it).
 
 ## What goes in here? {#what-goes-in-here}
 
-| File / path                 | What it's for                                                                                          |
-| --------------------------- | ------------------------------------------------------------------------------------------------------ |
-| `AGENTS.md` (Shared)        | Team instructions the agent reads every turn — tone, rules, domain context, skill references.          |
-| `learnings.md` (Personal)   | Corrections and preferences the agent records per user so it doesn't repeat mistakes.                  |
-| `skills/<name>.md`          | Focused domain guidance the agent pulls in on demand (invoked with `/` slash commands).                |
-| `agents/<name>.md`          | **Custom agents** — reusable sub-agent profiles the agent can delegate to (invoked with `@` mentions). |
-| `remote-agents/<name>.json` | A2A manifests for connected remote agents — edited via a form, not raw JSON.                           |
-| `jobs/<name>.md`            | Scheduled tasks that run on a cron (see the recurring-jobs docs).                                      |
-| Anything else               | Notes, prompts, config, dataset snippets — any text file.                                              |
+| File / path                 | What it's for                                                                                                  |
+| --------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `AGENTS.md` (Shared)        | Team instructions the agent reads every turn — tone, rules, domain context, skill references.                  |
+| `learnings.md` (Personal)   | **Agent memory.** Per-user file the agent auto-writes to on corrections/preferences and auto-reads every turn. |
+| `skills/<name>.md`          | Focused domain guidance the agent pulls in on demand (invoked with `/` slash commands).                        |
+| `agents/<name>.md`          | **Custom agents** — reusable sub-agent profiles the agent can delegate to (invoked with `@` mentions).         |
+| `remote-agents/<name>.json` | A2A manifests for connected remote agents — edited via a form, not raw JSON.                                   |
+| `jobs/<name>.md`            | Scheduled tasks that run on a cron (see the recurring-jobs docs).                                              |
+| Anything else               | Notes, prompts, config, dataset snippets — any text file.                                                      |
 
 ## Overview {#overview}
 
@@ -88,25 +105,58 @@ At the start of every conversation, the agent automatically reads:
 
 A shared resource seeded by default. It contains custom instructions, preferences, and skill references. Edit this to change how the agent behaves for all users — tone, rules, domain context, and which skills to use.
 
-```text
+```markdown
 # Agent Instructions
 
 ## Tone
+
 Be concise. Lead with the answer.
 
 ## Code style
+
 - Use TypeScript, never JavaScript
 - Prefer named exports
 
 ## Skills
-| Skill | Path | Description |
-|-------|------|-------------|
+
+| Skill         | Path                      | Description                 |
+| ------------- | ------------------------- | --------------------------- |
 | data-analysis | `skills/data-analysis.md` | BigQuery and data workflows |
 ```
 
-### learnings.md {#learnings-md}
+### learnings.md — agent memory {#learnings-md}
+
+`learnings.md` is the agent's long-term memory about _you_. It's a **Personal-scope** resource (one per user) that the agent auto-reads at the start of every conversation and auto-writes to whenever it picks up something worth remembering.
+
+**What gets saved.** When you correct the agent ("no, always use X instead of Y"), share a preference ("I prefer concise answers"), or reveal context ("my team calls this 'the dispatch layer'"), the agent appends the learning to `learnings.md` so it doesn't repeat the mistake or have to re-ask next time. This behavior lives in the framework system prompt (the `capture-learnings` skill spells out the rules for when and how).
+
+**What it looks like.**
+
+```markdown
+# Learnings
+
+## Tone
+
+- Be concise; skip preamble. (corrected 2026-01-14)
+
+## Naming
+
+- "Dispatch" refers to our internal event-routing service, not the template app.
+
+## Preferences
+
+- Prefer named exports over default exports in TypeScript.
+```
+
+**Where it fits.**
 
-A personal resource where the agent records corrections, preferences, and patterns it learns from each user. When the agent makes a mistake and the user corrects it, the agent updates `learnings.md` so it doesn't repeat the error.
+| Surface        | Scope    | Written by                | Read when                    |
+| -------------- | -------- | ------------------------- | ---------------------------- |
+| `AGENTS.md`    | Shared   | Humans / agent on request | Every turn                   |
+| `learnings.md` | Personal | Agent, automatically      | Every turn                   |
+| `skills/…`     | Shared   | Humans / agent on request | On demand (`/slash` command) |
+
+Users can edit `learnings.md` directly in the Workspace tab — it's a regular resource. Delete lines the agent got wrong or promote them into `AGENTS.md` if they apply to the whole team.
 
 ## Skills {#skills}
 
@@ -178,7 +228,7 @@ Use custom agents for delegation within one app. Use connected agents when you n
 
 Skills are Markdown files with optional YAML frontmatter for metadata:
 
-````text
+```markdown
 ---
 name: data-analysis
 description: BigQuery queries, data transforms, and visualization
@@ -187,20 +237,22 @@ description: BigQuery queries, data transforms, and visualization
 # Data Analysis
 
 ## When to use
+
 Use this skill when the user asks about data, queries, or analytics.
 
 ## Rules
+
 - Always validate SQL before executing
 - Prefer CTEs over subqueries
 - Include LIMIT on exploratory queries
 
 ## Patterns
-```sql
--- Standard BigQuery date filter
-WHERE DATE(created_at) BETWEEN @start_date AND @end_date
-````
 
-````
+    -- Standard BigQuery date filter
+    WHERE DATE(created_at) BETWEEN @start_date AND @end_date
+```
+
+> Skill bodies can embed fenced code blocks in any language — shown above as indented code to keep this outer example readable, but you'd normally use a language-tagged fence in your real skill file.
 
 ## @ Tagging {#at-tagging}
 
@@ -232,13 +284,13 @@ If no skills are configured, the dropdown shows a hint with a link to these docs
 
 The resource system works identically in both modes. The difference is what additional sources are available for `@` tagging and `/` commands:
 
-| Feature | Dev Mode | Production |
-|---------|----------|------------|
-| @ tagging | Codebase files + workspace resources + custom agents + connected agents | Workspace resources + custom agents + connected agents |
-| / slash commands | .agents/skills/ + resource skills | Resource skills only |
-| Agent file access | Filesystem + resources | Resources only |
-| Workspace panel | Full access | Full access |
-| AGENTS.md / learnings.md | Available | Available |
+| Feature                  | Dev Mode                                                                | Production                                             |
+| ------------------------ | ----------------------------------------------------------------------- | ------------------------------------------------------ |
+| @ tagging                | Codebase files + workspace resources + custom agents + connected agents | Workspace resources + custom agents + connected agents |
+| / slash commands         | .agents/skills/ + resource skills                                       | Resource skills only                                   |
+| Agent file access        | Filesystem + resources                                                  | Resources only                                         |
+| Workspace panel          | Full access                                                             | Full access                                            |
+| AGENTS.md / learnings.md | Available                                                               | Available                                              |
 
 ## Resource API {#resource-api}
 
@@ -248,15 +300,15 @@ Resources can be managed from server code, actions, or the REST API.
 
 REST endpoints mounted automatically:
 
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| `GET` | `/_agent-native/resources?scope=all` | List resources |
-| `GET` | `/_agent-native/resources/tree?scope=all` | Get folder tree |
-| `POST` | `/_agent-native/resources` | Create a resource |
-| `GET` | `/_agent-native/resources/:id` | Get resource with content |
-| `PUT` | `/_agent-native/resources/:id` | Update a resource |
-| `DELETE` | `/_agent-native/resources/:id` | Delete a resource |
-| `POST` | `/_agent-native/resources/upload` | Upload a file as resource |
+| Method   | Endpoint                                  | Description               |
+| -------- | ----------------------------------------- | ------------------------- |
+| `GET`    | `/_agent-native/resources?scope=all`      | List resources            |
+| `GET`    | `/_agent-native/resources/tree?scope=all` | Get folder tree           |
+| `POST`   | `/_agent-native/resources`                | Create a resource         |
+| `GET`    | `/_agent-native/resources/:id`            | Get resource with content |
+| `PUT`    | `/_agent-native/resources/:id`            | Update a resource         |
+| `DELETE` | `/_agent-native/resources/:id`            | Delete a resource         |
+| `POST`   | `/_agent-native/resources/upload`         | Upload a file as resource |
 
 ### Action API {#script-api}
 
@@ -274,4 +326,4 @@ pnpm action resource-write --path "notes/meeting.md" --content "# Meeting Notes.
 
 # Delete a resource
 pnpm action resource-delete --path "notes/old.md"
-````
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.7.2",
+  "version": "0.7.6",
   "type": "module",
   "description": "Framework for agent-native application development — where AI agents and UI share state via files",
   "license": "MIT",
@@ -37,8 +37,15 @@
     "./resources/store": "./dist/resources/store.js",
     "./resources/metadata": "./dist/resources/metadata.js",
     "./oauth-tokens": "./dist/oauth-tokens/index.js",
+    "./secrets": "./dist/secrets/index.js",
     "./org": "./dist/org/index.js",
     "./client/org": "./dist/client/org/index.js",
+    "./sharing": "./dist/sharing/index.js",
+    "./sharing/actions/share-resource": "./dist/sharing/actions/share-resource.js",
+    "./sharing/actions/unshare-resource": "./dist/sharing/actions/unshare-resource.js",
+    "./sharing/actions/list-resource-shares": "./dist/sharing/actions/list-resource-shares.js",
+    "./sharing/actions/set-resource-visibility": "./dist/sharing/actions/set-resource-visibility.js",
+    "./client/sharing": "./dist/client/sharing/index.js",
     "./adapters/cli": "./dist/adapters/cli/index.js",
     "./router": "./dist/router/index.js",
     "./collab": "./dist/collab/index.js",
@@ -48,6 +55,7 @@
     "./terminal": "./dist/client/terminal/index.js",
     "./terminal/server": "./dist/terminal/index.js",
     "./tailwind": "./dist/tailwind.preset.js",
+    "./styles/agent-native.css": "./dist/styles/agent-native.css",
     "./tsconfig.base.json": "./tsconfig.base.json"
   },
   "files": [
@@ -57,7 +65,7 @@
     "src/templates"
   ],
   "scripts": {
-    "build": "tsc && rm -rf dist/templates && cp -r src/templates dist/templates",
+    "build": "tsc && rm -rf dist/templates && cp -r src/templates dist/templates && mkdir -p dist/styles && cp src/styles/*.css dist/styles/",
     "dev": "tsc --watch",
     "typecheck": "tsc --noEmit",
     "test": "vitest --run",
@@ -70,7 +78,7 @@
     "@clack/prompts": "^1.2.0",
     "@libsql/client": "^0.15.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@neondatabase/serverless": "^1.0.2",
+    "@neondatabase/serverless": "^1.1.0",
     "@radix-ui/react-popover": "^1.1.15",
     "@radix-ui/react-select": "^2.2.6",
     "@radix-ui/react-tooltip": "^1.2.8",
@@ -91,7 +99,7 @@
     "cron-parser": "^5.5.0",
     "diff-match-patch": "^1.0.5",
     "dotenv": "^17.2.1",
-    "drizzle-orm": "^0.44.0",
+    "drizzle-orm": "^0.45.2",
     "h3": "^2.0.1-rc.20",
     "isbot": "^5",
     "jose": "^6.2.2",
@@ -102,10 +110,12 @@
     "react-markdown": "^10.1.0",
     "react-router": "^7.13.1",
     "remark-gfm": "^4.0.1",
+    "shiki": "^4.0.2",
     "tailwind-merge": "^2.6.0",
     "tiptap-markdown": "^0.9.0",
     "y-protocols": "^1.0.7",
-    "yjs": "^13.6.30"
+    "yjs": "^13.6.30",
+    "zod": "^3.24.0"
   },
   "peerDependencies": {
     "@ai-sdk/anthropic": ">=1",
@@ -124,17 +134,15 @@
     "@xterm/addon-web-links": ">=0.11",
     "@xterm/xterm": ">=5",
     "ai": ">=4",
-    "autoprefixer": ">=10",
     "convex": ">=1",
     "node-pty": ">=1",
     "ollama-ai-provider": ">=1",
-    "postcss": ">=8",
     "postgres": ">=3",
     "react": ">=18",
     "react-dom": ">=18",
     "react-router": ">=7",
-    "tailwindcss": ">=3",
-    "tailwindcss-animate": ">=1",
+    "tailwindcss": ">=4",
+    "@tailwindcss/vite": ">=4",
     "typescript": ">=5",
     "vite": ">=5",
     "ws": ">=8"
@@ -173,13 +181,7 @@
     "tailwindcss": {
       "optional": true
     },
-    "tailwindcss-animate": {
-      "optional": true
-    },
-    "autoprefixer": {
-      "optional": true
-    },
-    "postcss": {
+    "@tailwindcss/vite": {
       "optional": true
     },
     "@vitejs/plugin-react-swc": {
@@ -243,11 +245,10 @@
     "express": "^5.2.1",
     "firebase-admin": "^13.0.0",
     "node-pty": "^1.1.0",
-    "postcss": "^8.5.6",
     "react": "^18.3.1",
     "react-router": "^7.13.1",
-    "tailwindcss": "^3.4.17",
-    "tailwindcss-animate": "^1.0.7",
+    "tailwindcss": "catalog:",
+    "@tailwindcss/vite": "catalog:",
     "typescript": "^5.9.2",
     "vite": "^8.0.0",
     "vitest": "^3.2.4",

package/src/templates/default/app/global.css

@@ -1,79 +1,76 @@
 @import url("https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap");
 
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
+@import "tailwindcss";
+@import "@agent-native/core/styles/agent-native.css";
 
-@layer base {
-  :root {
-    --background: 0 0% 100%;
-    --foreground: 220 10% 10%;
-    --card: 0 0% 100%;
-    --card-foreground: 220 10% 10%;
-    --popover: 0 0% 100%;
-    --popover-foreground: 220 10% 10%;
-    --primary: 220 10% 15%;
-    --primary-foreground: 0 0% 100%;
-    --secondary: 220 10% 95%;
-    --secondary-foreground: 220 10% 15%;
-    --muted: 220 10% 95%;
-    --muted-foreground: 220 5% 45%;
-    --accent: 220 10% 95%;
-    --accent-foreground: 220 10% 15%;
-    --destructive: 0 84% 60%;
-    --destructive-foreground: 0 0% 98%;
-    --border: 220 10% 90%;
-    --input: 220 10% 90%;
-    --ring: 220 10% 40%;
-    --radius: 0.5rem;
-    --sidebar-background: 220 10% 97%;
-    --sidebar-foreground: 220 5% 45%;
-    --sidebar-primary: 220 10% 15%;
-    --sidebar-primary-foreground: 0 0% 100%;
-    --sidebar-accent: 220 10% 95%;
-    --sidebar-accent-foreground: 220 10% 15%;
-    --sidebar-border: 220 10% 90%;
-    --sidebar-ring: 220 10% 40%;
-  }
+@source "./**/*.{ts,tsx}";
 
-  .dark {
-    --background: 220 6% 6%;
-    --foreground: 0 0% 90%;
-    --card: 220 5% 6%;
-    --card-foreground: 0 0% 90%;
-    --popover: 220 5% 6%;
-    --popover-foreground: 0 0% 90%;
-    --primary: 0 0% 75%;
-    --primary-foreground: 220 6% 6%;
-    --secondary: 220 4% 12%;
-    --secondary-foreground: 0 0% 90%;
-    --muted: 220 4% 10%;
-    --muted-foreground: 220 4% 60%;
-    --accent: 220 4% 13%;
-    --accent-foreground: 0 0% 90%;
-    --destructive: 0 63% 51%;
-    --destructive-foreground: 0 0% 98%;
-    --border: 220 4% 14%;
-    --input: 220 4% 14%;
-    --ring: 0 0% 60%;
-    --radius: 0.5rem;
-    --sidebar-background: 220 6% 4%;
-    --sidebar-foreground: 220 4% 60%;
-    --sidebar-primary: 0 0% 75%;
-    --sidebar-primary-foreground: 220 6% 6%;
-    --sidebar-accent: 220 4% 10%;
-    --sidebar-accent-foreground: 0 0% 90%;
-    --sidebar-border: 220 4% 10%;
-    --sidebar-ring: 0 0% 60%;
-  }
+:root {
+  --background: 0 0% 100%;
+  --foreground: 220 10% 10%;
+  --card: 0 0% 100%;
+  --card-foreground: 220 10% 10%;
+  --popover: 0 0% 100%;
+  --popover-foreground: 220 10% 10%;
+  --primary: 220 10% 15%;
+  --primary-foreground: 0 0% 100%;
+  --secondary: 220 10% 95%;
+  --secondary-foreground: 220 10% 15%;
+  --muted: 220 10% 95%;
+  --muted-foreground: 220 5% 45%;
+  --accent: 220 10% 95%;
+  --accent-foreground: 220 10% 15%;
+  --destructive: 0 84% 60%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 220 10% 90%;
+  --input: 220 10% 90%;
+  --ring: 220 10% 40%;
+  --radius: 0.5rem;
+  --sidebar-background: 220 10% 97%;
+  --sidebar-foreground: 220 5% 45%;
+  --sidebar-primary: 220 10% 15%;
+  --sidebar-primary-foreground: 0 0% 100%;
+  --sidebar-accent: 220 10% 95%;
+  --sidebar-accent-foreground: 220 10% 15%;
+  --sidebar-border: 220 10% 90%;
+  --sidebar-ring: 220 10% 40%;
+}
+
+.dark {
+  --background: 220 6% 6%;
+  --foreground: 0 0% 90%;
+  --card: 220 5% 6%;
+  --card-foreground: 0 0% 90%;
+  --popover: 220 5% 6%;
+  --popover-foreground: 0 0% 90%;
+  --primary: 0 0% 75%;
+  --primary-foreground: 220 6% 6%;
+  --secondary: 220 4% 12%;
+  --secondary-foreground: 0 0% 90%;
+  --muted: 220 4% 10%;
+  --muted-foreground: 220 4% 60%;
+  --accent: 220 4% 13%;
+  --accent-foreground: 0 0% 90%;
+  --destructive: 0 63% 51%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 220 4% 14%;
+  --input: 220 4% 14%;
+  --ring: 0 0% 60%;
+  --radius: 0.5rem;
+  --sidebar-background: 220 6% 4%;
+  --sidebar-foreground: 220 4% 60%;
+  --sidebar-primary: 0 0% 75%;
+  --sidebar-primary-foreground: 220 6% 6%;
+  --sidebar-accent: 220 4% 10%;
+  --sidebar-accent-foreground: 0 0% 90%;
+  --sidebar-border: 220 4% 10%;
+  --sidebar-ring: 0 0% 60%;
 }
 
 @layer base {
-  * {
-    @apply border-border;
-  }
   body {
-    @apply bg-background text-foreground;
+    background: hsl(var(--background));
+    color: hsl(var(--foreground));
     font-family: "Inter", sans-serif;
     font-feature-settings: "cv02", "cv03", "cv04", "cv11";
   }

package/src/templates/default/components.json

@@ -4,7 +4,7 @@
   "rsc": false,
   "tsx": true,
   "tailwind": {
-    "config": "tailwind.config.ts",
+    "config": "",
     "css": "app/global.css",
     "baseColor": "slate",
     "cssVariables": true,

package/src/templates/default/package.json

@@ -21,24 +21,22 @@
   "devDependencies": {
     "@react-router/dev": "^7.13.1",
     "@react-router/fs-routes": "^7.13.1",
+    "@tailwindcss/vite": "^4.1.18",
     "@tanstack/react-query": "^5.84.2",
     "@types/node": "^24.2.1",
     "@types/react": "^18.3.23",
     "@types/react-dom": "^18.3.7",
-    "autoprefixer": "^10.4.21",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.539.0",
     "next-themes": "^0.4.6",
-    "postcss": "^8.5.6",
     "prettier": "^3.6.2",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-router": "^7.13.1",
     "sonner": "^1.7.4",
     "tailwind-merge": "^2.6.0",
-    "tailwindcss": "^3.4.17",
-    "tailwindcss-animate": "^1.0.7",
+    "tailwindcss": "^4.1.18",
     "tsx": "^4.20.3",
     "typescript": "^5.9.2",
     "vite": "^7.1.2"

package/src/templates/default/vite.config.ts

@@ -3,4 +3,7 @@ import { defineConfig } from "@agent-native/core/vite";
 
 export default defineConfig({
   plugins: [reactRouter()],
+  // shiki only runs in AssistantChat's useEffect — keep it out of the
+  // CF Pages Functions bundle (25 MiB limit).
+  ssrStubs: ["shiki"],
 });

package/src/templates/workspace-core/package.json

@@ -20,10 +20,7 @@
       "types": "./src/credentials.ts",
       "default": "./src/credentials.ts"
     },
-    "./tailwind": {
-      "types": "./tailwind.preset.ts",
-      "default": "./tailwind.preset.ts"
-    }
+    "./styles/tokens.css": "./styles/tokens.css"
   },
   "dependencies": {
     "@agent-native/core": "^0.6.0"

package/src/templates/workspace-core/src/index.ts

@@ -7,7 +7,7 @@
  *   - Shared agent actions — see actions/
  *   - Shared agent skills — see skills/
  *   - Enterprise-wide agent instructions — see AGENTS.md
- *   - Shared Tailwind preset — see tailwind.preset.ts
+ *   - Shared Tailwind v4 design tokens — see styles/tokens.css
  *
  * Apps don't import from this root entry directly — they import from
  * the specific sub-path they need:

package/src/templates/workspace-core/styles/tokens.css

@@ -0,0 +1,22 @@
+/**
+ * Workspace-wide Tailwind v4 design tokens for @{{APP_NAME}}/core-module.
+ *
+ * Every app in the workspace should import this from its own
+ * `app/global.css` so brand updates in one place propagate to all apps:
+ *
+ *   @import "tailwindcss";
+ *   @import "@{{APP_NAME}}/core-module/styles/tokens.css";
+ *
+ * Replace the values below with your real brand palette.
+ */
+
+/* Re-export the framework's standard token mappings (color-background,
+   color-foreground, color-border, …) so apps don't need a second import. */
+@import "@agent-native/core/styles/agent-native.css";
+
+@theme {
+  /* Add enterprise brand colors here. They become utility classes:
+     `bg-brand`, `text-brand-foreground`, etc. */
+  --color-brand: #4f46e5;
+  --color-brand-foreground: #ffffff;
+}

package/src/templates/workspace-core/tsconfig.json

@@ -5,5 +5,5 @@
     "outDir": "dist",
     "noEmit": true
   },
-  "include": ["src/**/*", "tailwind.preset.ts"]
+  "include": ["src/**/*"]
 }

package/dist/templates/default/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-};

package/dist/templates/default/tailwind.config.ts

@@ -1,7 +0,0 @@
-import type { Config } from "tailwindcss";
-import preset from "@agent-native/core/tailwind";
-
-export default {
-  presets: [preset],
-  content: ["./app/**/*.{ts,tsx}"],
-} satisfies Config;

package/dist/templates/workspace-core/tailwind.preset.ts

@@ -1,34 +0,0 @@
-/**
- * Workspace-wide Tailwind preset for @{{APP_NAME}}/core-module.
- *
- * Extends the framework's base preset with enterprise brand tokens. Every
- * app in the workspace should import THIS preset in its own
- * tailwind.config.ts instead of importing @agent-native/core/tailwind
- * directly, so brand updates in one place propagate to all apps.
- *
- *   // apps/<name>/tailwind.config.ts
- *   import preset from "@{{APP_NAME}}/core-module/tailwind";
- *   export default { presets: [preset], content: ["./app/**\/*.{ts,tsx}"] };
- *
- * If your enterprise already has a design-system package with its own
- * Tailwind preset, swap `corePreset` out for that one (or chain both).
- */
-import corePreset from "@agent-native/core/tailwind";
-import type { Config } from "tailwindcss";
-
-const preset: Partial<Config> = {
-  presets: [corePreset],
-  theme: {
-    extend: {
-      colors: {
-        // Replace with your actual brand palette.
-        brand: {
-          DEFAULT: "#4f46e5",
-          foreground: "#ffffff",
-        },
-      },
-    },
-  },
-};
-
-export default preset;

package/src/templates/default/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-};

package/src/templates/default/tailwind.config.ts

@@ -1,7 +0,0 @@
-import type { Config } from "tailwindcss";
-import preset from "@agent-native/core/tailwind";
-
-export default {
-  presets: [preset],
-  content: ["./app/**/*.{ts,tsx}"],
-} satisfies Config;