A portfolio website has a simple purpose: show real work so the right people contact you. Claude Code can build the site quickly, but the result will look like everyone else’s unless you give it specific direction and your own real material.
This guide covers how to plan, prompt, build, and launch a portfolio site. It describes a process, not a set of invented examples, and every example prompt uses placeholders for your own details.
Step 1: Decide what the site must do
Before building, write down:
- Who should find it: the clients, employers, or collaborators you want.
- What you want them to do: email you, book a call, or view a project.
- What you want to be known for: one clear specialty beats a long list.
A portfolio that tries to say everything usually communicates nothing. Pick three things you want a visitor to remember.
Step 2: Gather real work before you prompt
The most common failure with AI-built portfolios is thin, generic content. Collect:
- Three to six projects you are proud of, each with a one-paragraph description of the problem, your role, and the outcome.
- Images or screenshots, compressed and with permission to show them.
- Real results, only numbers you can verify and are allowed to share.
- Client permission for names, logos, and quotes.
- A short bio in your own words.
If you cannot share a project publicly, say so honestly or describe it without identifying details. Never invent clients, testimonials, or metrics.
Step 3: Choose a simple site structure
For most people, a small site is stronger than a big one:
- Home: a clear statement of what you do, who for, and one featured project.
- Work: a grid of projects linking to detail pages.
- Project pages: the problem, your approach, your role, and the result.
- About: your background and how you work.
- Contact: one clear way to reach you.
Optional: a services page and a short blog if you will actually maintain them.
Step 4: Give Claude Code project rules
Create a CLAUDE.md file with your voice, structure, and a “do not invent facts” rule, so each new page follows the same conventions. Our guide to writing a CLAUDE.md includes a template.
Step 5: Prompts that avoid generic results
Vague prompts produce generic sites. Be specific about audience, tone, and layout, and give a reference for the feel you want. Templates to adapt:
Structure prompt
Propose a site map and the content each page needs for a [profession] portfolio aimed at [audience]. Use only the projects and facts I provide. List anything missing as TODO.
Design direction prompt
Design direction: [two or three adjectives, for example calm, editorial, high contrast]. Use [fonts and colors]. Large project images, generous white space, and a visible contact link in the header. Avoid stock-looking gradients and filler icons.
Project page prompt
Write a project page from these notes: [problem, your role, what you did, outcome]. Plain language, first-person if I am the sole creator. Do not add details I have not given you.
Review each result against your real notes. If the tool added a claim you cannot support, delete it.
Step 6: Make the work the hero
Visitors skim. Make it effortless:
- Put your best project first and show it large.
- Use descriptive filenames and alt text for images, such as “kitchen renovation before and after” instead of “image1.”
- Keep project descriptions short with a clear role and result.
- Add a call to action at the end of each project: “Want something similar? Get in touch.”
- Make your contact method obvious on every page.
Step 7: Technical and SEO basics
Even a small portfolio benefits from the basics:
- Titles and descriptions: unique for each page. Generate them with our meta tag and Open Graph generator, and preview them in the SERP preview tool. The social preview image matters when your work is shared.
- Structured data: a Person or Organization block helps search engines understand who you are. Use our schema markup generator and read the JSON-LD guide.
- Image size: portfolio sites are image-heavy. Shrink files with our image compressor before uploading.
- Mobile: most people will view your work on a phone.
- A QR code on a business card or printed piece can point to your work: use our QR code generator.
- Tracking: if you share your site in emails or social posts, tag the links with our UTM builder.
Step 8: Pre-launch checklist
- [ ] Every project has permission to be shown
- [ ] Every claim and number is true and verifiable
- [ ] Contact form or email link works (send yourself a test)
- [ ] Every page has a unique title and description
- [ ] Images are compressed and have alt text
- [ ] The site is readable on a phone
- [ ] No placeholder or “lorem ipsum” text remains
- [ ] Links all work, and there is a custom 404 page
- [ ] Privacy and cookie notices are in place if you use analytics
- [ ] You can edit and update the site yourself
Use the screenshot tool to capture the final version, and compare it as you update the site.
Keep it fresh
A portfolio is never finished. Add a new project when you complete one worth showing, retire work that no longer represents you, and review the site every few months. Check your pages in Google Search Console to see which ones people actually find.
Related reading
Browse Claude Code website examples for inspiration, read about Claude Design for visual exploration, and see how to build a landing page with Claude Code if you want a separate page for a specific offer.
Frequently asked questions
Can I build a portfolio with Claude Code without being a developer?
Many people can, using clear prompts and iterating, but you still need to review the result, test it, and host it. Simple static sites are the easiest starting point.
How many projects should a portfolio include?
Three to six strong projects usually beat a long list. Quality and relevance matter more than quantity.
Should I include prices?
It depends on your business. If you do not list prices, explain how people can get a quote.
How do I stop my site from looking generic?
Use your own real projects, specific design direction, and your own wording. Replace any phrase that could appear on anyone’s site.
Need a portfolio or business site built properly?
Our website and design service can take it from concept to launch. Contact us to start.