Back to projects
Projectintermediate 9 steps ~120 min

Portfolio with Next.js

Build a fast, accessible portfolio: content as data, semantic landmarks, responsive CSS with grid and clamp, tested SEO metadata, tag filters, flash-free dark mode, then Next.js static pages per project, a sitemap, deployment, and case studies that get interviews.

What you'll build

A deployed portfolio with a page per project, good link previews, and case studies that show how you think.

  • Next.js
  • App Router
  • CSS grid
  • SEO metadata
  • deployment
Project briefrequirements and design decisions

Requirements

  • Home, about, and projects pages with shared navigation
  • Fast first load and good SEO (title, description, Open Graph)
  • Responsive layout from phone to desktop

Architecture decisions

  • Static generation for every page: content changes only on deploy
  • Project data in one typed file, rendered by reusable components
  • next/image for responsive, optimized images

Stretch goals

  • Blog with MDX
  • Dark mode without a flash on load
  • Contact form via a server action

Production checklist

  • Lighthouse scores in CI
  • Custom domain and analytics
  • Accessibility check of navigation and color contrast

1What we're building

A portfolio is the one project everyone who hires you will look at, usually for under a minute, often on a phone. It needs to load instantly, be easy to scan, and show the kind of care you'd bring to their product.

You'll build a one-page portfolio first, in the playground, with:

  • Content as data: your profile and projects in one file, rendered by components
  • Semantic structure: landmarks, headings, and a skip link, so it works with assistive technology
  • Responsive layout with modern CSS (grid and clamp()), mostly without media queries
  • Project filters by technology
  • Dark mode that follows the system setting and remembers your choice

Then you'll move it into Next.js (App Router), with one page per project, real SEO metadata (built with a helper you'll test), optimized images, a sitemap, and deployment to Vercel.

The sample content describes the projects you can build on Bloom. Replace it with your own as you go.

1data.js your content 2App.jsx the page 3ProjectCard.jsx one project 4projects.js tag helpers 5ThemeToggle.jsx dark mode 6styles.css design tokens, layout, and themes
Portfolio with Next.js project | Bloom