Prepare Materials

Great websites start before you run aigne web generate. This guide gives you a concrete checklist for collecting briefs, source docs, and proof so WebSmith can build pages that reflect your requirements, cite the right evidence, and require fewer revision cycles.

The preparation workflow

Here's how the process flows from gathering materials to getting your first website:

Each step builds on the previous one. Better inputs mean better output—it's that simple. A well-organized content kit helps WebSmith create authoritative, on-brand pages from the start.

Step 1. Start with the essentials

Create a short brief that answers these four questions. A simple Markdown or Word doc works perfectly:

Save this file inside the project so you can add it to sourcesPath.

Step 2. Gather your content and assets

WebSmith works with what you give it. The more relevant material you provide, the better your website will be. Organize these items into a sources directory:

Recommended content types

Supported formats

Step 3. Organize for clarity

Group your files logically. This makes it easy for both you and WebSmith to find what's needed.

project-sources/

project-sources/
├── 01_briefs/
│   ├── product-overview.md
│   └── audience-matrix.md
├── 02_proof/
│   ├── testimonials.md
│   └── security-metrics.xlsx
├── 03_assets/
│   ├── logo.svg
│   └── dashboard.png
└── 04_content/
    ├── blog/
    └── faq.md

Use descriptive folder names and prefixes. It should be obvious at a glance what each directory contains.

Step 4. Connect your sources in config.yaml

Point the sourcesPath array at the directories (or specific files) you just organized. This is the single most important configuration parameter.

config.yaml

sourcesPath:
  - ./project-sources/01_briefs
  - ./project-sources/02_proof
  - ./project-sources/03_assets
pagePurpose:
  - saas
targetAudienceTypes:
  - businessOwners
  - developers
rules: >
  Highlight 40% cost savings backed by customer quotes. Mention SOC 2 + ISO 27001.

When you run aigne web generate, WebSmith recursively reads those folders, chunks the files, and cites them while writing copy and assembling layouts.

Choose your approach

How much time do you have? Pick the approach that fits your situation.

Quick start: Just need a demo?

Perfect for when you need something up fast and can refine it later.

Recommended: Building something real

This is the sweet spot for most teams launching a real product or service.

Advanced: Team knowledge base

For teams shipping multiple sites or maintaining long-term content systems.

knowledge-base/
├── foundation/
│   ├── mission.md
│   └── brand-voice.md
├── products/
│   ├── payments-overview.md
│   └── payments-technical-specs.md
├── proof-points/
│   ├── case-study-fintech-x.md
│   └── g2-reviews.md
└── audiences/
    ├── developer-persona.md
    └── operator-persona.md

This approach scales beautifully:

Quality checklist

Before you run generate, make sure:

Tips for best results

WebSmith is designed to generate great websites in one shot—but the quality depends on what you feed it.

Next steps