Buildboard user docs
This is the user-facing documentation area for Buildboard. It should stay current as the product evolves.
What Buildboard does
Buildboard gives a small product team one public place for feedback, roadmap visibility, and changelog updates.
Current user flows
- request a login link
- verify the link and start a session
- get a first workspace automatically
- publish a public board page
- share the public board or embed it
Auth and workspace setup
Buildboard is moving toward a more direct self-serve product flow: signup, email verification, login, and password recovery. The current scaffold still reflects earlier auth work, but the product direction is now more account-led than waitlist-led.
The public workspace route scaffold currently follows the pattern /w/your-slug.
For the implementation direction, see the auth + hardening roadmap or try the current auth UI scaffold at /auth.html.
Owner settings flow
The owner dashboard is evolving to let a founder manage the basics of their workspace directly. The first settings flow focuses on:
- workspace name
- workspace slug
- public tagline
This is the foundation for later owner-side flows like feedback moderation, embed setup, and roadmap/changelog management.
Embed overview
The free-tier embed will keep visible Buildboard attribution and expose targetable CSS classes so the host site can adapt colors and spacing.
<iframe src="https://buildboard.italyinsider.net/embed/your-slug" width="100%" height="760" style="border:0;border-radius:12px;" loading="lazy"></iframe>
The live scaffold route is /embed/your-slug.
Embed CSS class reference
.bb-embed— root wrapper for the full embedded Buildboard surface; use it to set base font, colors, spacing, or global background treatment..bb-embed__header— top section containing workspace title and short context; use it to adapt header background, border, and typography..bb-embed__feedback-list— container around the feature-request list; useful when you want feedback requests to visually match cards or panels from the host site..bb-embed__roadmap-list— roadmap section wrapper; use it to style roadmap blocks differently from feedback or changelog areas..bb-embed__changelog-list— changelog section wrapper; useful for update/news styling on the host site..bb-embed__card— generic reusable card block inside the embed; use it for borders, shadows, padding, and surface color..bb-embed__button— action buttons such as vote or interaction controls; use it to align button colors and radius with the host brand..bb-embed__attribution— the free-tier attribution strip linking back to Buildboard; keep it visible, but you can adapt its colors so it fits the host site better.
Example host-side CSS override
.bb-embed {
--host-accent: #f97316;
}
.bb-embed__header,
.bb-embed__card {
border-color: rgba(249, 115, 22, 0.35);
}
.bb-embed__button {
background: var(--host-accent);
}
Feedback to roadmap workflow
Buildboard is evolving toward a visible loop:
- a visitor submits a feature request
- the owner reviews it
- the owner links it to a roadmap item
- the roadmap item later moves toward shipped
- the changelog closes the loop publicly
Related pages
Docs roadmap
- auth guide
- workspace setup guide
- embed customization guide
- feedback-to-roadmap workflow guide