Ship your Folio Forge site

Install Node.js

Astro (which is what Folio Forge exports) needs Node.js 22 or newer. Pick your OS.

winget install OpenJS.NodeJS.LTS

node --version

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew install node@22 && brew link --overwrite node@22

node --version

You should see v22.x.x or higher. If you see command not found, restart your terminal first.

Install Git

winget install Git.Git

brew install git

Verify in either OS:

git --version

Create a GitHub account

1. Go to github.com/signup
2. Pick a username — this becomes part of your repo URLs (github.com/your-name/repo)
3. Verify your email address

Free tier is fine. You'll never need anything more.

Create a Cloudflare account

1. Go to dash.cloudflare.com/sign-up
2. Verify your email

Free tier covers static-site hosting (Cloudflare Pages) for portfolios at any reasonable traffic level.

Buy a domain on Cloudflare Registrar

Cloudflare sells domains at wholesale price — no markup, no upsells, no parked-page ads.

1. In the Cloudflare dashboard, go to Domain Registration → Register Domains
2. Search the domain you want
3. Add to cart, complete payment

Done. Your domain is automatically on Cloudflare DNS — no nameserver setup needed. About $10 USD/year for a .com.

Export from Folio Forge

1. Open Folio Forge
2. Build your portfolio — pick a template, edit sections, set theme tokens, choose motion presets
3. Click Export in the top-right of the builder
4. Click Download Astro project — a .zip downloads

The ZIP contains a complete, runnable Astro 6 project. Nothing else is required to deploy it.

Extract the ZIP and open a terminal in that folder

Move the ZIP somewhere you keep code (e.g., Documents/Code/) and unzip. Result is a folder like my-portfolio/.

Install dependencies and preview locally

npm install

Wait for it to finish (~30 seconds). Then:

npm run dev

Open the URL it prints (usually http://localhost:4321/) in your browser. You should see your portfolio. Press Ctrl + C in the terminal when you're done previewing.

Initialize git in your project

git init -b main
git add .
git commit -m "Initial commit"

If git asks you to set your name/email first, run this once with your real values:

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

Create a new repo on GitHub

1. Go to github.com/new
2. Repository name: my-portfolio (or whatever you want)
3. Visibility: Public or Private — both are free
4. Important: Don't check any of Add a README / .gitignore / license. Your local repo already has files; pre-filling these creates a merge mess.
5. Click Create repository

Push your local repo to GitHub

GitHub shows a snippet on your new empty repo's page. Use the "…or push an existing repository from the command line" block. It looks like this — replace YOUR_USERNAME:

git remote add origin https://github.com/YOUR_USERNAME/my-portfolio.git
git push -u origin main

You'll be prompted to log in. On Windows, the Git Credential Manager opens a browser flow. On Mac, you'll likely use a Personal Access Token as the password (your GitHub password no longer works for git over HTTPS).

Connect Cloudflare Pages to your GitHub repo

1. In the Cloudflare dashboard sidebar, click Workers & Pages
2. Click Create → Pages → Connect to Git
3. Authorize Cloudflare to access GitHub (a popup walks you through this)
4. Select your my-portfolio repo

Configure the build

Cloudflare auto-detects Astro. Confirm these values:

• Framework preset: Astro
• Build command: npm run build
• Build output directory: dist
• Root directory: / (default — leave alone)

Under Environment variables (advanced) → Add variable:

• Name: NODE_VERSION
• Value: 22

Click Save and Deploy.

Watch the first deployment

Cloudflare runs npm install && npm run build on its own runner. About 60-90 seconds. When it's done, your project gets a URL like:

my-portfolio-abc.pages.dev

Click it. Your portfolio is live on the internet, just not on your domain yet.

Point your domain at the project

1. In your Cloudflare Pages project, click Custom domains
2. Click Set up a custom domain
3. Type the domain you bought in step 5 (e.g., yourdomain.com)
4. Cloudflare detects that the domain is on Cloudflare DNS and creates the CNAME record automatically. You'll see Active within ~1-5 minutes.

If you also want www.yourdomain.com to work, repeat with www as a separate custom domain.

Install Node.js and Git

Same as steps 1-2 of the manual path. Jump back up if you skipped them.

Install Claude Code

npm install -g @anthropic-ai/claude-code

Then sign in (browser flow):

claude

Follow the prompts. You'll need an Anthropic account; the free tier is enough for a deploy.

Open Folio Forge, export, unzip, cd in

Same as steps 6-7 of the manual path. End up at:

cd ~/Documents/Code/my-portfolio

Start Claude Code in the project folder

claude

Claude reads the project, then waits for you.

Tell Claude what you want

Paste exactly this (replace yourdomain.com with your real domain):

Deploy this Astro project to Cloudflare Pages on the domain yourdomain.com.

Verify the build works first (npm install, npm run build). Then:
- Initialize git if not already
- Create a new GitHub repo named "my-portfolio" (use gh CLI if available)
- Push the project
- Create a Cloudflare Pages project connected to that repo (use wrangler if available)
- Configure NODE_VERSION=22 as an environment variable
- Add yourdomain.com as a custom domain
- Verify the site is live and report back the URL

Pause and ask me before any destructive action.

Hit Enter. Claude does the rest, asking for permission before each non-reversible step.