Your portfolio is your digital storefront. For Nigerian freelancers competing on Upwork, Fiverr, and local marketplaces, a professional website costs nothing but separates you from 90% of the competition. This is how to build one in a weekend.

The Portfolio Website Gap: Why Nigerian Freelancers Lose Clients

Chioma is a UI/UX designer from Lagos who landed clients through Upwork. Her rates climbed from ₦50,000 per project to ₦250,000 within two years. But when she pitched directly to local e-commerce businesses and fintech startups, the conversation always hit a wall: they asked for her website. She had nothing to show except her Upwork profile, which showed their commission fees and review scores from international clients.

Chioma's story repeats across Nigeria. Freelancers designers, developers, copywriters, marketers can build impressive portfolios on third-party platforms. But without a personal website, they lose deals to competitors who own their digital presence. Building that website traditionally costs ₦80,000 to ₦500,000 in hosting, domain, and design fees. Most Nigerian freelancers never invest, so they remain invisible to local clients who search Google and expect a professional site.

This changed when AI tools and free deployment platforms converged. Today, you can build a professional, scalable portfolio website without spending a naira on hosting, domain registration, or design tools. You need four things: GitHub (free code storage), Vercel (free deployment), Claude AI (free tier available), and Supabase (free database). Together, they form a complete website stack that looks professional, ranks on Google, and scales when you're ready to pay.

76% of Nigerian freelancers say client acquisition is their biggest challenge. A professional website increases client inquiry rates by 45%, according to freelance industry data. Yet only 28% of freelancers in Nigeria maintain a personal website

The Free Tech Stack: What Each Tool Does and Why

Before we build, understand what's happening behind the scenes. You're not hiring a web developer. You're assembling a production-grade stack using enterprise-level tools that offer free tiers for exactly your use case.

1. GitHub: Your Code Foundation

GitHub is where developers store code. Think of it as Google Drive for programming. When you build your portfolio site, you'll write HTML, CSS, and JavaScript. GitHub stores all of it, tracks changes, and makes it easy to edit later. Most importantly, it's free and GitHub won't delete your code if you stop paying.

Why GitHub and not Blogger or Wix? Because you own the code. If GitHub disappears tomorrow, you export your code and move it anywhere. Blogger owns your content. Wix owns your design. You own nothing in those platforms except the articles you wrote. GitHub inverts that dynamic.

New to GitHub? Don't worry. You won't write code from scratch. Claude AI will generate the full HTML website. You just paste it into GitHub and let the system handle deployment.

2. Vercel: Your Free Web Host

Vercel is a deployment platform built for modern websites. You connect your GitHub repository (the folder where your code lives), and Vercel automatically publishes it on the internet. Every time you update code in GitHub, Vercel rebuilds and redeploys your site in seconds. It's magic, and it's free for portfolio sites.

Vercel gives you a free subdomain: yourname.vercel.app. But here's the best part, you can use your own domain for free if you own one (via Namecheap or GoDaddy). If you don't own a domain yet, Vercel's free one is professional enough to start building your reputation.

3. Claude AI: Your Web Designer and Copywriter

Claude is an AI trained on billions of web pages, design patterns, and portfolio best practices. You'll describe your freelance skills, give it a few portfolio examples, and Claude generates production-ready HTML and CSS. Not templates, not themes, not low-quality AI slop. Claude writes code that Vercel can deploy immediately and that Google's crawlers can index.

Claude does more than code. It writes your portfolio copy, crafts your service descriptions, and structures your page for both human visitors and search engine optimization. You won't need a copywriter.

4. Supabase: Your Database (If You Need Forms)

If your portfolio is static (text, images, project links), you don't need Supabase. But if you want a contact form that captures client inquiries, Supabase is a free PostgreSQL database that stores form submissions. It's optional for a basic portfolio, but invaluable if you want to automate client outreach capture.

The Complete Walkthrough: Build Your Portfolio in 90 Minutes

Step 1: Create Your GitHub Account and Repository (10 minutes)

Go to github.com and click Sign Up. Create an account with your Gmail address. Use a professional username (your name or firstname-lastname, not a gaming handle).

Once logged in, click the plus icon in the top right corner and select New Repository. Name it yourname-portfolio (or anything memorable). Set it to Public. Click Create Repository.

What you'll see: GitHub shows you a blank repository with instructions to add files. Don't follow those instructions yet. Instead, click Add file and then Create new file. Name it index.html. This is where your website code will live.

Step 2: Use Claude to Generate Your Portfolio HTML (30 minutes)

This is where AI becomes your web designer. Open Claude (claude.ai or the free tier) and give it this prompt:

I need you to generate a complete, professional HTML portfolio website for a Nigerian freelancer. Here are the details: Name: [Your Name] Profession: [Your Job Title e.g., UI/UX Designer, Content Writer, Web Developer] Location: [Your City] Bio: [2-3 sentences about your expertise] Services: [List 3-4 main services you offer] Portfolio Projects: [3-5 past work examples with brief descriptions] Contact Email: [Your Email] Social Links: [LinkedIn, Twitter, Behance, etc.] Requirements: Professional, clean design with a dark/light theme option Mobile responsive (looks good on phones and desktops) Fast loading (optimized images and minimal CSS) SEO friendly with proper meta tags Google AdSense compliant (no deceptive elements, clear navigation) One hero section, about section, services section, portfolio showcase, and contact form placeholder Use modern typography (Google Fonts: Roboto, Open Sans, or similar) Blue accent color (#1a4fa0) for buttons and highlights White or light grey background for readability Generate the complete HTML code ready to paste directly into GitHub and deploy on Vercel.

Claude will generate a complete HTML file with embedded CSS. It will include sections for your hero image, services, past work, and a contact form placeholder. Copy the entire HTML code.

Pro tip: If Claude's design doesn't match your vision, iterate. Say things like, "Make the hero section more cinematic with a background gradient," or "Add a testimonials section with 3 client quotes." Claude learns from feedback.

Step 3: Paste Code into GitHub (10 minutes)

Go back to your index.html file in GitHub. Paste Claude's HTML code into the editor. Scroll down and click Commit changes. GitHub now stores your complete website code.

Step 4: Connect GitHub to Vercel and Deploy (15 minutes)

Go to vercel.com and click Sign Up. Choose Sign Up with GitHub. Authorize Vercel to access your GitHub account. Vercel will show your repositories. Click Import on your portfolio repository.

Vercel will auto-detect that it's an HTML project and offer default settings. Click Deploy. In 30 seconds, your website is live on the internet. Vercel will give you a URL like yourname-portfolio.vercel.app. That's your live website.

What just happened: You built and deployed a production-grade website without spending money or writing a single line of code. Every time you edit index.html in GitHub, Vercel automatically rebuilds and deploys your updates.

Step 5: (Optional) Connect Your Own Domain (5 minutes)

If you own a domain (say, yourname.com from GoDaddy or Namecheap), you can point it to Vercel for free. In Vercel's project settings, go to Domains and add your domain. Follow the DNS instructions to connect your registrar. In 15 minutes, yourname.com will point to your Vercel deployment.

If you don't have a domain, yourname.vercel.app is professional enough for now. Many Nigerian freelancers use Vercel's free subdomain and upgrade to a custom domain once they start earning from it.

Step 6: (Optional) Add a Contact Form with Supabase (20 minutes)

A contact form captures client inquiries automatically. To add one, you'll need Supabase. Go to supabase.com, sign up with GitHub, and create a new project. Supabase will generate an API key.

Ask Claude to update your HTML with a contact form that submits to Supabase. Claude will generate JavaScript code that sends form data to your Supabase database. Paste the updated code back into GitHub, and Vercel redeploys automatically.

Now when someone fills out your contact form, the submission lands in Supabase. You log in, see the inquiry, and follow up. No more manual form collection.

The closing insight: You're not just building a website. You're building a business asset that appreciates as your skills improve and as you add more projects. Every client you land through your portfolio strengthens it. Within 6 months, your portfolio will be your highest-converting client acquisition channel.

Build a Professional Portfolio Website Completely Free Using AI and No Code Tools