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 |
What is in the package
Section titled “What is in the package”- 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.pdfbehind “Download CV”. - Search and sharing: a title, a description and a canonical link for every page, share cards, a browser icon,
sitemap.xmlandrobots.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.mdandLICENSE.md.
In a hurry: the first 15 minutes
Section titled “In a hurry: the first 15 minutes”npm installnpm run dev- Open http://localhost:3000.
- Put your name, title, description, domain and e-mail in
site, and your social links insocial, insrc/content/site.ts. - Write your profile card, your section texts, testimonials, experience and questions in
src/content/pages/home.ts. - Replace the photos in
public/images/(keep the file names and you are done), and your CV inpublic/cv.pdf. - Set your logo and browser icon (Making it look like your brand).
- 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. - Point the two forms at your inbox or your tools: Forms.
- Deploy: Going live.
Nothing else is required: the site has no database, no account to create and no paid service to run.
How this template is put together
Section titled “How this template is put together”- Content is data. All text and every collection item live in
src/content/. Pages read the collections throughsrc/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 insrc/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 insrc/components/, and all are shown at/style-guideon 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.
Getting help
Section titled “Getting help”- Your licence terms: License.
- What changed in each release: Changelog.
- Support and updates: https://framebrick.co/support.
- Want it done for you? Marcframe, the studio behind this template, updates templates to your needs, builds custom templates and designs new sites. It’s also on Contra.