Astro · copy-based · dev to deploy

Ship a website, not a setup.

Walle is an Astro design system you copy into your repo: accessible components, GitHub Actions pipelines, and an AI-ready dev base. One CLI command scaffolds a complete project, and update keeps the managed parts current without touching your code.

Explore the showcase View on GitHub

No package to install. Nothing to eject. The source is yours.

bash

$ bash <(curl -fsSL walle/cli.sh) \
    init --project-name my-site

✓ harness-coding base
✓ starter site + configs
✓ managed design system
✓ CI/CD workflows

$ cd my-site && yarn dev
  → http://localhost:4321

Four layers, one scaffold

Everything an Astro site needs to go live and stay maintainable, enabled by default.

Website
Component library
Accessible Astro components: buttons, cards, sections, carousels, navbar, footer and blog. WCAG 2.2 AA, responsive, SEO and structured data ready out of the box.
- WCAG 2.2 AA + 320px reflow
- JSON-LD, sitemap, RSS, llms.txt
- Semantic design tokens
CI/CD
GitHub Actions
Ready-made workflows for lint, build, accessibility and end-to-end tests, plus deploy to GitHub Pages, wired through reusable composite actions.
- Test + a11y + e2e pipelines
- Deploy to GitHub Pages
- Reusable composite actions
Harness coding
AI-ready dev base
The harness-coding base ships a DevContainer, a justfile task runner, git hooks and AGENTS.md skills, so agents like Claude Code and Copilot work with full project context from day one.
- DevContainer + justfile
- AGENTS.md + agent skills
- Pre-commit hooks

How it works

Init
Run the CLI once. It scaffolds the harness-coding base, seeds the starter site, and syncs the managed design system into a complete, ready-to-run project.
Configure
Edit JSON configs for branding, navigation and metadata. Override CSS variables for colors, fonts and spacing. No component code to touch.
Build
Add pages, content collections and your own components. The @walle/ directories stay managed, so your code lives in consumer zones that updates never overwrite.
Update
When a new version ships, run `just walle update`. Only @walle/ paths are replaced. Your content, config and pages are untouched.

Quick start

Scaffold a new project with everything included:

bash <(curl -fsSL https://raw.githubusercontent.com/FabrizioCafolla/harness-walle/main/walle/cli/cli.sh) \
  init --project-name my-site

Pull the latest managed release into an existing project:

just walle update

Develop locally inside the DevContainer:

just setup && just dev

See every component in action

Browse the live showcase, then read the demo blog to see the content pipeline end to end.

Open the showcase Read the blog

Ship a website, not a setup.

Four layers, one scaffold

Component library

GitHub Actions

AI-ready dev base

How it works

Init

Configure

Build

Update

Quick start

See every component in action