Boundless Builders

The public showcase for the builders and projects shipping on Boundless.

---

Important

The previous bounties app is preserved in git history at commit e1a4337 if you need to reference it.

---

Overview

Boundless Builders is a display-only sub-app of the Boundless platform, served at builders.boundlessfi.xyz. It presents the people and work of the ecosystem: builders and their projects and products. Builder, project, and organization detail pages live in the main Boundless app; this app links out to them.

This app only displays data. Creating, editing, and uploading builders and projects all happen in the main Boundless app (boundlessfi.xyz). This showcase reads that data and renders it, so expect mostly read (GET) flows and no creation forms here.

Tech stack

Concern	Choice
Framework	Next.js 16 (App Router, React Server Components, Turbopack)
Language	TypeScript
Styling	Tailwind CSS v4 (CSS-first @theme tokens, no tailwind.config.js)
Components	shadcn/ui (new-york), customized to the Boundless design system
Icons	Design-system icon library (components/icons) + lucide-react
Theme	Dark by default (next-themes), matching the canonical Boundless theme

Design system

The look and feel is lifted directly from the main boundless-platform frontend so this app is visually native to Boundless. The full reference lives in design.md: color scales, semantic tokens, typography, spacing, component patterns, and code style.

If you are contributing UI, read design.md first and follow it strictly. When something is missing, port it from boundless-platform rather than inventing it.

Project structure

app/                  # routes (thin components that compose features)
  layout.tsx          # root layout: fonts + provider tree
  page.tsx            # landing page (nav + hero + footer)
  globals.css         # Tailwind v4 @theme tokens (identical to boundless-platform)
components/
  ui/                 # shadcn primitives, themed to the design system
  layout/             # site header, footer, logo, brand glyphs
  marketing/          # reusable sections and backgrounds (hero gradient, etc.)
  cards/              # project / opportunity display cards
  icons/              # design-system icon library (Linear + Bold)
config/               # marketing-nav (header/footer/social links)
lib/                  # cn() and small helpers
providers/            # theme provider tree (dark default)
public/               # brand assets, logos, currency, illustrations

Getting started

Requires Node >=20.19 (Next 16). Install and run:

npm install
npm run dev

Open http://localhost:3000.

Scripts

Command	Description
npm run dev	Start the dev server (Turbopack)
npm run build	Production build
npm run start	Serve the production build
npm run lint	Run ESLint

Before opening a PR, run the full local check:

npm run lint && npm run build

Contributing

This project is open source and welcomes contributions. Read CONTRIBUTING.md before your first pull request. It is the contributor guide, and it covers the rules that keep this app consistent:

• Follow the design system in design.md. Build UI from the primitives in components/ui and the tokens in globals.css.
• Reuse existing components before building new ones. When something is missing, port it from boundless-platform rather than inventing it.
• Keep this app display-only. Data creation belongs in the main Boundless app.
• No em dashes in code, comments, or copy (house style).
• Attach a UI screenshot on any frontend change so reviewers can see the result.