Skip to content
Sign inJoin waitlist

Brickfolio documentation — Next.js

Everything you need to take Brickfolio for Next.js from the downloaded folder to a published portfolio. Read in this order, or jump to what you need.

Guide What it covers
Install and run Requirements, install, the commands, what is in each folder
Editing the content Editing your details, Home’s sections, projects, services and posts, images and the CV — no CMS needed
Making it look like your brand Colours, the logo and the browser icon, fonts, text styles, spacing, motion, components, the style guide
Pages and sections The header, the sections of every page with a map of each, the 19 addresses, adding, removing and reordering sections and pages
Forms Making the contact form and the newsletter box deliver to you
Using a headless CMS The collections and their fields, for connecting Sanity, Payload, Strapi, Directus or any other headless CMS
Going live Pre-launch checklist, deploying, domains, what to do after launch
Troubleshooting and questions Errors, questions and answers
  • 4 kinds of page, 19 addresses:
    • Home, one long page with every section, and the 404 page;
    • a page for each of the 6 projects and the 12 posts, built from the collections (Pages and sections).
  • 3 collections in src/content/collections/: projects (projects.ts, 6), services (services.ts, 4, shown on Home only) and posts (posts.ts, 12).
  • 2 forms: the contact form on Home and the newsletter box in the footer of every page, with server actions and four ways to deliver them (a log, a webhook, Mailchimp, Resend).
  • A sticky header whose links jump to Home’s sections from every page, with a menu that opens under it on phones.
  • A profile card that sticks beside Home’s column from laptop width, with roles that step every four seconds.
  • Motion from the original design (tickers, spring hovers, the service cards’ moving photos), with reduced-motion support, and a style guide of every component at /style-guide.
  • A sample CV at /cv.pdf behind “Download CV”.
  • Search and sharing: a title, a description and a canonical link for every page, share cards, a browser icon, sitemap.xml and robots.txt.
  • Placeholders: the photos in public/images/ are grey placeholders that show their sizes (the demo uses photos from Unsplash and Pexels, or made for the template, which can’t be sold with a template). The client logos are Logoipsum placeholder logos.
  • These docs (docs/), the design system’s reference (Brickfolio design system), CHANGELOG.md and LICENSE.md.
Terminal window
npm install
npm run dev
  1. Open http://localhost:3000.
  2. Put your name, title, description, domain and e-mail in site, and your social links in social, in src/content/site.ts.
  3. Write your profile card, your section texts, testimonials, experience and questions in src/content/pages/home.ts.
  4. Replace the photos in public/images/ (keep the file names and you are done), and your CV in public/cv.pdf.
  5. Set your logo and browser icon (Making it look like your brand).
  6. Write your projects, services and posts in src/content/collections/ (Editing the content). Search for “Javier” and “Brickfolio”: the demo’s person and name are written in many places.
  7. Point the two forms at your inbox or your tools: Forms.
  8. Deploy: Going live.

Nothing else is required: the site has no database, no account to create and no paid service to run.

  • Content is data. All text and every collection item live in src/content/. Pages read the collections through src/lib/content.ts, which is why swapping in a CMS later touches one file, not the whole site.
  • Design is tokens. Colours, breakpoints, shadows and easing are in src/design-system/theme.css; text styles, springs and ticker speeds in src/design-system/tokens/. Change a token and every page follows (Making it look like your brand).
  • Components are shared. Every card, button, ticker and form is in src/design-system/, the sections in src/components/, and all are shown at /style-guide on your own site.
  • One page, many anchors. The header’s Portfolio, Services, Resume, Blog and Contact are links to sections of Home (#project, #service, #resume, #blog, #contact), so they work from a project or a post page too.