@uniweb/templates 0.1.1 → 0.1.3

package/README.md

@@ -134,7 +134,7 @@ Binary files (images, fonts, etc.) are copied as-is.
 
 ### Critical: Package Dependencies
 
-**The site package MUST include the foundation as a workspace dependency:**
+**The site package MUST include the foundation as a local dependency:**
 
 ```json
 // site/package.json.hbs
@@ -142,20 +142,54 @@ Binary files (images, fonts, etc.) are copied as-is.
   "name": "site",
   "dependencies": {
     "@uniweb/runtime": "^0.1.0",
-    "foundation": "workspace:*"
+    "foundation": "file:../foundation"
   }
 }
 ```
 
-This `"foundation": "workspace:*"` entry is essential because:
-1. pnpm creates a symlink at `site/node_modules/foundation` pointing to the workspace foundation
+This `"foundation": "file:../foundation"` entry is essential because:
+1. Both npm and pnpm create a symlink at `site/node_modules/foundation` pointing to the sibling foundation
 2. Vite's `#foundation` alias resolves to the `foundation` module
 3. Without this, the site build will fail with "Could not load foundation"
 
+**Important:** Use `file:` protocol, not `workspace:*`. The `workspace:*` protocol is pnpm-specific and will fail with npm.
+
 **Use fixed package names:**
 - Foundation: `"name": "foundation"` (not `{{projectName}}-foundation`)
 - Site: `"name": "site"` (not `{{projectName}}-site`)
 
+### Root package.json Requirements
+
+The root `package.json.hbs` must include workspace configuration for both npm and pnpm:
+
+```json
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "pnpm --filter site dev",
+    "dev:runtime": "VITE_FOUNDATION_MODE=runtime pnpm --filter site dev",
+    "build": "pnpm -r build",
+    "preview": "pnpm --filter site preview"
+  },
+  "workspaces": [
+    "site",
+    "foundation",
+    "sites/*",
+    "foundations/*"
+  ],
+  "pnpm": {
+    "onlyBuiltDependencies": ["esbuild", "sharp"]
+  }
+}
+```
+
+**Required fields:**
+- `workspaces` - Enables npm workspace linking (required for `file:` dependencies to work)
+- `pnpm.onlyBuiltDependencies` - Prevents pnpm from rebuilding native modules on every install
+
 This matches how the CLI's built-in templates work and ensures the workspace linking functions correctly.
 
 ### Workspace Configuration
@@ -234,10 +268,11 @@ Key testing points:
 
 - [ ] Create `templates/<name>/template.json` with required `name` field
 - [ ] Create `templates/<name>/template/` directory structure
+- [ ] Include root `package.json.hbs` with `workspaces` array and `pnpm.onlyBuiltDependencies`
+- [ ] Include `pnpm-workspace.yaml` with workspace packages
 - [ ] Include both `foundation/` and `site/` packages
-- [ ] Add `"foundation": "workspace:*"` to site's dependencies
+- [ ] Add `"foundation": "file:../foundation"` to site's dependencies (not `workspace:*`)
 - [ ] Use fixed names: `"name": "foundation"` and `"name": "site"`
-- [ ] Include `pnpm-workspace.yaml` with workspace packages
 - [ ] Add `.hbs` extension to files needing variable substitution
 - [ ] Include sample content in `site/pages/`
 - [ ] Create meaningful component metadata in `foundation/src/components/*/meta.js`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/templates",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Template processing engine and official templates for Uniweb",
   "type": "module",
   "main": "src/index.js",
@@ -29,4 +29,4 @@
   "dependencies": {
     "handlebars": "^4.7.8"
   }
-}
+}

package/templates/marketing/template/package.json.hbs

@@ -1,13 +1,21 @@
 {
   "name": "{{projectName}}",
+  "version": "0.1.0",
   "private": true,
   "type": "module",
   "scripts": {
     "dev": "pnpm --filter site dev",
-    "dev:runtime": "pnpm --filter site dev:runtime",
-    "build": "pnpm --filter foundation build && pnpm --filter site build",
-    "build:foundation": "pnpm --filter foundation build",
-    "build:site": "pnpm --filter site build",
+    "dev:runtime": "VITE_FOUNDATION_MODE=runtime pnpm --filter site dev",
+    "build": "pnpm -r build",
     "preview": "pnpm --filter site preview"
+  },
+  "workspaces": [
+    "site",
+    "foundation",
+    "sites/*",
+    "foundations/*"
+  ],
+  "pnpm": {
+    "onlyBuiltDependencies": ["esbuild", "sharp"]
   }
 }

package/templates/marketing/template/site/package.json.hbs

@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@uniweb/runtime": "^0.1.0",
-    "foundation": "workspace:*"
+    "foundation": "file:../foundation"
   },
   "devDependencies": {
     "@vitejs/plugin-react": "^4.2.1",