fix: restore docs deleted in v0.2.3 release, add Paperclip branding

- Restored docs/ directory that was accidentally deleted by `git add -A` in the v0.2.3 release script - Replaced generic "P" favicon with actual paperclip icon using brand primary color (#2563EB) - Added light/dark logo SVGs for Mintlify navbar (paperclip icon + wordmark) - Updated docs.json with logo configuration for dark/light mode - Fixed release.sh to stage only release-related files instead of `git add -A` to prevent sweeping unrelated changes into release commits Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
fix: bundle UI dist into server package for npm publishing
2026-03-03 15:49:43 -06:00 · 2026-03-03 15:45:45 -06:00 · 2026-03-03 15:39:13 -06:00
23 changed files with 132 additions and 23 deletions
--- a/cli/CHANGELOG.md
+++ b/cli/CHANGELOG.md
@@ -1,5 +1,19 @@
 # paperclipai

+## 0.2.3
+
+### Patch Changes
+
+- Version bump (patch)
+- Updated dependencies
+  - @paperclipai/shared@0.2.3
+  - @paperclipai/adapter-utils@0.2.3
+  - @paperclipai/db@0.2.3
+  - @paperclipai/adapter-claude-local@0.2.3
+  - @paperclipai/adapter-codex-local@0.2.3
+  - @paperclipai/adapter-openclaw@0.2.3
+  - @paperclipai/server@0.2.3
+
 ## 0.2.2

 ### Patch Changes
--- a/cli/package.json
+++ b/cli/package.json
@@ -1,6 +1,6 @@
 {
  "name": "paperclipai",
-  "version": "0.2.2",
+  "version": "0.2.3",
  "description": "Paperclip CLI — orchestrate AI agent teams to run a business",
  "type": "module",
  "bin": {
--- a/cli/src/index.ts
+++ b/cli/src/index.ts
@@ -23,7 +23,7 @@ const DATA_DIR_OPTION_HELP =
 program
  .name("paperclipai")
  .description("Paperclip CLI — setup, diagnose, and configure your instance")
-  .version("0.2.2");
+  .version("0.2.3");

 program.hook("preAction", (_thisCommand, actionCommand) => {
  const options = actionCommand.optsWithGlobals() as DataDirOptionLike;
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -9,6 +9,10 @@
    "dark": "#1D4ED8"
  },
  "favicon": "/favicon.svg",
+  "logo": {
+    "dark": "/images/logo-dark.svg",
+    "light": "/images/logo-light.svg"
+  },
  "topbarLinks": [
    {
      "name": "GitHub",
--- a/docs/favicon.svg
+++ b/docs/favicon.svg
@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none">
-  <rect width="32" height="32" rx="6" fill="#2563EB"/>
-  <path d="M10 8h6a6 6 0 0 1 0 12h-2v4h-4V8zm4 8h2a2 2 0 0 0 0-4h-2v4z" fill="white"/>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-4 -4 32 32" fill="none" stroke-linecap="round" stroke-linejoin="round">
+  <rect x="-4" y="-4" width="32" height="32" rx="6" fill="#2563EB"/>
+  <path stroke="#ffffff" stroke-width="2" d="m16 6-8.414 8.586a2 2 0 0 0 2.829 2.829l8.414-8.586a4 4 0 1 0-5.657-5.657l-8.379 8.551a6 6 0 1 0 8.485 8.485l8.379-8.551"/>
 </svg>
--- a/docs/images/logo-dark.svg
+++ b/docs/images/logo-dark.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="140" height="32" viewBox="0 0 140 32" fill="none">
+  <g stroke-linecap="round" stroke-linejoin="round">
+    <path stroke="#e4e4e7" stroke-width="2" d="m18 4-8.414 8.586a2 2 0 0 0 2.829 2.829l8.414-8.586a4 4 0 1 0-5.657-5.657l-8.379 8.551a6 6 0 1 0 8.485 8.485l8.379-8.551"/>
+  </g>
+  <text x="32" y="22" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="600" fill="#e4e4e7">Paperclip</text>
+</svg>
--- a/docs/images/logo-light.svg
+++ b/docs/images/logo-light.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="140" height="32" viewBox="0 0 140 32" fill="none">
+  <g stroke-linecap="round" stroke-linejoin="round">
+    <path stroke="#18181b" stroke-width="2" d="m18 4-8.414 8.586a2 2 0 0 0 2.829 2.829l8.414-8.586a4 4 0 1 0-5.657-5.657l-8.379 8.551a6 6 0 1 0 8.485 8.485l8.379-8.551"/>
+  </g>
+  <text x="32" y="22" font-family="system-ui, -apple-system, sans-serif" font-size="18" font-weight="600" fill="#18181b">Paperclip</text>
+</svg>
--- a/packages/adapter-utils/CHANGELOG.md
+++ b/packages/adapter-utils/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @paperclipai/adapter-utils

+## 0.2.3
+
+### Patch Changes
+
+- Version bump (patch)
+
 ## 0.2.2

 ### Patch Changes
--- a/packages/adapter-utils/package.json
+++ b/packages/adapter-utils/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@paperclipai/adapter-utils",
-  "version": "0.2.2",
+  "version": "0.2.3",
  "type": "module",
  "exports": {
    ".": "./src/index.ts",
--- a/packages/adapters/claude-local/CHANGELOG.md
+++ b/packages/adapters/claude-local/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @paperclipai/adapter-claude-local

+## 0.2.3
+
+### Patch Changes
+
+- Version bump (patch)
+- Updated dependencies
+  - @paperclipai/adapter-utils@0.2.3
+
 ## 0.2.2

 ### Patch Changes
--- a/packages/adapters/claude-local/package.json
+++ b/packages/adapters/claude-local/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@paperclipai/adapter-claude-local",
-  "version": "0.2.2",
+  "version": "0.2.3",
  "type": "module",
  "exports": {
    ".": "./src/index.ts",
--- a/packages/adapters/codex-local/CHANGELOG.md
+++ b/packages/adapters/codex-local/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @paperclipai/adapter-codex-local

+## 0.2.3
+
+### Patch Changes
+
+- Version bump (patch)
+- Updated dependencies
+  - @paperclipai/adapter-utils@0.2.3
+
 ## 0.2.2

 ### Patch Changes
--- a/packages/adapters/codex-local/package.json
+++ b/packages/adapters/codex-local/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@paperclipai/adapter-codex-local",
-  "version": "0.2.2",
+  "version": "0.2.3",
  "type": "module",
  "exports": {
    ".": "./src/index.ts",
--- a/packages/adapters/openclaw/CHANGELOG.md
+++ b/packages/adapters/openclaw/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @paperclipai/adapter-openclaw

+## 0.2.3
+
+### Patch Changes
+
+- Version bump (patch)
+- Updated dependencies
+  - @paperclipai/adapter-utils@0.2.3
+
 ## 0.2.2

 ### Patch Changes
--- a/packages/adapters/openclaw/package.json
+++ b/packages/adapters/openclaw/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@paperclipai/adapter-openclaw",
-  "version": "0.2.2",
+  "version": "0.2.3",
  "type": "module",
  "exports": {
    ".": "./src/index.ts",
--- a/packages/db/CHANGELOG.md
+++ b/packages/db/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @paperclipai/db

+## 0.2.3
+
+### Patch Changes
+
+- Version bump (patch)
+- Updated dependencies
+  - @paperclipai/shared@0.2.3
+
 ## 0.2.2

 ### Patch Changes
--- a/packages/db/package.json
+++ b/packages/db/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@paperclipai/db",
-  "version": "0.2.2",
+  "version": "0.2.3",
  "type": "module",
  "exports": {
    ".": "./src/index.ts",
--- a/packages/shared/CHANGELOG.md
+++ b/packages/shared/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @paperclipai/shared

+## 0.2.3
+
+### Patch Changes
+
+- Version bump (patch)
+
 ## 0.2.2

 ### Patch Changes
--- a/packages/shared/package.json
+++ b/packages/shared/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@paperclipai/shared",
-  "version": "0.2.2",
+  "version": "0.2.3",
  "type": "module",
  "exports": {
    ".": "./src/index.ts",
--- a/scripts/release.sh
+++ b/scripts/release.sh
@@ -125,7 +125,7 @@ echo ""
 echo "==> Step 4/7: Building all packages..."
 cd "$REPO_ROOT"

-# Build packages in dependency order (excluding UI and CLI)
+# Build packages in dependency order (excluding CLI)
 pnpm --filter @paperclipai/shared build
 pnpm --filter @paperclipai/adapter-utils build
 pnpm --filter @paperclipai/db build
@@ -133,7 +133,12 @@ pnpm --filter @paperclipai/adapter-claude-local build
 pnpm --filter @paperclipai/adapter-codex-local build
 pnpm --filter @paperclipai/adapter-openclaw build
 pnpm --filter @paperclipai/server build
-echo "  ✓ All packages built"
+
+# Build UI and bundle into server package for static serving
+pnpm --filter @paperclipai/ui build
+rm -rf "$REPO_ROOT/server/ui-dist"
+cp -r "$REPO_ROOT/ui/dist" "$REPO_ROOT/server/ui-dist"
+echo "  ✓ All packages built (including UI)"

 # ── Step 5: Build CLI bundle ─────────────────────────────────────────────────

@@ -183,8 +188,16 @@ if [ -f "$CLI_DIR/README.md" ]; then
  rm "$CLI_DIR/README.md"
 fi

-# Commit all changes
-git add -A
+# Remove UI dist bundled into server for publishing
+rm -rf "$REPO_ROOT/server/ui-dist"
+
+# Stage only release-related files (avoid sweeping unrelated changes with -A)
+git add \
+  .changeset/ \
+  '**/CHANGELOG.md' \
+  '**/package.json' \
+  cli/src/index.ts \
+  server/ui-dist
 git commit -m "chore: release v$NEW_VERSION"
 git tag "v$NEW_VERSION"
 echo "  ✓ Committed and tagged v$NEW_VERSION"
--- a/server/CHANGELOG.md
+++ b/server/CHANGELOG.md
@@ -1,5 +1,18 @@
 # @paperclipai/server

+## 0.2.3
+
+### Patch Changes
+
+- Version bump (patch)
+- Updated dependencies
+  - @paperclipai/shared@0.2.3
+  - @paperclipai/adapter-utils@0.2.3
+  - @paperclipai/db@0.2.3
+  - @paperclipai/adapter-claude-local@0.2.3
+  - @paperclipai/adapter-codex-local@0.2.3
+  - @paperclipai/adapter-openclaw@0.2.3
+
 ## 0.2.2

 ### Patch Changes
--- a/server/package.json
+++ b/server/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@paperclipai/server",
-  "version": "0.2.2",
+  "version": "0.2.3",
  "type": "module",
  "exports": {
    ".": "./src/index.ts"
@@ -17,7 +17,8 @@
    "types": "./dist/index.d.ts"
  },
  "files": [
-    "dist"
+    "dist",
+    "ui-dist"
  ],
  "scripts": {
    "dev": "tsx src/index.ts",
--- a/server/src/app.ts
+++ b/server/src/app.ts
@@ -124,12 +124,20 @@ export async function createApp(

  const __dirname = path.dirname(fileURLToPath(import.meta.url));
  if (opts.uiMode === "static") {
-    // Serve built UI from ui/dist in production.
-    const uiDist = path.resolve(__dirname, "../../ui/dist");
+    // Try published location first (server/ui-dist/), then monorepo dev location (../../ui/dist)
+    const candidates = [
+      path.resolve(__dirname, "../ui-dist"),
+      path.resolve(__dirname, "../../ui/dist"),
+    ];
+    const uiDist = candidates.find((p) => fs.existsSync(path.join(p, "index.html")));
+    if (uiDist) {
      app.use(express.static(uiDist));
      app.get(/.*/, (_req, res) => {
        res.sendFile(path.join(uiDist, "index.html"));
      });
+    } else {
+      console.warn("[paperclip] UI dist not found; running in API-only mode");
+    }
  }

  if (opts.uiMode === "vite-dev") {