uniweb 0.8.7 → 0.8.9

package/templates/site/site.yml.hbs

@@ -1,3 +1,6 @@
+# Site Configuration
+# Full reference: uniweb docs site  |  Schema: schemas/site.schema.json
+
 name: {{projectName}}
 
 {{#if foundationRef}}
@@ -6,5 +9,51 @@ foundation: {{foundationRef}}
 {{/if}}
 index: home
 
+# ─── Page Ordering ─────────────────────────────────────────────────────────────
+# Control which pages appear in navigation and in what order.
+# pages: [home, about, ...]        # home first, about second, rest auto-discovered
+# pages: [home, ..., contact]      # home first, contact last, rest in middle
+# pages: [home, about]             # Strict: only these pages in nav (others still built)
+# Or just set the homepage and auto-discover the rest:
+# index: home
+
+# ─── Content Paths ─────────────────────────────────────────────────────────────
+# Mount external content directories into your site's page tree.
+# Paths resolve relative to this file.
+#
+# paths:
+#   pages/docs: ../../../docs       # Mount docs repo at /docs route
+#   pages/blog: ../../blog-content  # Mount blog content at /blog route
+#   layout: ./custom-layout         # Custom layout directory
+#   collections: ./data             # Collections directory
+
+# ─── Data Sources ─────────────────────────────────────────────────────────────
+# Define collections (local markdown folders) or fetch remote/local JSON data.
+# Pages and sections reference sources by name via `data: source-name`.
+#
+# collections:
+#   articles:
+#     path: collections/articles         # Folder of .md entity files
+#     sort: date desc                    # Sort by frontmatter field
+#
+# fetch:
+#   - url: https://api.example.com/team  # Remote JSON
+#     schema: team                       # Access as content.data.team
+#   - path: /data/config.json            # Local file from public/
+
+# ─── Extensions ────────────────────────────────────────────────────────────────
+# Load additional foundations (section types) via URL.
+# extensions:
+#   - https://cdn.example.com/effects/foundation.js
+
+# ─── Layout ────────────────────────────────────────────────────────────────────
+# Override the foundation's default layout per-site.
+# layout: DocsLayout
+# Or per-page in page.yml:  layout: { name: MarketingLayout, hide: [left] }
+
+# ─── Base Path ─────────────────────────────────────────────────────────────────
+# For subdirectory deployments (e.g., https://example.com/docs/).
+# base: /docs/
+
 build:
   prerender: true

package/templates/site/theme.yml

@@ -64,12 +64,12 @@ colors:
 #     heading: white
 
 # ─── Inline Text Styles ───────────────────────────────────────────────────────
-# Named styles for inline text in markdown: [text]{emphasis}
+# Named styles for inline text in markdown: [text]{accent}
 # Each name maps to CSS properties.
-# Defaults: emphasis (colored + bold), muted (subtle).
+# Defaults: accent (colored + bold), muted (subtle).
 
 # inline:
-#   emphasis:
+#   accent:
 #     color: 'var(--link)'
 #     font-weight: '600'
 #   muted:

package/templates/workspace/README.md.hbs

@@ -10,7 +10,7 @@ A website built with [Uniweb](https://github.com/uniweb/cli) — a component web
 {{projectName}}/
 ├── foundation/          # React component library
 │   ├── src/
-│   │   ├── components/  # Your components
+│   │   ├── sections/    # Section types (selectable by content authors)
 │   │   └── styles.css   # Tailwind CSS v4 theme
 │   └── vite.config.js   # defineFoundationConfig()
 │
@@ -22,7 +22,7 @@ A website built with [Uniweb](https://github.com/uniweb/cli) — a component web
 │   ├── site.yml         # Site configuration
 │   └── vite.config.js   # defineSiteConfig()
 │
-└── AGENTS.md            # AI assistant instructions
+└── AGENTS.md            # Developer guide (human + AI)
 ```
 
 ## Content Authoring
@@ -46,27 +46,25 @@ Your content here.
 
 ## Component Development
 
-Components live in `foundation/src/components/`:
+Section types live in `foundation/src/sections/`. Each is a folder with an `index.jsx` and a `meta.js`:
 
 ```jsx
-// foundation/src/components/Hero/index.jsx
-import { H1, P, cn } from '@uniweb/kit'
+// foundation/src/sections/Hero/index.jsx
+import { H1, P } from '@uniweb/kit'
 
-export function Hero({ content, params }) {
-  const { title } = content.main?.header || {}
-  const { theme = 'light' } = params
+export default function Hero({ content }) {
+  const { title, paragraphs = [] } = content || {}
 
   return (
-    <section className={cn('py-20', theme === 'dark' && 'bg-gray-900')}>
-      <H1 text={title} />
-    </section>
+    <div className="max-w-4xl mx-auto px-6">
+      <H1 text={title} className="text-heading text-4xl font-bold" />
+      <P text={paragraphs} className="text-body mt-4" />
+    </div>
   )
 }
-
-export default Hero
 ```
 
-Exposed components (selectable via `type:` in frontmatter) need a `meta.js` file.
+Components receive parsed content from markdown. Classes like `text-heading` and `text-body` are semantic tokens — the site controls their actual colors through theming, so the same component adapts to any context automatically.
 
 {{> components-docs}}