uniweb 0.2.29 → 0.2.31

package/README.md

@@ -32,7 +32,7 @@ my-project/
 │   ├── locales/              # i18n (hash-based translations)
 │   │   ├── manifest.json     # Auto-extracted strings
 │   │   └── es.json           # Spanish translations
-│   ├── main.js               # 1-line entry point
+│   ├── main.js               # Entry point (~6 lines)
 │   ├── vite.config.js        # 3-line config
 │   └── public/               # Static assets
 │
@@ -226,7 +226,8 @@ uniweb build [options]
 | Option              | Description                                                           |
 | ------------------- | --------------------------------------------------------------------- |
 | `--target <type>`   | Build target: `foundation` or `site` (auto-detected if not specified) |
-| `--prerender`       | Pre-render pages to static HTML (SSG) - site builds only              |
+| `--prerender`       | Force pre-rendering (overrides site.yml)                              |
+| `--no-prerender`    | Skip pre-rendering (overrides site.yml)                               |
 | `--foundation-dir`  | Path to foundation directory (for prerendering)                       |
 | `--platform <name>` | Deployment platform (e.g., `vercel`) for platform-specific output     |
 
@@ -242,16 +243,26 @@ uniweb build --target foundation
 # Explicitly build as site
 uniweb build --target site
 
-# Build site with pre-rendering (SSG)
+# Build site with pre-rendering (SSG) - force on
 uniweb build --prerender
 
+# Skip pre-rendering even if enabled in site.yml
+uniweb build --no-prerender
+
 # Build for Vercel deployment
 uniweb build --platform vercel
 ```
 
 ### Pre-rendering (SSG)
 
-The `--prerender` flag generates static HTML for each page at build time. This is useful for:
+Pre-rendering generates static HTML for each page at build time. Enable it in `site.yml`:
+
+```yaml
+build:
+  prerender: true
+```
+
+Or use the `--prerender` flag to force it on (or `--no-prerender` to skip it). This is useful for:
 
 - **SEO**: Search engines see fully rendered content immediately
 - **Performance**: First contentful paint is instant (no JavaScript required)
@@ -275,11 +286,11 @@ The pre-rendered HTML includes a `<script id="__SITE_CONTENT__">` tag with the f
 **Usage:**
 
 ```bash
-# From site directory
+# From site directory (with build.prerender: true in site.yml)
 cd site
-pnpm build:ssg
+pnpm build
 
-# Or from workspace root
+# Or force pre-rendering via CLI flag
 cd site && uniweb build --prerender
 ```
 
@@ -300,7 +311,7 @@ my-project/
 │   ├── vite.config.js        # 3-line config
 │   ├── index.html
 │   ├── site.yml              # Site configuration (foundation, title, i18n)
-│   ├── main.js               # 1-line entry point
+│   ├── main.js               # Entry point (~6 lines)
 │   ├── pages/                # Content pages (file-based routing)
 │   │   └── home/
 │   │       ├── page.yml
@@ -311,10 +322,9 @@ my-project/
     ├── package.json
     ├── vite.config.js        # 3-line config
     └── src/
-        ├── index.js          # Component exports
-        ├── entry-runtime.js  # Runtime entry (imports styles + index)
         ├── styles.css        # Tailwind CSS v4
         ├── meta.js           # Foundation metadata
+        ├── runtime.js        # (optional) Custom Layout, props
         └── components/
             └── Section/
                 ├── index.jsx
@@ -343,7 +353,7 @@ my-workspace/
 │   │   ├── package.json
 │   │   ├── vite.config.js    # 3-line config
 │   │   ├── site.yml
-│   │   ├── main.js         # 1-line entry point
+│   │   ├── main.js           # Entry point (~6 lines)
 │   │   └── pages/
 │   └── docs/                 # Documentation site
 │
@@ -472,8 +482,7 @@ The `defineFoundationConfig()` function handles all Vite configuration for found
 import { defineFoundationConfig } from "@uniweb/build";
 
 export default defineFoundationConfig({
-  // All options are optional
-  entry: "src/entry-runtime.js", // Entry point path
+  // All options are optional - entry is auto-generated
   fileName: "foundation", // Output file name
   externals: [], // Additional packages to externalize
   includeDefaultExternals: true, // Include react, @uniweb/core, etc.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.2.29",
+  "version": "0.2.31",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -36,9 +36,9 @@
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/build": "0.1.13",
-    "@uniweb/core": "0.1.6",
+    "@uniweb/build": "0.1.15",
+    "@uniweb/core": "0.1.7",
     "@uniweb/kit": "0.1.4",
-    "@uniweb/runtime": "0.2.6"
+    "@uniweb/runtime": "0.2.8"
   }
 }

package/src/commands/build.js

@@ -22,6 +22,7 @@ import {
   discoverComponents,
   processAllPreviews,
 } from '@uniweb/build'
+import { readSiteConfig } from '@uniweb/build/site'
 
 // Colors for terminal output
 const colors = {
@@ -186,14 +187,8 @@ async function buildFoundation(projectDir, options = {}) {
  * - '*' → explicitly all available locales
  * - ['es', 'fr'] → only those specific locales
  */
-async function loadI18nConfig(projectDir) {
-  const siteYmlPath = join(projectDir, 'site.yml')
-  if (!existsSync(siteYmlPath)) return null
-
-  const { readFile } = await import('node:fs/promises')
-  const yaml = await import('js-yaml')
-  const content = await readFile(siteYmlPath, 'utf-8')
-  const config = yaml.load(content) || {}
+async function loadI18nConfig(projectDir, siteConfig = null) {
+  const config = siteConfig || readSiteConfig(projectDir)
 
   const localesDir = config.i18n?.localesDir || 'locales'
   const localesPath = join(projectDir, localesDir)
@@ -288,7 +283,7 @@ async function generateLocalizedHtml(projectDir, i18nConfig) {
  * Build a site
  */
 async function buildSite(projectDir, options = {}) {
-  const { prerender = false, foundationDir } = options
+  const { prerender = false, foundationDir, siteConfig = null } = options
 
   info('Building site...')
 
@@ -298,7 +293,7 @@ async function buildSite(projectDir, options = {}) {
   success('Site build complete')
 
   // Check for i18n configuration
-  const i18nConfig = await loadI18nConfig(projectDir)
+  const i18nConfig = await loadI18nConfig(projectDir, siteConfig)
 
   if (i18nConfig && i18nConfig.locales.length > 0) {
     log('')
@@ -378,8 +373,9 @@ export async function build(args = []) {
     }
   }
 
-  // Check for --prerender flag (SSG)
-  const prerender = args.includes('--prerender')
+  // Check for --prerender / --no-prerender flags
+  const prerenderFlag = args.includes('--prerender')
+  const noPrerenderFlag = args.includes('--no-prerender')
 
   // Check for --foundation-dir flag (for prerendering)
   let foundationDir = null
@@ -401,9 +397,9 @@ export async function build(args = []) {
     info(`Detected project type: ${targetType}`)
   }
 
-  // Validate prerender is only used with site target
-  if (prerender && targetType !== 'site') {
-    error('--prerender can only be used with site builds')
+  // Validate prerender flags are only used with site target
+  if ((prerenderFlag || noPrerenderFlag) && targetType !== 'site') {
+    error('--prerender/--no-prerender can only be used with site builds')
     process.exit(1)
   }
 
@@ -412,7 +408,16 @@ export async function build(args = []) {
     if (targetType === 'foundation') {
       await buildFoundation(projectDir)
     } else {
-      await buildSite(projectDir, { prerender, foundationDir })
+      // For sites, read config to determine prerender default
+      const siteConfig = readSiteConfig(projectDir)
+      const configPrerender = siteConfig.build?.prerender === true
+
+      // CLI flags override config: --prerender forces on, --no-prerender forces off
+      let prerender = configPrerender
+      if (prerenderFlag) prerender = true
+      if (noPrerenderFlag) prerender = false
+
+      await buildSite(projectDir, { prerender, foundationDir, siteConfig })
     }
   } catch (err) {
     error(err.message)

package/src/index.js

@@ -334,10 +334,13 @@ ${colors.bright}Create Options:${colors.reset}
 
 ${colors.bright}Build Options:${colors.reset}
   --target <type>    Build target (foundation, site) - auto-detected if not specified
-  --prerender        Pre-render pages to static HTML (SSG) - site builds only
+  --prerender        Force pre-rendering (overrides site.yml)
+  --no-prerender     Skip pre-rendering (overrides site.yml)
   --foundation-dir   Path to foundation directory (for prerendering)
   --platform <name>  Deployment platform (e.g., vercel) for platform-specific output
 
+  Pre-rendering is enabled by default when build.prerender: true in site.yml
+
 ${colors.bright}Docs Options:${colors.reset}
   --output <file>    Output filename (default: COMPONENTS.md)
   --from-source      Read meta.js files directly instead of schema.json
@@ -364,7 +367,8 @@ ${colors.bright}Examples:${colors.reset}
   npx uniweb create my-project --template github:myorg/template
   npx uniweb build
   npx uniweb build --target foundation
-  npx uniweb build --prerender                         # Build site + pre-render to static HTML
+  npx uniweb build                                     # Auto-prerenders if site.yml has build.prerender: true
+  npx uniweb build --no-prerender                      # Skip prerendering even if enabled in config
   cd foundation && npx uniweb docs                     # Generate COMPONENTS.md
 `)
 }

package/templates/_shared/CLAUDE.md.hbs

@@ -40,24 +40,26 @@ cd site && pnpm build
 
 **Foundation:**
 - `foundation/vite.config.js` - 3-line config using `defineFoundationConfig()` from `@uniweb/build`
-- `foundation/src/entry-runtime.js` - Runtime entry point (imports styles + components)
-- `foundation/src/index.js` - Component exports
 - `foundation/src/styles.css` - Tailwind CSS v4 theme
-- `foundation/src/components/*/meta.js` - Component metadata and schema
+- `foundation/src/components/*/meta.js` - Component metadata (makes component exposed)
+- `foundation/src/runtime.js` - (optional) Custom Layout and foundation props
+- `foundation/src/_entry.generated.js` - Auto-generated at build/dev time
 
 ## Architecture
 
 ### Foundation Package (`/foundation`)
 
-The **foundation** is a React component library. Each component:
+The **foundation** is a React component library. Components with a `meta.js` file are **exposed** (available to content creators via `type:` in frontmatter). Exposed components:
 
-1. Receives structured content parsed from markdown
-2. Has configurable parameters (theme, layout, etc.)
-3. Renders the content according to its design
+1. Receive structured content parsed from markdown
+2. Have configurable parameters (theme, layout, etc.)
+3. Render content according to their design
+
+Internal components (no `meta.js`) are regular React components used within exposed components.
 
 **Key directories:**
 - `src/components/*/` - Component implementations
-- `src/components/*/meta.js` - Component metadata and schema
+- `src/components/*/meta.js` - Component metadata (makes component exposed)
 - `src/styles.css` - Global Tailwind styles
 
 ### Site Package (`/site`)

package/templates/multi/CLAUDE.md.hbs

@@ -79,9 +79,9 @@ pnpm build:all
 
 **Foundations:**
 - `foundations/*/vite.config.js` - 3-line config using `defineFoundationConfig()` from `@uniweb/build`
-- `foundations/*/src/entry-runtime.js` - Runtime entry point
 - `foundations/*/src/styles.css` - Tailwind CSS v4 theme
-- `foundations/*/src/components/*/meta.js` - Component metadata
+- `foundations/*/src/components/*/meta.js` - Component metadata (makes component exposed)
+- `foundations/*/src/runtime.js` - (optional) Custom Layout and foundation props
 
 ## Architecture
 

package/templates/multi/foundations/default/package.json.hbs

@@ -2,9 +2,9 @@
   "name": "default",
   "version": "0.1.0",
   "type": "module",
-  "main": "./src/index.js",
+  "main": "./src/_entry.generated.js",
   "exports": {
-    ".": "./src/index.js",
+    ".": "./src/_entry.generated.js",
     "./styles": "./src/styles.css",
     "./dist": "./dist/foundation.js",
     "./dist/styles": "./dist/assets/style.css"

package/templates/multi/sites/main/package.json.hbs

@@ -6,8 +6,7 @@
   "scripts": {
     "dev": "vite",
     "dev:runtime": "VITE_FOUNDATION_MODE=runtime vite",
-    "build": "vite build",
-    "build:ssg": "vite build && uniweb build --prerender",
+    "build": "npx uniweb@latest build",
     "preview": "vite preview"
   },
   "dependencies": {

package/templates/single/README.md.hbs

@@ -76,7 +76,7 @@ export function Hero({ content, params }) {
 export default Hero
 ```
 
-Each component needs a `meta.js` file defining its schema.
+Exposed components (selectable via `type:` in frontmatter) need a `meta.js` file.
 
 ## Building
 

package/templates/single/foundation/package.json.hbs

@@ -2,9 +2,9 @@
   "name": "foundation",
   "version": "0.1.0",
   "type": "module",
-  "main": "./src/index.js",
+  "main": "./src/_entry.generated.js",
   "exports": {
-    ".": "./src/index.js",
+    ".": "./src/_entry.generated.js",
     "./styles": "./src/styles.css",
     "./dist": "./dist/foundation.js",
     "./dist/styles": "./dist/assets/style.css"

package/templates/single/site/package.json.hbs

@@ -6,8 +6,7 @@
   "scripts": {
     "dev": "vite",
     "dev:runtime": "VITE_FOUNDATION_MODE=runtime vite",
-    "build": "vite build",
-    "build:ssg": "vite build && uniweb build --prerender",
+    "build": "npx uniweb@latest build",
     "preview": "vite preview"
   },
   "dependencies": {

package/templates/template/template/foundation/package.json.hbs

@@ -2,9 +2,9 @@
   "name": "foundation",
   "version": "0.1.0",
   "type": "module",
-  "main": "./src/index.js",
+  "main": "./src/_entry.generated.js",
   "exports": {
-    ".": "./src/index.js",
+    ".": "./src/_entry.generated.js",
     "./styles": "./src/styles.css",
     "./dist": "./dist/foundation.js",
     "./dist/styles": "./dist/assets/style.css"

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

@@ -6,8 +6,7 @@
   "scripts": {
     "dev": "vite",
     "dev:runtime": "VITE_FOUNDATION_MODE=runtime vite",
-    "build": "vite build",
-    "build:ssg": "vite build && uniweb build --prerender",
+    "build": "npx uniweb@latest build",
     "preview": "vite preview"
   },
   "dependencies": {

package/templates/multi/foundations/default/src/entry-runtime.js

@@ -1,3 +0,0 @@
-import './styles.css'
-export * from './index.js'
-export { default } from './index.js'

package/templates/single/foundation/src/entry-runtime.js

@@ -1,3 +0,0 @@
-import './styles.css'
-export * from './index.js'
-export { default } from './index.js'

package/templates/single/foundation/src/index.js

@@ -1,35 +0,0 @@
-/**
- * Foundation Entry Point
- *
- * Export all components from this file.
- * Components are discovered from src/components/{Name}/meta.js during build.
- */
-
-import Section from './components/Section/index.jsx'
-
-const components = {
-  Section,
-}
-
-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 { Section }
-export default { getComponent, listComponents, getSchema, getAllSchemas, components }

package/templates/template/template/foundation/src/entry-runtime.js

@@ -1,3 +0,0 @@
-import './styles.css'
-export * from './index.js'
-export { default } from './index.js'

package/templates/template/template/foundation/src/index.js

@@ -1,36 +0,0 @@
-/**
- * Foundation Entry Point
- *
- * Export all your template's components here.
- */
-
-import Hero from './components/Hero/index.jsx'
-import Features from './components/Features/index.jsx'
-
-const components = {
-  Hero,
-  Features,
-}
-
-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, Features }
-export default { getComponent, listComponents, getSchema, getAllSchemas, components }