Blog / Build with AI /
Building a portfolio site with AI
A portfolio site is the most useful personal page you can own. It answers the question every client, employer or collaborator asks first: “Who is this person and what have they done?”
It is also a great project to build with AI. The content is yours, the design can be simple and the result is something you will really use.
The finished thing: a fast, one-page site with your name, a short intro, three to six pieces of work, a way to get in touch, and a title and description that make sense in search.
Start with the content, not the code
The most common mistake is asking an AI for a “beautiful portfolio” before knowing what to put in it. You get a pretty template and empty boxes.
Write these first, in a plain document:
- One-line description of what you do and who for. “Web administrator helping small businesses keep their websites fast, found and working.”
- A short intro, three or four sentences in your own voice.
- Three to six projects. For each: what the problem was, what you did, what changed. Only claims you can stand behind. No invented numbers.
- A contact route. An email address you are happy to publish, or a contact form. Think carefully about publishing a personal phone number.
- Optional extras: a short list of skills or tools, a photo, a link to your writing.
If you have no big client projects, use smaller ones: a site you maintain, a tool you built, a case where you solved a messy problem. Honest and specific beats impressive and vague.
Choose the shape
For a first portfolio, one scrolling page is plenty:
- Header with your name and one-liner
- About
- Work
- Contact
- Footer
No framework, no database. Plain HTML and CSS, with a touch of JavaScript only if you need it. The simpler it is, the faster it loads and the less there is to break.
The prompt
Build a one-page portfolio website as a single HTML file with inline CSS, no JavaScript and no external libraries. Sections: header with my name and a one-line description, an About paragraph, a Work section with project cards (title, two-sentence description, optional link), and a Contact section with an email link. Clean, readable design, system fonts, a restrained colour palette, and a layout that works on a 360px-wide phone. Use semantic HTML (header, main, section, footer), include a proper title tag and meta description, and add alt text placeholders for images. Use the content below.
Then paste your content. Give the AI your real text so it does not invent filler. If it writes copy for you anyway, you are the editor: remove anything that sounds like marketing noise.
Review what you get
Open the file in a browser and check:
- Does it say what you do in the first screen?
- Is the text readable on a phone, without pinching?
- Do the links go where they should?
- Has the AI invented anything? Fake testimonials, made-up client names and statistics are common. Delete them.
- Is it fast? A page of text and a few small images should load almost instantly.
If you need a refresher on reviewing generated code, copying code from AI safely is a good checklist. Then iterate one change at a time: small changes beat big rewrites.
Make it findable
A portfolio nobody can find is a business card in a drawer. Basics for search:
- A clear title tag: your name plus what you do, e.g. “Ada Obi | Web administrator”.
- A meta description of about 150 characters, written for a human.
- A single
<h1>, usually your name or role. - Descriptive image alt text.
- A sensible URL, ideally your own domain.
- Open Graph tags, so links shared on social look right: title, description and image.
Once it is live, add the site to Search Console so you can see whether it is indexed. For a brand-new domain, expect search to take time. A portfolio mostly works as a place to send people, not as a source of traffic.
Images and speed
AI-generated layouts often reference images that don’t exist. Replace the placeholders with your own files, and:
- Resize them before upload; 1200px wide is plenty for most.
- Use compressed formats such as WebP or well-optimised JPEG.
- Give every image a width and height, so the page doesn’t jump while loading.
- Don’t use stock photos that pretend to be your work.
If you use AI-generated imagery, check the licence and be clear about it. AI image tools for websites: what is safe to use goes into that.
Hosting for free
A single-page static site can be hosted on free static hosting services for no cost, including with your own domain. The steps are usually:
- Put the file in a folder named
index.html. - Upload it or connect a Git repository.
- Point your domain at it.
- Check that HTTPS works.
Each provider’s free tier has terms and limits, so read them. And buy the domain yourself, in your name, with an email you control. The hidden costs of free plans is worth five minutes before you commit.
Accessibility and honesty checks
- Text has enough contrast against its background.
- You can tab through all links in a sensible order.
- Headings go in order, not chosen for size.
- Links describe their destination: “Read the project”, not “click here”.
- Nothing claims more than is true.
Accessibility checks for small tools gives a quick routine.
Keep it alive
A portfolio decays quietly. Put a reminder in your calendar every three months to:
- Add a recent project and remove the weakest.
- Check every link.
- Update your one-line description if your focus has shifted.
- Re-check that your contact route still works.
Key takeaways
- Write your content before you generate any design.
- One page, plain HTML and CSS, is plenty.
- Give the AI your real text and delete anything it invents.
- Cover the basics: title, description, headings, alt text, speed.
- Own your domain, host cheaply and update it quarterly.
Related reading
What are the three pieces of work you would be proudest to put at the top of yours?