uniweb 1.0.0 → 1.0.2

package/templates/workspace/README.md.hbs

@@ -0,0 +1,87 @@
+# {{projectName}}
+
+A website built with [Uniweb](https://github.com/uniweb/cli) — a component web platform that separates content from code.
+
+{{> quick-start}}
+
+## Project Structure
+
+```
+{{projectName}}/
+├── src/                 # Foundation package (the site's source code; pkg name: src)
+│   ├── sections/        # Section types (selectable by content authors)
+│   ├── styles.css       # Tailwind CSS v4 theme
+│   ├── main.js          # Foundation declarations (name, vars, defaultLayout)
+│   └── vite.config.js   # defineFoundationConfig()
+│
+├── site/                # Content (markdown)
+│   ├── pages/           # Content pages
+│   │   └── home/
+│   │       ├── page.yml
+│   │       └── 1-welcome.md
+│   ├── site.yml         # Site configuration (foundation: src)
+│   └── vite.config.js   # defineSiteConfig()
+│
+└── AGENTS.md            # Developer guide (human + AI)
+```
+
+A site is pure content. A foundation is the site's source code — that's why it lives in `src/`.
+
+## Content Authoring
+
+Content lives in markdown files under `site/pages/`:
+
+```markdown
+---
+type: Section
+theme: light
+---
+
+# Welcome
+
+Your content here.
+
+[Call to Action](#)
+```
+
+{{> adding-pages}}
+
+## Component Development
+
+Section types live in `src/sections/`. Each is a folder with an `index.jsx` and a `meta.js`:
+
+```jsx
+// src/sections/Hero/index.jsx
+import { H1, P } from '@uniweb/kit'
+
+export default function Hero({ content }) {
+  const { title, paragraphs = [] } = content || {}
+
+  return (
+    <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>
+  )
+}
+```
+
+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}}
+
+## Building
+
+```bash
+# Build foundation (generates dist/foundation.js)
+cd foundation && pnpm build
+
+# Build site for production
+cd site && pnpm build
+```
+
+Deploy `site/dist/` to any static host (Vercel, Netlify, Cloudflare Pages, etc.)
+
+{{> ai-assistance}}
+
+{{> learn-more}}

package/templates/workspace/_gitignore

@@ -0,0 +1,29 @@
+# Dependencies
+node_modules/
+
+# Build outputs
+dist/
+.uniweb/
+
+# Generated entry (regenerated by `uniweb build`; never committed)
+_entry.generated.js
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+pnpm-debug.log*

package/templates/workspace/_vscode/settings.json

@@ -0,0 +1,6 @@
+{
+  "yaml.schemas": {
+    "https://raw.githubusercontent.com/uniweb/cli/main/schemas/site.schema.json": "site/site.yml",
+    "https://raw.githubusercontent.com/uniweb/cli/main/schemas/page.schema.json": "**/page.yml"
+  }
+}

package/templates/workspace/package.json.hbs

@@ -0,0 +1,20 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    {{#each scripts}}
+    "{{@key}}": "{{this}}"{{#unless @last}},{{/unless}}
+    {{/each}}
+  },
+  "workspaces": [{{#if workspaceGlobs.length}}
+    {{#each workspaceGlobs}}
+    "{{this}}"{{#unless @last}},{{/unless}}
+    {{/each}}
+  {{/if}}],
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "uniweb": "{{version "uniweb"}}"
+  }
+}

package/templates/workspace/pnpm-workspace.yaml.hbs

@@ -0,0 +1,26 @@
+packages:
+{{#each workspaceGlobs}}
+  - "{{this}}"
+{{/each}}
+
+# Permit install scripts for these native deps (esbuild compiles, sharp
+# resolves its platform binary). Both spellings are listed on purpose:
+#
+#   onlyBuiltDependencies — pnpm 10's name for this setting (a list)
+#   allowBuilds           — pnpm 11 renamed it (a map)
+#
+# pnpm 11 ignores the old name entirely, so with only the list a fresh
+# install fails with ERR_PNPM_IGNORED_BUILDS and exits 1 — before anything
+# is built. pnpm 10 understands both, so keeping the pair means the project
+# installs on either major. Drop `onlyBuiltDependencies` once pnpm 10 is no
+# longer in use.
+#
+# Neither applies to npm or yarn, which run install scripts by default;
+# they read `workspaces` in package.json and ignore this file.
+onlyBuiltDependencies:
+  - esbuild
+  - sharp
+
+allowBuilds:
+  esbuild: true
+  sharp: true