In the new-site wizard, Aveiro usually picks a gallery template for the look — layout, typography, and colors — while AI writes your pages from your website, document, or description. Choose the design yourself when you want full control. Duplicating a site from the dashboard still clones full template content.
When templates help
Templates save time when you want a sensible default structure on day one — navigation, homepage sections, and typography already in place.Choose a template when:
You are launching a docs site, blog, portfolio, or similar and want a proven layout
You prefer editing existing content over building from zero
You want to preview how Aveiro handles your use case before customizing
Start without a template when:
You have a clear structure in mind and will add pages yourself
You are experimenting and do not need sample content
You plan to rely heavily on AI to generate the first draft
By default the wizard picks a gallery template for you from your site intent and source content. Tick Choose the design myself on step 1 to browse the gallery in Pick a look, then Style your site. Either way, the template defines the section layout and theme tokens your build writes into.
Template categories
Gallery templates are grouped by purpose:
Category
Best for
Documentation
Help centers, product docs, guides with sidebar navigation
Blog
Articles, posts, and editorial layouts
Portfolio
Projects, case studies, and personal or studio showcases
Store
Spotlight
Product-focused layouts and commerce-style pages
Focused landing pages and single-purpose marketing sites
Each card shows a label, description, and preview images. Some templates link to a live demo on *.aveiro.page so you can see the finished look before cloning.
Look-only templates in the wizard
When you finish the wizard with Build my site, Aveiro copies the template's theme and layout, not its sample pages or SEO text. Section components (hero, features, contact, and others) are filled from your source so visitors never see placeholder marketing copy.
If you need the full template copy instead — for example when duplicating a demo site — use Duplicate on the Sites dashboard or create via the API with a template slug. See Build from your content.
What copying a template includes
When you create a site from a template, Aveiro copies into your new site:
Starter pages and folder structure
Default layout (header, footer, sidebars as configured)
Initial styles (you still pick presets in step 3)
Sample components and MDX content you can replace
The copy is yours — changes do not affect the gallery template or other users' sites.
Step 3 — styles after the template
Even with a template, step 3 lets you set primary colors, links, and related tokens before the site is created. Treat this as a first pass; the editor Styles panel has the full theme controls later.
Changing your mind later
You cannot swap the underlying gallery template after creation the way you swap themes in other tools. What you can do:
Edit or delete any page
Change layout slots in the Layout panel
Restyle the site in Styles
Duplicate the site and try a different template on the copy
If you picked the wrong template, duplicating and starting a fresh wizard with a different choice is often faster than rebuilding in place.
Template from URL
Marketplace links can include a template_id query parameter so the wizard pre-selects a specific template. Useful when sharing a “Start with this template” link from the Aveiro marketplace.
Tips
Read the description on each card — it explains the intended use case.
Match category to goal — a docs template gives you sidebar nav; a spotlight template gives you a tight landing flow.
Do not overthink it — templates are starting points; publishing quality matters more than the initial pick.
Automation can create a site from the same marketplace gallery without opening the wizard:
GET /api/v1/templates — list approved templates (slug, label, category, preview_url). Requires sites:read.
POST /api/v1/sites with name, slug, and optional template set to a marketplace slug from step 1. Requires sites:write. The new site clones pages, layout, and styles from the live template host.
In Cursor or other MCP clients, aveiro_list_templates and aveiro_create_site wrap the same routes. Prefer passing a template — blank sites only get a welcome page and default layout.