Tutorial

Build a company website

Give PitchStation a brochure or a short description, and AI drafts the whole site. You edit it, send it to your client for approval on a link, and publish it to your own server once they approve.

🖥️ Everything here happens on the Website page (choose Website in the sidebar). On a phone, the mobile app covers most of it (§08). If you'd rather let an AI assistant do the work, see §09.

§01The whole journey in one picture

Draft, generate, client review, publish 1 · DRAFT 2 · GENERATE 3 · CLIENT REVIEW 4 · PUBLISH brochure, text or presetAI fills the content a style + your editspreview before anyone sees it one link to the clientApprove ✓ or Request changes your server, your domainor download a .zip you do steps 1, 2 and 4; your client only ever opens a link in step 3, with no account needed change the site after approval and it goes back to review, so the client always approves what actually goes live

§02Before you start

✨ AI help has a daily allowance of 60 requests per person, shared by brochure reading, drafting from a description and the ✦ AI rewrite buttons. That's plenty for several sites a day; if you run out, the editor still works by hand and the allowance resets the next day.

§03Draft the site

Open Website. The ✨ Create new tab walks you through four numbered steps: the draft, your brand assets, the content and the style.

1Upload brochure — or describe the company

Pick whichever source you have:

From a PDF, PitchStation also pulls out the pictures. Under Image candidates from the PDF, click Use as logo, Use as hero or Material on any of them.

📄 If the brochure is a scan (photos of pages rather than real text), there's no text to read, and you'll be told so. Type a short description instead, or fill in the forms by hand. On a phone, the mobile app can read photographed pages (§08).

2Brand assets

3Content

The draft lands in cards you can edit directly: Company, Brand (this site), Hero, About, Insights (monthly updates), FAQ and Contact. Read every card before you generate. AI drafts are a starting point, and only you know whether the phone number and the claims are right.

Rewrite any paragraph with ✦ AI

Every text box has a ✦ AI button. Choose Shorter, More formal, More vivid, → English or → 中文, or type your own instruction and click Rewrite. You see the suggestion next to your text and pick Use this or Discard. Nothing changes until you choose.

§04Choose a style, preview and generate

A site wears either a style family or a classic template.

Step 4: Choose a style

Click Preview my content in every style. Each card shows your client's own content in one style. Palette chips switch the palette; Desktop and Phone switch the view; tick two cards and Compare the two; On my phone makes a QR code for a phone preview. Cards also list the Photos you will need and warn when a style's showcase sections are still empty. After an AI draft the suggested style is marked Suggested (and selected, unless you already picked one or your account is partner-locked), and Also a fit marks up to two more, each with its own reason; when the content gives no hint, nothing is suggested. Use it as the accent copies a colour read from the logo into the Brand card. In 🗂 Manage / update, Change style opens the same gallery for a saved site.

The template select beside Generate website follows your choice (classic templates and style families in two groups). Moving a site to another kind of style keeps its content; the section order starts again from the new style's own, and pages whose sections the new style lacks are trimmed (the page says so).

The phone link from the QR code opens without signing in, for one hour: anyone who has it can see that preview. At most five stay open per person; a new one closes your oldest. The gallery's pictures are made on the server when the server has them switched on; otherwise the cards are live previews of the same pages.

On a partner-locked account the template select shows what will render and is disabled: a classic template renders as the partner template, and a style family keeps its design in the partner's colours, fonts and logo treatment. Manage uses the site owner's lock and brand, also when a co-manager opens the site.

The Brand card

Brand (this site) sets this site's Accent, Ink (text) and Paper (page ground) (picker or hex, with live contrast badges) and its Font pair for Latin headings and body (Montserrat, Inter, Playfair Display or Lora). On a style family it also offers Logo treatment (original colours, one colour in the ink, one light colour, or on a white chip) and, where the family uses them, Photo grade (Industrial Spec, Maison Luxe), Seal text of 1–8 characters (Ink & Seal) and Brand name on two lines (Tech Launch, Friendly Local, Grand Corporate: the name with one | where the second line starts, such as Harbour|Coffee; when it no longer spells the name, the style splits the name itself). Each field says where its value comes from: this site only, account default, the style's own or the partner lock (whose fields are disabled). From the logo reads an accent from the logo on the server; Reset to account default gives a field back to the account.

Only the fields you change are stored, in content.meta.brand (accent, ink, paper, font_pair, logo_treatment, seal_text, photo_grade, name_break); the rest follow the account's brand tokens, so a later account rebrand still reaches them. On a style family the brand colours also move the family's own accent shades with them (each family's pack decides which follow and how), text that would no longer read is lifted to its contrast, and a font pair maps to the family's self-hosted faces. Classic templates use the accent, ink and paper (ink and paper together) and the font pair.

Preview before saving

Preview, beside Generate and Save, opens a pane with the page at 1280 pixels scaled to fit, or on a phone, and the render notes in words. It saves nothing: no revision, no quota, no change to a review. It renders what a save would: the template after a partner lock, the site owner's brand for a saved site, the self-hosted fonts. Where a page cannot load a video player (the editor's previews, a review link), the video box says it plays on the published site.

Read the render notes

Generate, Save and Preview tell you what to check, in words on the page; integrations get the codes:

CodeWhat it means
CONTENT_CAPA family shows only part of a list (field, shown of sent). The content is kept; shorten the list or pick a style that shows it all.
BRAND_CONTRASTInk on paper reads below 4.5:1.
BRAND_ACCENT_ADJUSTEDThe accent is too light or dark for text on this page: text uses an adjusted shade; buttons keep the accent.
BRAND_SCHEMEYour paper turns a light style dark (or a dark one light); the note names the style's palettes drawn for that ground, if it has any.
BRAND_LOCKEDThe partner lock pins this field; the partner's value is used.
BRAND_NAME_BREAKThe two-line name no longer spells the brand name; the style splits it itself.
BRAND_PAIRA classic template takes ink and paper together; a lone one was not applied.
BAD_BRANDA brand value that cannot be used. On a style family, a field it reads is refused with 400 BAD_BRAND; elsewhere the note says it was left out.

Generate and Save return the notes in warnings[]. Font problems come separately, in fontWarnings[] (FONT_MISSING, FONT_SUBSET_FAILED), only on a server that lets family sites fall back to system fonts; a production server refuses instead with 503 FONTS_UNAVAILABLE. Preview answers with the page, so its notes travel in headers: X-Render-Warnings (JSON: CONTENT_CAP, the brand codes and the content-field notes as {code, path}) and X-Font-Warnings. The two share one 1,536-byte budget, font notes first and at most 384 bytes, so they fit nginx's default 4 KB response-header buffer: a long list is cut, so read a save's warnings[] for the complete set.

Generate

Click Generate website. The Your website is ready panel shows the site with three actions:

Keep editing and click Regenerate this site as often as you like. It updates the same site, so any link you've already sent keeps working. Start a new site instead clears the editor for a different company. If you close the tab mid-draft, the page offers Continue that draft when you come back.

§05Get your client's approval

Under Review & publish, click Submit for review. Optional settings:

You get a link like https://pitchstation.ai/s/<slug>?k=… with Copy, Open and a QR code. Send it however you like. Your client opens the actual site with a bar on top saying “Review this website”, and clicks either Approve ✓ or Request changes with a note on what to change. A client without an account just types their name, so you know who decided.

Let the client choose between styles

For a saved site, tick Let the client choose the style before you submit. Option 1 is the site's current style; pick one or two more in the gallery that opens (another family, or the same family in another palette), then click Submit with 2 styles or 3 styles. Each style is rendered once, from the same content, into the exact pages the client will see.

The review bar then shows the styles as tabs, in the site's language. On a tab other than the current choice the client sees Choose this style and Request changes; choosing makes that style the version under review (it neither approves nor publishes), and the client can change their mind until they approve or ask for changes. Approve ✓ appears only on the style under review, so the approval binds to the bytes the client chose. When a reviewer email names a PitchStation account, only that person can choose; you cannot choose for them. You and your co-managers get one email and push notice per burst of choices, about 90 seconds after the first, naming the latest one, and your page shows which style was chosen.

Editing the site drops the offered styles (the review moves to revising): submit again to offer them again. If your partner lock changes after the link went out, the client is told the styles no longer render as sent; submit the review again.

The status pill on your page follows along: draft → in review → approved, or changes requested. Make the changes, regenerate and submit again. As long as you keep the same reviewer, the client keeps the same link.

🔁 Approval covers one exact version. If you edit a site that's in review, approved or already live, its status becomes revising and it needs approval again before the next publish. That way the client always approves what goes live. Once a site is approved, a 🧾 Create invoice for this site link appears.

§06Publish it live

PitchStation publishes to a server you control over SSH, and can set up nginx or Caddy and an HTTPS certificate for you. You set the server up once and reuse it for every site.

1Add a deploy target

Under Deploy targets (your VPS), click + Add a deploy target and fill in the label, host or IP, SSH user and port, web root, web server (nginx + certbot, Caddy, or none), domain settings and an SSH private key. Click Save target, then Test. The key is stored encrypted and never shown again. If your administrator has already assigned you a server, it's listed as Assigned by admin and you can skip this step.

2Give the site an address

Under Site address, either type a short name (the site becomes name.<base domain>) or paste a full domain you own, such as www.client.com, then click Save address. Names are unique across PitchStation, so if one is taken, try another.

Agencies can claim a domain once for the whole account in the 🗂 Manage / update tab, under Account base domain: enter e.g. sites.youragency.com, click Claim, add the TXT record and the wildcard A record it shows you, then click Verify DNS. After that, every site can be client.sites.youragency.com.

Save your site address and intended server before review. For an external hostname, add the TXT ownership record shown after saving, then save again to verify it. Changing the address updates the canonical URLs and requires a new review. The publish check refuses to deploy approved content under a different address.

3Publish

Under Publish live, click Deploy to VPS to do it in one go. To check first, click Preview deploy plan, read what will happen, then Publish live. The site is then at https://<your address>/.

Publish history lists every release; Roll back last release restores the previous one. Once live, Live traffic — published site shows 30 days of visits, top pages and where visitors came from. It uses no cookies and honours Do Not Track.

▶️ Videos on a published style-family site. The site's security policy lets the page load only what it plays: its own fonts, the YouTube, Vimeo, Bilibili and Tencent Video players, and the exact origin (https:// and the host) of each linked .mp4 file, at most eight origins per site. Serve an .mp4 over https:// from that host itself: a file that redirects to another host is blocked. The Bilibili and Tencent Video players have not yet been tried on a published site; play one on a test site before you promise it to a client. Classic templates keep their policy and play YouTube and Vimeo.
🔐 Publishing needs a few things in place. The current version must be approved (§05), and if you signed up yourself, your email address must be verified (the link in your welcome email). Publishing also needs the deploy permission on your account and live deploys switched on for your server. If the page tells you either is missing, your administrator can turn it on. Until then, the .zip bundle from §04 works with any hosting.

§07Keep it up to date

Switch to 🗂 Manage / update and pick the site under Choose a website.

§08On your phone

Open pitchstation.ai/m/website/ (or tap Open app on the banner when you visit Website on a phone) and add it to your home screen. In the app you can:

Adding servers, the full section editor, the Brand card and the classic page layouts are on the desktop page, and so is moving a style-family site back to a classic template. Quick edits use the site owner’s partner lock; a new draft uses your account’s. The phone preview shows the home page only.

§09Let your AI assistant build it

Once your assistant is connected (Connect your AI), it can run the whole journey with the MCP tools pitchstation_website_generate, …_update, …_status, …_submit_review and …_publish. Ask in plain words, for example “Make a website for YOUR_COMPANY from this brochure text, use the Friendly Local style, and send it to APPROVER_EMAIL for approval.” The tools set a style through content.meta.template and meta.palette, and the review tool submits the saved style only: style suggestions, the gallery and offering the client two or three styles go through the REST routes below.

For a long text brief, use POST /api/website/generate?async=1 and poll GET /api/website/extract/jobs/<jobId>. Keep a stable external_ref when retrying. A pending response means the work is still running. With a full content model, set the template on content.meta.template; meta_overrides applies to the brief path.

Without MCP, use an API token with the Website integration scopes (websites:read, websites:write, websites:publish):

# 1. draft content from text (or send a PDF as multipart field "pdf")
curl -X POST https://pitchstation.ai/api/website/extract \
  -H "Authorization: Bearer $PITCHSTATION_TOKEN" -H 'Content-Type: application/json' \
  -d '{"text":"YOUR_COMPANY is a Kaohsiung studio that designs…"}'

# 2. build the site; the logo is a data: URI
curl -X POST https://pitchstation.ai/api/website/generate \
  -H "Authorization: Bearer $PITCHSTATION_TOKEN" -H 'Content-Type: application/json' \
  -d '{"content":{…from step 1…},"assets":{"logo":"data:image/png;base64,…"},
       "external_ref":"crm-1042"}'

# 3. save the intended server and address BEFORE review
PUT /api/website/<deckId>/domain          {"subdomain":"harbour-c","targetId":3}
# For a full external domain, complete the returned TXT ownership proof and save again.

# 4. send for approval; after the customer approves, publish to the SAME target/address
POST /api/website/<deckId>/submit-review   {"approverEmail":"APPROVER_EMAIL"}
POST /api/website/<deckId>/publish         {"targetId":3,"dryRun":false}

Re-sending the same external_ref returns the existing site instead of making a duplicate, so a retry is safe. A changed canonical address needs a new approval; SITE_URL_REVIEW_REQUIRED means save the address with the intended target and re-submit for review. The full schema is in the Website OpenAPI; the API reference gives a shorter overview.

Styles through the API

§10Server settings

For whoever runs the PitchStation server; every setting is in .env.example.

§11If something goes wrong

You seeWhat it means / what to do
“…took too long to respond”The connection dropped while a brochure was being read. Upload it again; very large PDFs go faster split into the pages that matter.
“…expired or the server restarted; upload again”The server restarted while it was reading your file. Upload it again.
No text found / scanned PDFThe PDF is pictures of pages. Type a description, or photograph the pages in the mobile app.
Too many uploads at onceUp to five brochures can be read at the same time per account. Wait for one to finish.
Video link refused (BAD_VIDEO_URL)The style cannot play it. Its reason: SHORT_LINK (a b23.tv or other short link: paste the full page link), SERIES_LINK (a Tencent Video series page: open the episode and paste its link), INSECURE (an http:// .mp4: use https://) or UNSUPPORTED. Classic templates play only YouTube and Vimeo.
Style suggestion refused400 BAD_CONTENT, BAD_LOGO or NOTHING_TO_SUGGEST: send valid content, an accessible saved deckId or a logo. A missing saved site is 404; 413 SUGGEST_INPUT_TOO_LARGE means the content holds more than 32 MB.
BAD_CONTENT or ASSET_TOO_LARGEContent nested deeper than 1,000 levels is refused on every content route. A logo or icon longer than about 9.2 million characters is refused before it is decoded; photos of any size are resized to 1,600 px instead (a request may carry 110 MB in all).
FONTS_UNAVAILABLE (503)The server cannot prepare a style family's fonts. Try again in a moment; if it persists, the operator installs the font sources (§10).
The client cannot choose a styleREVIEWER_REQUIRED: sign in as the reviewer the link was sent to. REVIEW_CHANGED: reload the page. STYLE_LOCK_CHANGED: your partner lock changed, so submit the review again. STYLE_CHOICE_RATE_LIMITED: wait a few minutes.
AI allowance used upYou've made 60 AI requests today. Carry on editing by hand; it resets tomorrow.
Name already takenSite names are unique across PitchStation. Pick another, or use your own domain.
Publish refused: approval requiredThe current version hasn't been approved. Submit it for review (§05) and publish after the client approves.
Publish refused: email not verifiedClick the verification link in your welcome email, then try again.
Live deploys are disabled on this serverYour administrator hasn't switched live publishing on. Download the .zip bundle meanwhile.
A site or daily-publish limitYour plan caps how many sites you keep and how often you publish a day. Delete an old test site, or ask your platform contact.
PitchStation · Building a company website · updated 2026-11-03
Related: open the Website page · sending a contract for signature · sharing with a team · tutorials