·7 min read

How to build a portfolio website with AI coding tools

A step-by-step guide to building a professional portfolio website using vibe coding tools like Lovable, Bolt, and Claude Code. From choosing a layout to deploying the finished site.

How to build a portfolio website with AI coding tools

Short answer: Build a portfolio website with AI by describing your work and pasting a design template into an AI coding tool like Lovable or Bolt. The template sets the visual quality. The AI generates the code. You fill in your projects and deploy. The whole process takes under an hour.

A portfolio website has one job: show your best work in a way that makes someone want to hire you or work with you. Every design decision serves that goal. The layout should make your projects easy to browse. The typography should be clean enough to disappear. The overall impression should be that you care about quality, because you do.

AI coding tools make it possible to build a portfolio site in a single session. The risk is that without a design reference, the result looks like every other AI-generated page: safe, generic, and indistinguishable. This guide shows how to use design templates to control the quality and build a portfolio that looks intentional.

Choose the right layout for your work

The layout depends on what you are showing. A visual portfolio for a designer or photographer needs large images in a grid or masonry layout. A developer portfolio needs project cards with descriptions and links to live demos or repositories. A writer or strategist needs a clean list with titles, descriptions, and publication dates.

The mistake most people make is choosing a layout that does not match their content. A developer with three projects does not need a twelve-column masonry grid. A photographer with fifty images does not need project cards with long descriptions. Pick the layout that makes your specific work look its best, not the layout that looks most impressive when empty.

Browse the landing page template library for layout options. The hero templates work particularly well as portfolio headers because they establish a visual identity in the first section.

Set the design direction with a template

Before you open your AI coding tool, find a design template that matches the tone you want. A portfolio for a fintech product designer should look different from a portfolio for a freelance illustrator. The template sets the tone.

Copy the template HTML and paste it at the top of your prompt. Then describe your portfolio: your name, your role, a one-sentence bio, and a list of three to six projects with titles and one-sentence descriptions. The AI uses the template as the visual reference and your description as the content. The result is a complete page that matches the template's design quality.

This works in Lovable, Bolt, Replit, Claude Code, and Cursor. The template is the design input. The prompt is the content input. The AI combines them.

Landing page templates

Landing page templates

Full-page layouts for portfolios, personal sites, and product pages. Designed for vibe coding tools.

Write a portfolio prompt that works

A good portfolio prompt has three parts. First, the design reference: the template HTML. Second, the structure: what sections the page should have. Third, the content: your actual information.

A minimal portfolio needs four sections: a hero with your name and role, a projects section with your best work, an about section with a short bio, and a contact section. Do not add sections that have no content. A testimonials section with fabricated quotes is worse than no testimonials section. A blog section with no posts is worse than no blog section.

Be specific in your prompt. Instead of "make it look modern", describe what modern means to you: "use a dark background with light text, a sans-serif typeface, and generous whitespace between sections." The more specific the prompt, the better the first generation, and the fewer rounds of revision you need.

Add project images and screenshots

A portfolio without images is a resume. The images are the portfolio. For each project, include at least one high-quality screenshot or photograph that shows the work in context. A product screenshot should show the product in use, not a landing page. A design project should show the final deliverable, not the Figma canvas.

If you are building with an AI coding tool, upload the images as part of the generation. Most vibe coding tools, including Lovable and Bolt, accept image uploads in the prompt. Place the images next to the project descriptions so the AI knows which image belongs to which project.

For the image treatment, follow the vibe coding design guide: use rounded corners, consistent aspect ratios, and subtle shadows. These small details separate a professional portfolio from a default generation.

Make it responsive

Most AI coding tools generate responsive layouts by default, but the mobile version is often an afterthought. Projects that look great in a three-column grid on desktop can collapse into an unreadable single column on mobile. Check the mobile layout after generation and adjust if needed.

The most common issue is image sizing. An image that fills a third of the desktop screen should not fill the entire mobile screen at full height. Constrain image heights on mobile. Use a mobile-first approach if your portfolio visitors are likely to view it on their phone, which is increasingly common for creative portfolios shared on social media.

Deploy and share

Once the site looks right, deploy it. Vercel and Netlify both offer free hosting for static sites. If you built with Lovable or Bolt, the tool handles deployment for you. If you built with Claude Code or Cursor, push the code to GitHub and connect the repository to Vercel. The site will be live in under a minute.

Add a custom domain. A portfolio at yourname.com communicates more professionalism than a portfolio at a generated subdomain. Domains cost around ten dollars per year and take five minutes to configure.

Share the link. Put it in your LinkedIn headline, your email signature, your social media bios, and your job applications. A portfolio only works if people see it.

Frequently asked questions

Can I build a portfolio website with AI?

Yes. AI coding tools like Lovable, Bolt, Replit, and Claude Code generate complete portfolio websites from a text prompt. The key is to provide a design template as the visual reference so the output looks professional rather than generic. Paste a template, describe your work, and the AI builds the page.

How long does it take to build a portfolio with AI?

Under an hour for a basic portfolio with four to six projects. The first generation takes seconds. Most of the time goes into writing project descriptions, preparing images, and making adjustments to the layout. With a good template and clear descriptions, the first generation is often close to the final result.

What should a portfolio website include?

A hero section with your name and role, a projects section with your best work, a short about section, and contact information. Only include sections that have real content. A testimonials section without real testimonials or a blog section without posts weakens the page rather than strengthening it.

What is the best AI tool for building a portfolio?

Lovable and Bolt are the fastest for generating a complete portfolio from a prompt. Claude Code and Cursor give more control if you want to customize the code directly. All of them work well with design templates as visual references.

How do I make my AI-generated portfolio look professional?

Use a design template. Paste a production-ready HTML template into your AI coding tool before generating the page. The template provides the font sizes, colour values, spacing, and layout decisions that replace the AI's generic defaults. A professional portfolio comes from a professional design reference.

GuidesDesign

More articles