devfolio.page

your portfolio as code

version control it like software.
generate beautiful static sites from YAML.

npm install -g devfolio-page
GET STARTEDLEARN MORE

FEATURES

YAML-BASED

Write your portfolio in clean, structured YAML. Separate content from design. Easy to read and edit.

MULTIPLE THEMES

Choose from SRCL terminal aesthetic, modern minimalism, or dark academia. Or build your own.

DEV MODE

Live development server with auto-rebuild. In-memory builds for faster iteration. No site/ folder clutter.

STATIC OUTPUT

Generates lightweight HTML/CSS/JS. Deploy to Vercel, Netlify, GitHub Pages. No server required.

QUICK START

GET STARTED IN 5 STEPS

1

Install devfolio-page

npm install -g devfolio-page

Requires Node.js and npm. Don't have them? Install Node.js first.

2

Create your portfolio

devfolio-page init

Answer a few questions to create portfolio.yaml with your basic info

3

Add your content

cd my-portfolio

Open the folder in your editor (VS Code, Cursor, etc.) and add projects, experience, writing to portfolio.yaml. See docs for examples.

4

Render your site

devfolio-page render

Generates your site with all pages (home, projects, experiments, writing) in the site/ folder.

5

Preview with dev mode

devfolio-page dev

Opens at localhost:3000 with live reload. Edit portfolio.yaml and save to see updates instantly.

Ready to deploy? Upload the site/ folder to Vercel, Netlify, or GitHub Pages.