uniweb 0.2.14 → 0.2.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -35,6 +35,6 @@
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/build": "0.1.6"
+    "@uniweb/build": "0.1.8"
   }
 }

package/src/index.js

@@ -12,7 +12,7 @@
  *   npx uniweb docs                          # Generate COMPONENTS.md from schema
  */
 
-import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs'
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync } from 'node:fs'
 import { resolve, join, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import prompts from 'prompts'
@@ -27,6 +27,7 @@ import {
   listAvailableTemplates,
   BUILTIN_TEMPLATES,
 } from './templates/index.js'
+import { copyTemplateDirectory, registerVersions } from './templates/processor.js'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 
@@ -57,16 +58,83 @@ function title(message) {
   console.log(`\n${colors.cyan}${colors.bright}${message}${colors.reset}\n`)
 }
 
-// Template definitions
+// Built-in template definitions (metadata for display)
 const templates = {
   single: {
     name: 'Single Project',
     description: 'One site + one foundation in site/ and foundation/ (recommended)',
   },
   multi: {
-    name: 'Multi-Site Project',
+    name: 'Multi-Site Workspace',
     description: 'Multiple sites and foundations in sites/* and foundations/*',
   },
+  template: {
+    name: 'Template Starter',
+    description: 'Create a shareable Uniweb template for npm or GitHub',
+  },
+}
+
+/**
+ * Get the path to a built-in template
+ */
+function getBuiltinTemplatePath(templateName) {
+  return join(__dirname, '..', 'templates', templateName)
+}
+
+/**
+ * Get the shared base template path
+ */
+function getSharedTemplatePath() {
+  return join(__dirname, '..', 'templates', '_shared')
+}
+
+/**
+ * Apply a built-in template using file-based templates
+ */
+async function applyBuiltinTemplate(templateName, targetPath, options = {}) {
+  const { projectName, variant, onProgress, onWarning } = options
+
+  const templatePath = getBuiltinTemplatePath(templateName)
+
+  // Load template.json for metadata
+  let templateConfig = {}
+  const configPath = join(templatePath, 'template.json')
+  if (existsSync(configPath)) {
+    templateConfig = JSON.parse(readFileSync(configPath, 'utf8'))
+  }
+
+  // Determine base template path if specified
+  let basePath = null
+  if (templateConfig.base) {
+    basePath = join(__dirname, '..', 'templates', templateConfig.base)
+    if (!existsSync(basePath)) {
+      if (onWarning) {
+        onWarning(`Base template '${templateConfig.base}' not found at ${basePath}`)
+      }
+      basePath = null
+    }
+  }
+
+  // Register versions for Handlebars templates
+  registerVersions(getVersionsForTemplates())
+
+  // Prepare template data
+  const templateData = {
+    projectName: projectName || 'my-project',
+    templateName: templateName,
+    templateTitle: projectName || 'My Project',
+    templateDescription: templateConfig.description || 'A Uniweb project',
+  }
+
+  // Copy template files
+  await copyTemplateDirectory(templatePath, targetPath, templateData, {
+    variant,
+    basePath,
+    onProgress,
+    onWarning,
+  })
+
+  success(`Created project: ${projectName || 'my-project'}`)
 }
 
 async function main() {
@@ -167,6 +235,11 @@ async function main() {
           description: templates.multi.description,
           value: 'multi',
         },
+        {
+          title: templates.template.name,
+          description: templates.template.description,
+          value: 'template',
+        },
       ],
     },
   ], {
@@ -196,17 +269,16 @@ async function main() {
   const parsed = parseTemplateId(templateType)
 
   if (parsed.type === 'builtin') {
-    log(`\nCreating ${templates[templateType].name.toLowerCase()}...`)
-
-    // Generate project based on built-in template
-    switch (templateType) {
-      case 'single':
-        await createSingleProject(projectDir, projectName)
-        break
-      case 'multi':
-        await createMultiProject(projectDir, projectName)
-        break
-    }
+    const templateMeta = templates[templateType]
+    log(`\nCreating ${templateMeta ? templateMeta.name.toLowerCase() : templateType}...`)
+
+    // Apply file-based built-in template
+    await applyBuiltinTemplate(templateType, projectDir, {
+      projectName: displayName || projectName,
+      variant,
+      onProgress: (msg) => log(`  ${colors.dim}${msg}${colors.reset}`),
+      onWarning: (msg) => log(`  ${colors.yellow}Warning: ${msg}${colors.reset}`),
+    })
   } else {
     // External template (official, npm, or github)
     log(`\nResolving template: ${templateType}...`)
@@ -278,6 +350,7 @@ ${colors.bright}i18n Commands:${colors.reset}
 ${colors.bright}Template Types:${colors.reset}
   single                        One site + one foundation (default)
   multi                         Multiple sites and foundations
+  template                      Starter for creating shareable templates
   marketing                     Official marketing template
   @scope/template-name          npm package
   github:user/repo              GitHub repository
@@ -296,1014 +369,6 @@ ${colors.bright}Examples:${colors.reset}
 `)
 }
 
-// Template generators
-
-/**
- * Creates the common project base: package.json, pnpm-workspace.yaml, .gitignore
- * Both single and multi templates share the same workspace configuration.
- */
-function createProjectBase(projectDir, projectName, defaultFilter) {
-  mkdirSync(projectDir, { recursive: true })
-
-  // Root package.json (workspaces field for npm compatibility)
-  writeJSON(join(projectDir, 'package.json'), {
-    name: projectName,
-    version: '0.1.0',
-    private: true,
-    type: 'module',
-    scripts: {
-      dev: `pnpm --filter ${defaultFilter} dev`,
-      'dev:runtime': `VITE_FOUNDATION_MODE=runtime pnpm --filter ${defaultFilter} dev`,
-      build: 'pnpm -r build',
-    },
-    workspaces: [
-      'site',
-      'foundation',
-      'sites/*',
-      'foundations/*',
-    ],
-    pnpm: {
-      onlyBuiltDependencies: ['esbuild', 'sharp'],
-    },
-  })
-
-  // pnpm-workspace.yaml (all patterns for seamless evolution)
-  writeFile(join(projectDir, 'pnpm-workspace.yaml'), `packages:
-  - 'site'
-  - 'foundation'
-  - 'sites/*'
-  - 'foundations/*'
-`)
-
-  // .gitignore
-  writeFile(join(projectDir, '.gitignore'), `node_modules
-dist
-.DS_Store
-*.local
-`)
-}
-
-/**
- * Creates a single project with site/ and foundation/ as sibling packages.
- * This is the default template for new projects.
- */
-async function createSingleProject(projectDir, projectName) {
-  createProjectBase(projectDir, projectName, 'site')
-
-  // README.md
-  writeFile(join(projectDir, 'README.md'), `# ${projectName}
-
-Structured Vite + React, ready to go.
-
-## Quick Start
-
-\`\`\`bash
-pnpm install
-pnpm dev
-\`\`\`
-
-Open [http://localhost:3000](http://localhost:3000) to see your site.
-
-## Project Structure
-
-\`\`\`
-${projectName}/
-├── site/                     # Content + configuration
-│   ├── pages/                # File-based routing
-│   │   └── home/
-│   │       ├── page.yml      # Page metadata
-│   │       └── 1-hero.md     # Section content
-│   ├── locales/              # i18n (mirrors pages/)
-│   ├── src/                  # Site entry point
-│   └── public/               # Static assets
-│
-├── foundation/               # Your components
-│   └── src/
-│       ├── components/       # React components
-│       ├── meta.js           # Foundation metadata
-│       └── styles.css        # Tailwind styles
-│
-├── package.json
-└── pnpm-workspace.yaml
-\`\`\`
-
-## Development
-
-### Standard Mode (recommended)
-
-\`\`\`bash
-pnpm dev
-\`\`\`
-
-Edit components in \`foundation/src/components/\` and see changes instantly via HMR.
-Edit content in \`site/pages/\` to add or modify pages.
-
-### Runtime Loading Mode
-
-\`\`\`bash
-pnpm dev:runtime
-\`\`\`
-
-Tests production behavior where the foundation is loaded as a separate module.
-Use this to debug issues that only appear in production.
-
-## Building for Production
-
-\`\`\`bash
-pnpm build
-\`\`\`
-
-**Output:**
-- \`foundation/dist/\` — Bundled components, CSS, and schema.json
-- \`site/dist/\` — Production-ready static site
-
-## Adding Components
-
-1. Create a new folder in \`foundation/src/components/YourComponent/\`
-2. Add \`index.jsx\` with your React component
-3. Add \`meta.js\` describing the component's content slots and options
-4. Export from \`foundation/src/index.js\`
-
-## Adding Pages
-
-1. Create a folder in \`site/pages/your-page/\`
-2. Add \`page.yml\` with page metadata
-3. Add markdown files (\`1-section.md\`, \`2-section.md\`, etc.) for each section
-
-Each markdown file specifies which component to use:
-
-\`\`\`markdown
----
-type: Hero
-theme: dark
----
-
-# Your Title
-
-Your subtitle or description here.
-
-[Get Started](#)
-\`\`\`
-
-## Scaling Up
-
-The workspace is pre-configured for growth—no config changes needed.
-
-**Add a second site** (keep existing structure):
-
-\`\`\`bash
-mkdir -p sites/docs
-# Create your docs site in sites/docs/
-\`\`\`
-
-**Or migrate to multi-site structure**:
-
-\`\`\`bash
-# Move and rename by purpose
-mv site sites/marketing
-mv foundation foundations/marketing
-
-# Update package names in package.json files
-# Update dependencies to reference new names
-\`\`\`
-
-Both patterns work simultaneously—evolve gradually as needed.
-
-## Publishing Your Foundation
-
-Your \`foundation/\` is already a complete package:
-
-\`\`\`bash
-cd foundation
-npx uniweb build
-npm publish
-\`\`\`
-
-## What is Uniweb?
-
-Uniweb is a **Component Web Platform** that bridges content and components.
-Foundations define the vocabulary (available components, options, design rules).
-Sites provide content that flows through Foundations.
-
-Learn more:
-- [Uniweb on GitHub](https://github.com/uniweb)
-- [CLI Documentation](https://github.com/uniweb/cli)
-- [uniweb.app](https://uniweb.app) — Visual editing platform
-
-`)
-
-  // Create site package
-  await createSite(join(projectDir, 'site'), 'site', true)
-
-  // Create foundation package
-  await createFoundation(join(projectDir, 'foundation'), 'foundation', true)
-
-  // Update site to reference workspace foundation
-  const sitePackageJson = join(projectDir, 'site/package.json')
-  const sitePkg = JSON.parse(readFile(sitePackageJson))
-  sitePkg.dependencies['foundation'] = 'file:../foundation'
-  writeJSON(sitePackageJson, sitePkg)
-
-  success(`Created project: ${projectName}`)
-}
-
-/**
- * Creates a multi-site/foundation workspace with sites/ and foundations/ directories.
- * Used for larger projects with multiple sites sharing foundations.
- */
-async function createMultiProject(projectDir, projectName) {
-  createProjectBase(projectDir, projectName, 'marketing')
-
-  // README.md
-  writeFile(join(projectDir, 'README.md'), `# ${projectName}
-
-A Uniweb workspace for multiple sites and foundations.
-
-## Quick Start
-
-\`\`\`bash
-pnpm install
-pnpm dev
-\`\`\`
-
-Open [http://localhost:3000](http://localhost:3000) to see the marketing site.
-
-## Project Structure
-
-\`\`\`
-${projectName}/
-├── sites/
-│   └── marketing/            # Main marketing site
-│       ├── pages/            # Content pages
-│       ├── locales/          # i18n
-│       └── src/
-│
-├── foundations/
-│   └── marketing/            # Marketing foundation
-│       └── src/
-│           ├── components/   # React components
-│           └── styles.css    # Tailwind styles
-│
-├── package.json
-└── pnpm-workspace.yaml
-\`\`\`
-
-## Development
-
-\`\`\`bash
-# Run the marketing site (default)
-pnpm dev
-
-# Run a specific site
-pnpm --filter docs dev
-
-# Runtime loading mode (tests production behavior)
-pnpm dev:runtime
-\`\`\`
-
-## Adding More Sites
-
-Create a new site in \`sites/\`:
-
-\`\`\`bash
-mkdir -p sites/docs
-# Copy structure from sites/marketing or create manually
-\`\`\`
-
-Update \`sites/docs/site.yml\` to specify which foundation:
-
-\`\`\`yaml
-name: docs
-defaultLanguage: en
-foundation: documentation    # Or marketing, or any foundation
-\`\`\`
-
-## Adding More Foundations
-
-Create a new foundation in \`foundations/\`:
-
-\`\`\`bash
-mkdir -p foundations/documentation
-# Build components for documentation use case
-\`\`\`
-
-Name foundations by purpose: marketing, documentation, learning, etc.
-
-## Building for Production
-
-\`\`\`bash
-# Build everything
-pnpm build
-
-# Build specific packages
-pnpm --filter marketing build
-pnpm --filter foundations/marketing build
-\`\`\`
-
-## Learn More
-
-- [Uniweb on GitHub](https://github.com/uniweb)
-- [uniweb.app](https://uniweb.app) — Visual editing platform
-
-`)
-
-  // Create first site in sites/marketing
-  await createSite(join(projectDir, 'sites/marketing'), 'marketing', true)
-
-  // Create first foundation in foundations/marketing
-  await createFoundation(join(projectDir, 'foundations/marketing'), 'marketing', true)
-
-  // Update site to reference workspace foundation
-  const sitePackageJson = join(projectDir, 'sites/marketing/package.json')
-  const sitePkg = JSON.parse(readFile(sitePackageJson))
-  sitePkg.dependencies['marketing'] = 'file:../../foundations/marketing'
-  writeJSON(sitePackageJson, sitePkg)
-
-  // Update site.yml to reference the marketing foundation
-  writeFile(join(projectDir, 'sites/marketing/site.yml'), `name: marketing
-defaultLanguage: en
-
-# Foundation to use for this site
-foundation: marketing
-`)
-
-  success(`Created workspace: ${projectName}`)
-}
-
-async function createSite(projectDir, projectName, isWorkspace = false) {
-  mkdirSync(projectDir, { recursive: true })
-  mkdirSync(join(projectDir, 'src'), { recursive: true })
-  mkdirSync(join(projectDir, 'pages/home'), { recursive: true })
-
-  // package.json
-  writeJSON(join(projectDir, 'package.json'), {
-    name: projectName,
-    version: '0.1.0',
-    type: 'module',
-    private: true,
-    scripts: {
-      dev: 'vite',
-      build: 'vite build',
-      preview: 'vite preview',
-    },
-    dependencies: {
-      '@uniweb/runtime': getVersion('@uniweb/runtime'),
-      ...(isWorkspace ? {} : { 'foundation-example': '^0.1.0' }),
-    },
-    devDependencies: {
-      '@uniweb/build': getVersion('@uniweb/build'),
-      '@vitejs/plugin-react': '^5.0.0',
-      autoprefixer: '^10.4.18',
-      'js-yaml': '^4.1.0',
-      postcss: '^8.4.35',
-      react: '^18.2.0',
-      'react-dom': '^18.2.0',
-      'react-router-dom': '^7.0.0',
-      tailwindcss: '^3.4.1',
-      vite: '^7.0.0',
-      'vite-plugin-svgr': '^4.2.0',
-    },
-  })
-
-  // Foundation import name (used for initial site.yml)
-  const foundationImport = isWorkspace ? 'foundation' : 'foundation-example'
-
-  // tailwind.config.js - reads foundation from site.yml
-  writeFile(join(projectDir, 'tailwind.config.js'), `import { readFileSync, existsSync } from 'fs'
-import yaml from 'js-yaml'
-
-// Read foundation from site.yml
-const siteConfig = yaml.load(readFileSync('./site.yml', 'utf8'))
-const foundation = siteConfig.foundation || 'foundation'
-
-// Resolve foundation path (workspace sibling or node_modules)
-const workspacePath = \`../\${foundation}/src/**/*.{js,jsx,ts,tsx}\`
-const npmPath = \`./node_modules/\${foundation}/src/**/*.{js,jsx,ts,tsx}\`
-const contentPath = existsSync(\`../\${foundation}\`) ? workspacePath : npmPath
-
-export default {
-  content: [contentPath],
-  theme: {
-    extend: {
-      colors: {
-        primary: '#3b82f6',
-        secondary: '#64748b',
-      },
-    },
-  },
-  plugins: [],
-}
-`)
-
-  // postcss.config.js
-  writeFile(join(projectDir, 'postcss.config.js'), `export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-}
-`)
-
-  // vite.config.js - reads foundation from site.yml
-  writeFile(join(projectDir, 'vite.config.js'), `import { defineConfig } from 'vite'
-import { readFileSync, existsSync } from 'fs'
-import yaml from 'js-yaml'
-import react from '@vitejs/plugin-react'
-import svgr from 'vite-plugin-svgr'
-import { siteContentPlugin } from '@uniweb/build/site'
-import { foundationDevPlugin } from '@uniweb/build/dev'
-
-// Read foundation from site.yml
-const siteConfig = yaml.load(readFileSync('./site.yml', 'utf8'))
-const foundation = siteConfig.foundation || 'foundation'
-
-// Check if foundation is a workspace sibling or npm package
-const isWorkspaceFoundation = existsSync(\`../\${foundation}\`)
-const foundationPath = isWorkspaceFoundation ? \`../\${foundation}\` : \`./node_modules/\${foundation}\`
-
-const useRuntimeLoading = process.env.VITE_FOUNDATION_MODE === 'runtime'
-
-export default defineConfig({
-  resolve: {
-    alias: {
-      // Alias #foundation to the actual foundation package
-      '#foundation': foundation,
-    },
-  },
-  plugins: [
-    react(),
-    svgr(),
-    siteContentPlugin({
-      sitePath: './',
-      inject: true,
-    }),
-    useRuntimeLoading && foundationDevPlugin({
-      name: foundation,
-      path: foundationPath,
-      serve: '/foundation',
-      watch: true,
-    }),
-  ].filter(Boolean),
-  server: {
-    fs: { allow: ['..'] },
-    port: 3000,
-  },
-  optimizeDeps: {
-    include: ['react', 'react-dom', 'react-dom/client', 'react-router-dom'],
-  },
-})
-`)
-
-  // index.html
-  writeFile(join(projectDir, 'index.html'), `<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>${projectName}</title>
-    <style>
-      body { margin: 0; font-family: system-ui, sans-serif; }
-      .loading { display: flex; align-items: center; justify-content: center; min-height: 100vh; color: #64748b; }
-    </style>
-  </head>
-  <body>
-    <div id="root">
-      <div class="loading">Loading...</div>
-    </div>
-    <script type="module" src="/src/main.jsx"></script>
-  </body>
-</html>
-`)
-
-  // main.jsx - uses #foundation alias (configured in vite.config.js from site.yml)
-  writeFile(join(projectDir, 'src/main.jsx'), `import initRuntime from '@uniweb/runtime'
-
-const useRuntimeLoading = import.meta.env.VITE_FOUNDATION_MODE === 'runtime'
-
-async function start() {
-  if (useRuntimeLoading) {
-    initRuntime({
-      url: '/foundation/foundation.js',
-      cssUrl: '/foundation/assets/style.css'
-    })
-  } else {
-    // #foundation alias is resolved by Vite based on site.yml config
-    const foundation = await import('#foundation')
-    await import('#foundation/styles')
-    initRuntime(foundation)
-  }
-}
-
-start().catch(console.error)
-`)
-
-  // site.yml
-  writeFile(join(projectDir, 'site.yml'), `name: ${projectName}
-defaultLanguage: en
-
-# Foundation to use for this site
-foundation: ${foundationImport}
-`)
-
-  // pages/home/page.yml
-  writeFile(join(projectDir, 'pages/home/page.yml'), `title: Home
-order: 1
-`)
-
-  // pages/home/1-hero.md
-  writeFile(join(projectDir, 'pages/home/1-hero.md'), `---
-type: Hero
-theme: dark
----
-
-# Welcome to ${projectName}
-
-Built with Uniweb and Vite.
-
-[Get Started](#)
-`)
-
-  // README.md (only for standalone site, not workspace)
-  if (!isWorkspace) {
-    writeFile(join(projectDir, 'README.md'), `# ${projectName}
-
-A Uniweb site — a content-driven website powered by a Foundation component library.
-
-## Quick Start
-
-\`\`\`bash
-pnpm install
-pnpm dev
-\`\`\`
-
-Open [http://localhost:3000](http://localhost:3000) to see your site.
-
-## Project Structure
-
-\`\`\`
-${projectName}/
-├── pages/              # Your content
-│   └── home/
-│       ├── page.yml    # Page metadata
-│       └── 1-hero.md   # Section content
-├── src/
-│   └── main.jsx        # Site entry point
-├── site.yml            # Site configuration
-├── vite.config.js
-└── package.json
-\`\`\`
-
-## Adding Pages
-
-1. Create a folder in \`pages/your-page/\`
-2. Add \`page.yml\`:
-
-\`\`\`yaml
-title: Your Page Title
-order: 2
-\`\`\`
-
-3. Add section files (\`1-hero.md\`, \`2-features.md\`, etc.):
-
-\`\`\`markdown
----
-type: Hero
-theme: dark
----
-
-# Section Title
-
-Section description here.
-
-[Call to Action](#)
-\`\`\`
-
-## How It Works
-
-- Each folder in \`pages/\` becomes a route (\`/home\`, \`/about\`, etc.)
-- Section files are numbered to control order (\`1-*.md\`, \`2-*.md\`)
-- Frontmatter specifies the component and configuration parameters
-- Content in the markdown body is semantically parsed into structured data
-
-## Configuration
-
-The \`site.yml\` file configures your site:
-
-\`\`\`yaml
-name: ${projectName}
-defaultLanguage: en
-foundation: ${foundationImport}    # Which foundation to use
-\`\`\`
-
-To use a different foundation, update the \`foundation\` field and install the package.
-
-## Building for Production
-
-\`\`\`bash
-pnpm build
-\`\`\`
-
-Output is in \`dist/\` — ready to deploy to any static host.
-
-## Learn More
-
-- [Uniweb on GitHub](https://github.com/uniweb)
-- [uniweb.app](https://uniweb.app)
-
-`)
-  }
-
-  success(`Created site: ${projectName}`)
-}
-
-async function createFoundation(projectDir, projectName, isWorkspace = false) {
-  mkdirSync(projectDir, { recursive: true })
-  mkdirSync(join(projectDir, 'src/components/Hero'), { recursive: true })
-  mkdirSync(join(projectDir, 'src/icons'), { recursive: true })
-
-  // package.json
-  writeJSON(join(projectDir, 'package.json'), {
-    name: projectName,
-    version: '0.1.0',
-    type: 'module',
-    main: './src/index.js',
-    exports: {
-      '.': './src/index.js',
-      './styles': './src/styles.css',
-      './dist': './dist/foundation.js',
-      './dist/styles': './dist/assets/style.css',
-    },
-    files: ['dist', 'src'],
-    scripts: {
-      dev: 'vite',
-      build: 'uniweb build',
-      'build:vite': 'vite build',
-      preview: 'vite preview',
-    },
-    peerDependencies: {
-      react: '^18.0.0',
-      'react-dom': '^18.0.0',
-    },
-    devDependencies: {
-      '@vitejs/plugin-react': '^5.0.0',
-      autoprefixer: '^10.4.18',
-      postcss: '^8.4.35',
-      react: '^18.2.0',
-      'react-dom': '^18.2.0',
-      tailwindcss: '^3.4.1',
-      uniweb: getVersion('uniweb'),
-      vite: '^7.0.0',
-      'vite-plugin-svgr': '^4.2.0',
-    },
-  })
-
-  // vite.config.js
-  writeFile(join(projectDir, 'vite.config.js'), `import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-import svgr from 'vite-plugin-svgr'
-import { resolve } from 'path'
-
-export default defineConfig({
-  plugins: [react(), svgr()],
-  build: {
-    lib: {
-      entry: resolve(__dirname, 'src/entry-runtime.js'),
-      formats: ['es'],
-      fileName: 'foundation',
-    },
-    rollupOptions: {
-      external: ['react', 'react-dom', 'react/jsx-runtime', 'react/jsx-dev-runtime'],
-      output: {
-        assetFileNames: 'assets/[name][extname]',
-      },
-    },
-    sourcemap: true,
-    cssCodeSplit: false,
-  },
-})
-`)
-
-  // tailwind.config.js
-  writeFile(join(projectDir, 'tailwind.config.js'), `import { fileURLToPath } from 'url'
-import { dirname, join } from 'path'
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-
-export default {
-  content: [join(__dirname, './src/**/*.{js,jsx,ts,tsx}')],
-  theme: {
-    extend: {
-      colors: {
-        primary: '#3b82f6',
-        secondary: '#64748b',
-      },
-    },
-  },
-  plugins: [],
-}
-`)
-
-  // postcss.config.js
-  writeFile(join(projectDir, 'postcss.config.js'), `export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-}
-`)
-
-  // .gitignore
-  writeFile(join(projectDir, '.gitignore'), `node_modules
-dist
-.DS_Store
-*.local
-_entry.generated.js
-`)
-
-  // src/styles.css
-  writeFile(join(projectDir, 'src/styles.css'), `@tailwind base;
-@tailwind components;
-@tailwind utilities;
-`)
-
-  // src/meta.js (foundation-level metadata)
-  writeFile(join(projectDir, 'src/meta.js'), `/**
- * ${projectName} Foundation Metadata
- */
-export default {
-  name: '${projectName}',
-  description: 'A Uniweb foundation',
-
-  // Runtime props (available at render time)
-  props: {
-    themeToggleEnabled: true,
-  },
-
-  // Style configuration for the editor
-  styleFields: [
-    {
-      id: 'primary-color',
-      type: 'color',
-      label: 'Primary Color',
-      default: '#3b82f6',
-    },
-  ],
-}
-`)
-
-  // src/index.js (manual entry for dev - imports from components)
-  writeFile(join(projectDir, 'src/index.js'), `/**
- * ${projectName} Foundation
- *
- * This is the manual entry point for development.
- * During build, _entry.generated.js is created automatically.
- */
-
-import Hero from './components/Hero/index.jsx'
-
-const components = { Hero }
-
-export function getComponent(name) {
-  return components[name]
-}
-
-export function listComponents() {
-  return Object.keys(components)
-}
-
-export function getSchema(name) {
-  return components[name]?.schema
-}
-
-export function getAllSchemas() {
-  const schemas = {}
-  for (const [name, component] of Object.entries(components)) {
-    if (component.schema) schemas[name] = component.schema
-  }
-  return schemas
-}
-
-export { Hero }
-export default { getComponent, listComponents, getSchema, getAllSchemas, components }
-`)
-
-  // src/entry-runtime.js
-  writeFile(join(projectDir, 'src/entry-runtime.js'), `import './styles.css'
-export * from './index.js'
-export { default } from './index.js'
-`)
-
-  // src/components/Hero/index.jsx
-  writeFile(join(projectDir, 'src/components/Hero/index.jsx'), `import React from 'react'
-
-export function Hero({ content, params }) {
-  // Extract from semantic parser structure
-  const { title } = content.main?.header || {}
-  const { paragraphs = [], links = [] } = content.main?.body || {}
-  const { theme = 'light' } = params || {}
-
-  const isDark = theme === 'dark'
-  const cta = links[0]
-
-  return (
-    <section className={\`py-20 px-6 \${isDark ? 'bg-gradient-to-br from-primary to-blue-700 text-white' : 'bg-gray-50'}\`}>
-      <div className="max-w-4xl mx-auto text-center">
-        {title && (
-          <h1 className="text-4xl md:text-5xl font-bold mb-6">{title}</h1>
-        )}
-        {paragraphs[0] && (
-          <p className={\`text-lg mb-8 \${isDark ? 'text-blue-100' : 'text-gray-600'}\`}>
-            {paragraphs[0]}
-          </p>
-        )}
-        {cta && (
-          <a
-            href={cta.url}
-            className={\`inline-block px-6 py-3 font-semibold rounded-lg transition-colors \${
-              isDark
-                ? 'bg-white text-primary hover:bg-blue-50'
-                : 'bg-primary text-white hover:bg-blue-700'
-            }\`}
-          >
-            {cta.text}
-          </a>
-        )}
-      </div>
-    </section>
-  )
-}
-
-export default Hero
-`)
-
-  // src/components/Hero/meta.js
-  writeFile(join(projectDir, 'src/components/Hero/meta.js'), `/**
- * Hero Component Metadata
- *
- * Content comes from the markdown body (parsed semantically):
- * - H1 → title (content.main.header.title)
- * - Paragraphs → description (content.main.body.paragraphs)
- * - Links → CTA buttons (content.main.body.links)
- */
-export default {
-  title: 'Hero Banner',
-  description: 'A prominent header section with headline, description, and call-to-action',
-  category: 'Headers',
-
-  // Content structure (informational - describes what the semantic parser provides)
-  elements: {
-    title: {
-      label: 'Headline',
-      description: 'From H1 in markdown',
-      required: true,
-    },
-    paragraphs: {
-      label: 'Description',
-      description: 'From paragraphs in markdown',
-    },
-    links: {
-      label: 'Call to Action',
-      description: 'From links in markdown',
-    },
-  },
-
-  // Configuration parameters (set in frontmatter)
-  properties: {
-    theme: {
-      type: 'select',
-      label: 'Theme',
-      options: [
-        { value: 'light', label: 'Light' },
-        { value: 'dark', label: 'Dark' },
-      ],
-      default: 'light',
-    },
-    alignment: {
-      type: 'select',
-      label: 'Text Alignment',
-      options: [
-        { value: 'center', label: 'Center' },
-        { value: 'left', label: 'Left' },
-      ],
-      default: 'center',
-    },
-  },
-}
-`)
-
-  // README.md (only for standalone foundation, not workspace)
-  if (!isWorkspace) {
-    writeFile(join(projectDir, 'README.md'), `# ${projectName}
-
-A Uniweb Foundation — a React component library for content-driven websites.
-
-## Quick Start
-
-\`\`\`bash
-pnpm install
-pnpm dev      # Start Vite dev server for component development
-pnpm build    # Build for production
-\`\`\`
-
-## Project Structure
-
-\`\`\`
-${projectName}/
-├── src/
-│   ├── components/       # Your components
-│   │   └── Hero/
-│   │       ├── index.jsx # React component
-│   │       └── meta.js   # Component metadata
-│   ├── meta.js           # Foundation metadata
-│   ├── index.js          # Exports
-│   └── styles.css        # Tailwind styles
-├── package.json
-├── vite.config.js
-└── tailwind.config.js
-\`\`\`
-
-## Adding Components
-
-1. Create \`src/components/YourComponent/index.jsx\`:
-
-\`\`\`jsx
-export function YourComponent({ content }) {
-  const { title, description } = content
-  return (
-    <section className="py-12 px-6">
-      <h2>{title}</h2>
-      <p>{description}</p>
-    </section>
-  )
-}
-
-export default YourComponent
-\`\`\`
-
-2. Create \`src/components/YourComponent/meta.js\`:
-
-\`\`\`js
-export default {
-  title: 'Your Component',
-  description: 'What this component does',
-  category: 'Content',
-  elements: {
-    title: { label: 'Title', required: true },
-    description: { label: 'Description' },
-  },
-}
-\`\`\`
-
-3. Export from \`src/index.js\`:
-
-\`\`\`js
-export { YourComponent } from './components/YourComponent/index.jsx'
-\`\`\`
-
-## Build Output
-
-After \`pnpm build\`:
-
-\`\`\`
-dist/
-├── foundation.js      # Bundled components
-├── assets/style.css   # Compiled Tailwind CSS
-└── schema.json        # Component metadata for editors
-\`\`\`
-
-## What is a Foundation?
-
-A Foundation defines the vocabulary for Uniweb sites:
-- **Components** — The building blocks creators can use
-- **Elements** — Content slots (title, description, images, etc.)
-- **Properties** — Configuration options exposed to creators
-- **Presets** — Pre-configured variations of components
-
-Learn more at [github.com/uniweb](https://github.com/uniweb)
-
-`)
-  }
-
-  success(`Created foundation: ${projectName}`)
-}
-
-// Utility functions
-function writeFile(path, content) {
-  const dir = dirname(path)
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true })
-  }
-  writeFileSync(path, content)
-}
-
-function writeJSON(path, obj) {
-  writeFile(path, JSON.stringify(obj, null, 2) + '\n')
-}
-
-function readFile(path) {
-  return readFileSync(path, 'utf-8')
-}
-
 // Run CLI
 main().catch((err) => {
   error(err.message)

package/src/templates/processor.js

@@ -153,11 +153,17 @@ async function processFile(sourcePath, targetPath, data, options = {}) {
  * @param {Object} data - Template variables
  * @param {Object} options - Processing options
  * @param {string|null} options.variant - Template variant to use
+ * @param {string|null} options.basePath - Base template to merge with (files copied first)
  * @param {Function} options.onWarning - Warning callback
  * @param {Function} options.onProgress - Progress callback
  */
 export async function copyTemplateDirectory(sourcePath, targetPath, data, options = {}) {
-  const { variant = null, onWarning, onProgress } = options
+  const { variant = null, basePath = null, onWarning, onProgress } = options
+
+  // If a base template is specified, copy it first (without the basePath option to avoid recursion)
+  if (basePath && existsSync(basePath)) {
+    await copyTemplateDirectory(basePath, targetPath, data, { variant, onWarning, onProgress })
+  }
 
   await fs.mkdir(targetPath, { recursive: true })
   const entries = await fs.readdir(sourcePath, { withFileTypes: true })
@@ -173,6 +179,9 @@ export async function copyTemplateDirectory(sourcePath, targetPath, data, option
     }
   }
 
+  // Options for recursive calls (without basePath to avoid re-copying base at each level)
+  const recursionOptions = { variant, onWarning, onProgress }
+
   for (const entry of entries) {
     const sourceName = entry.name
 
@@ -199,7 +208,7 @@ export async function copyTemplateDirectory(sourcePath, targetPath, data, option
         const sourceFullPath = path.join(sourcePath, sourceName)
         const targetFullPath = path.join(targetPath, baseName)
 
-        await copyTemplateDirectory(sourceFullPath, targetFullPath, data, options)
+        await copyTemplateDirectory(sourceFullPath, targetFullPath, data, recursionOptions)
       } else {
         // Regular directory - skip if a variant override exists and we're using that variant
         if (variant && variantBases.has(sourceName)) {
@@ -210,10 +219,15 @@ export async function copyTemplateDirectory(sourcePath, targetPath, data, option
         const sourceFullPath = path.join(sourcePath, sourceName)
         const targetFullPath = path.join(targetPath, sourceName)
 
-        await copyTemplateDirectory(sourceFullPath, targetFullPath, data, options)
+        await copyTemplateDirectory(sourceFullPath, targetFullPath, data, recursionOptions)
       }
     } else {
       // File processing
+      // Skip template.json as it's metadata for the template, not for the output
+      if (sourceName === 'template.json') {
+        continue
+      }
+
       // Remove .hbs extension for target filename
       const targetName = sourceName.endsWith('.hbs')
         ? sourceName.slice(0, -4)

package/src/templates/resolver.js

@@ -2,8 +2,8 @@
  * Template resolver - parses template identifiers and determines source type
  */
 
-// Built-in templates that are generated programmatically
-export const BUILTIN_TEMPLATES = ['single', 'multi']
+// Built-in templates (file-based in cli/templates/)
+export const BUILTIN_TEMPLATES = ['single', 'multi', 'template']
 
 // Official templates from @uniweb/templates package
 export const OFFICIAL_TEMPLATES = ['marketing', 'docs', 'learning']