Verify & Build

This section checks your setup for problems and produces your finished site. Think of it as a preflight checklist before takeoff.

Verification

Click Check for issues to scan your entire configuration. The checker looks for two things: errors that would break your site, and warnings about things that might look incomplete. Most people see a few warnings on their first check. That’s normal.

Errors

Errors block the build. These need to be fixed first.

Error	What It Means
Page title is empty	Your page needs a title. Set one in Profile.
No heading set	Your page needs a name or headline. Set one in Profile.
No background color	Your page can’t render without a background color. Set one in Brand Style.
No text color	Nothing on your page will be readable without a text color.
Text-to-background contrast below 3:1	Your text and background colors are too similar. Visitors won’t be able to read your page.

Warnings

Warnings won’t block your build, but they flag things worth a second look.

Profile: No bio or no profile photo. Your page will work without these, but visitors won’t know much about you.

Social links: No social links added, or links that are missing a URL. Empty links get hidden from your page automatically.

Theme: Text and background colors are close in brightness, muted text (subtitles, dates, labels) might be hard to see, or no font is selected. The color warnings are worth paying attention to. A page that’s hard to read loses people fast.

Tiles: A tile is added but missing a required field (API key, username, token, location, or date depending on the tile type). The checker tells you exactly which tile and which field.

Content: No content added below the profile, or links and feed cards missing required fields like a URL, Channel ID, or feed address.

SEO: No meta description or no share image. Your page will still work, but link previews on social media won’t look as polished.

Working Through Results

Results are grouped by wizard section, with errors listed first. Each result has a Fix link that takes you directly to the relevant section. After fixing issues, click Re-check to verify again.

Building Your Site

Click Build site to generate your finished site. The build takes a few seconds and produces a dist/ folder containing everything you need to go live.

If you haven’t run verification yet, clicking Build runs it automatically. If errors exist, the build pauses until you fix them. Warnings are fine to ship with.

Build States

State	What You’ll See
Before verification	”Check for issues first to enable building”
Errors present	Build button is disabled: “Resolve errors above to enable building”
Warnings only	Build is available. You can proceed.
All clear	Build is available with full visual emphasis
Building	A spinner with “Building…”
Success	Green confirmation: “Build complete. Your site is ready.”

After Building

Your finished site is in the dist/ folder inside your Beacon project. Upload it to a hosting provider to go live. The wizard shows hosting options directly below the build area, or see the Hosting guide for details.

Terminal Alternative

If you prefer the command line, click Or run manually in your terminal to reveal the build command:

npm run build

This produces the same dist/ folder.