Skip to content
Kuza Ndoto Academy

Project: Personal Portfolio Page

BeginnerChapter 6 · Page 24 of 257 min readUpdated 15 Nov 2026

Time to put the whole series together. In this project you'll build a personal portfolio page: a single, complete, semantic and accessible HTML page that introduces you, shows your projects and skills, and lets visitors contact you. It's the first thing many employers and clients will look at, so it's worth building well.

The goal and the features

You'll build a one-page portfolio for a fictional developer, Amani Otieno from Kisumu. Swap in your own details as you go. The finished page will have:

  • a proper head with title, description and viewport,
  • a skip link, a header and a navigation menu that jumps to each section,
  • an About section with a photo and alt text,
  • a Projects section with each project as an <article>,
  • a Skills section using lists,
  • a Contact section with an email link and an accessible form,
  • a footer.

We'll write no CSS in this project. A well-structured page should already be readable and usable without styles, and that makes it easy to style later.

Step 1: the skeleton and head

Create a folder called portfolio, open it in VS Code, add index.html and start with the document skeleton:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Amani Otieno – Junior Web Developer</title>
    <meta name="description" content="Amani Otieno is a junior web developer in Kisumu. See projects, skills and contact details.">
  </head>
  <body>
  </body>
</html>

The title puts your name first, because it's what people search for. The description becomes your search-result snippet (see Head, Meta Tags & SEO).

Inside <body>, add a skip link and a header containing your name and a menu. Each menu link points to the id of a section you'll create next.

<a href="#main">Skip to main content</a>
<header>
  <p><strong>Amani Otieno</strong></p>
  <nav aria-label="Main">
    <ul>
      <li><a href="#about">About</a></li>
      <li><a href="#projects">Projects</a></li>
      <li><a href="#skills">Skills</a></li>
      <li><a href="#contact">Contact</a></li>
    </ul>
  </nav>
</header>

Step 3: the About section

Open <main id="main"> (the skip link's target) and add the first section. The page's single <h1> goes here. Save a square photo of yourself as images/amani.jpg.

<main id="main">
  <section id="about">
    <h1>Hi, I'm Amani, a junior web developer</h1>
    <img src="images/amani.jpg" alt="Amani Otieno smiling, wearing a green shirt" width="160" height="160">
    <p>I'm 21 and based in Kisumu. I build fast, accessible websites for
       small businesses and community groups, and I'm currently learning CSS and JavaScript.</p>
  </section>

The alt text describes the photo for people who can't see it, and the width and height prevent layout shift.

Step 4: the Projects section

Each project could be shared on its own, so each is an <article> with an <h3>, because they sit under the section's <h2>.

  <section id="projects">
    <h2>Projects</h2>
    <article>
      <h3>Shamba Smart blog</h3>
      <p>A semantic, accessible blog of farming tips for young farmers in Nakuru.</p>
      <p>Built with: HTML. <a href="https://github.com/">View the Shamba Smart code</a></p>
    </article>
    <article>
      <h3>Matatu fare table</h3>
      <p>An accessible data table comparing peak and off-peak fares on five routes.</p>
      <p>Built with: HTML tables. <a href="https://github.com/">View the fare table code</a></p>
    </article>
  </section>

Notice the link text names each project. A screen-reader user listing the links hears "View the Shamba Smart code", not two identical "View code" links. Replace the GitHub address with links to your real repositories.

Step 5: the Skills section

  <section id="skills">
    <h2>Skills</h2>
    <ul>
      <li>HTML: semantic structure, forms, tables and accessibility</li>
      <li>CSS: learning Flexbox and Grid</li>
      <li>Tools: VS Code, Git and browser developer tools</li>
    </ul>
    <h3>Learning journey</h3>
    <dl>
      <dt><time datetime="2026-09">September 2026</time></dt>
      <dd>Started learning HTML.</dd>
      <dt><time datetime="2026-11">November 2026</time></dt>
      <dd>Built and published this portfolio.</dd>
    </dl>
  </section>

A bulleted list fits skills (order doesn't matter) and a description list fits dated milestones (term and description). The datetime values use the year-month format.

Every field has a label, autocomplete hints and validation. Then close <main> and add the footer.

  <section id="contact">
    <h2>Contact</h2>
    <p>Email me at <a href="mailto:amani@example.com">amani@example.com</a> or use this form.</p>
    <form action="/contact" method="post">
      <p>
        <label for="name">Your name</label><br>
        <input type="text" id="name" name="name" autocomplete="name" required>
      </p>
      <p>
        <label for="email">Your email</label><br>
        <input type="email" id="email" name="email" autocomplete="email" required>
      </p>
      <p>
        <label for="message">Message</label><br>
        <textarea id="message" name="message" rows="5" required></textarea>
      </p>
      <button type="submit">Send message</button>
    </form>
  </section>
</main>

<footer>
  <p><small>&copy; 2026 Amani Otieno. Built with HTML.</small></p>
</footer>
Note

HTML alone can't receive form messages. The action="/contact" needs a server to handle it, which you can build later with a back-end framework such as Django, or replace with a form-handling service. Until then, the email link is the reliable contact method.

The complete page

Here is everything together. To make the example run in the editor, the photo is replaced by a data URL drawing; in your own project use your images/amani.jpg path. Press Try it yourself and change the details to your own.

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Amani Otieno – Junior Web Developer</title>
    <meta name="description" content="Amani Otieno is a junior web developer in Kisumu. See projects, skills and contact details.">
  </head>
  <body>
    <a href="#main">Skip to main content</a>
    <header>
      <p><strong>Amani Otieno</strong></p>
      <nav aria-label="Main">
        <ul>
          <li><a href="#about">About</a></li>
          <li><a href="#projects">Projects</a></li>
          <li><a href="#skills">Skills</a></li>
          <li><a href="#contact">Contact</a></li>
        </ul>
      </nav>
    </header>

    <main id="main">
      <section id="about">
        <h1>Hi, I'm Amani, a junior web developer</h1>
        <img src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%20160%20160'%3E%3Crect%20width='160'%20height='160'%20fill='%23ffcc00'/%3E%3Ccircle%20cx='80'%20cy='62'%20r='30'%20fill='%231f3a5f'/%3E%3Cpath%20d='M25%20160a55%2055%200%200%201%20110%200z'%20fill='%231f3a5f'/%3E%3C/svg%3E"
             alt="Placeholder portrait of Amani Otieno" width="160" height="160">
        <p>I'm 21 and based in Kisumu. I build fast, accessible websites for
           small businesses and community groups, and I'm currently learning CSS and JavaScript.</p>
      </section>

      <section id="projects">
        <h2>Projects</h2>
        <article>
          <h3>Shamba Smart blog</h3>
          <p>A semantic, accessible blog of farming tips for young farmers in Nakuru.</p>
          <p>Built with: HTML. <a href="https://github.com/">View the Shamba Smart code</a></p>
        </article>
        <article>
          <h3>Matatu fare table</h3>
          <p>An accessible data table comparing peak and off-peak fares on five routes.</p>
          <p>Built with: HTML tables. <a href="https://github.com/">View the fare table code</a></p>
        </article>
      </section>

      <section id="skills">
        <h2>Skills</h2>
        <ul>
          <li>HTML: semantic structure, forms, tables and accessibility</li>
          <li>CSS: learning Flexbox and Grid</li>
          <li>Tools: VS Code, Git and browser developer tools</li>
        </ul>
        <h3>Learning journey</h3>
        <dl>
          <dt><time datetime="2026-09">September 2026</time></dt>
          <dd>Started learning HTML.</dd>
          <dt><time datetime="2026-11">November 2026</time></dt>
          <dd>Built and published this portfolio.</dd>
        </dl>
      </section>

      <section id="contact">
        <h2>Contact</h2>
        <p>Email me at <a href="mailto:amani@example.com">amani@example.com</a> or use this form.</p>
        <form action="/contact" method="post">
          <p>
            <label for="name">Your name</label><br>
            <input type="text" id="name" name="name" autocomplete="name" required>
          </p>
          <p>
            <label for="email">Your email</label><br>
            <input type="email" id="email" name="email" autocomplete="email" required>
          </p>
          <p>
            <label for="message">Message</label><br>
            <textarea id="message" name="message" rows="5" required></textarea>
          </p>
          <button type="submit">Send message</button>
        </form>
      </section>
    </main>

    <footer>
      <p><small>&copy; 2026 Amani Otieno. Built with HTML.</small></p>
    </footer>
  </body>
</html>

What you should see

Without CSS the page reads like a tidy document, top to bottom:

  1. A "Skip to main content" link, then the bold name "Amani Otieno" and a bulleted menu of four links.
  2. The large heading "Hi, I'm Amani, a junior web developer", a yellow square with a navy head-and-shoulders silhouette, and a paragraph.
  3. "Projects" with two smaller project headings, each followed by a description and a link.
  4. "Skills" with a bulleted list, then "Learning journey" with two dates and their indented descriptions.
  5. "Contact" with an email link and a form of three labelled fields and a "Send message" button.
  6. A small copyright line at the bottom.

Clicking a menu link jumps to its section. Pressing "Send message" with empty fields makes the browser ask you to fill them in. With valid values the browser tries to send the form to /contact, and the preview may go blank because there is no server; press Run to start again.

Check your work

  • Validate: paste your code into the W3C validator (validator.w3.org) and fix every error.
  • Keyboard test: Tab through the page. Can you reach every link, field and button, in a sensible order?
  • Heading outline: one <h1>, then <h2> sections, then <h3> inside them, with no skipped levels.
  • Alt text and links: does the photo have meaningful alt text, and does every link make sense on its own?

Extend it

  1. Style it with CSS. Add a stylesheet with <link rel="stylesheet" href="style.css">, then use the CSS series to add colours, fonts, a horizontal menu and a project-card grid. Your semantic structure means you won't need to change the HTML much.
  2. Add a project page. Create projects/shamba-smart.html with screenshots (using <figure> and <figcaption>), a short demo video with captions, and relative links back to ../index.html.
  3. Make it shareable. Add Open Graph tags and a 1200 × 630 share image so your link looks professional on WhatsApp and LinkedIn, then publish the site for free with a static hosting service such as GitHub Pages.

Key points

  • A portfolio page combines everything in this series: head metadata, semantic landmarks, headings, images, lists, links and forms.
  • Build structure first with HTML and add CSS afterwards; a good page is usable even without styles.
  • Use sections with headings, articles for self-contained projects and descriptive link text.
  • Validate, test with the keyboard and check alt text before you publish.
Up next · PracticeHTML QuizTest yourself across the series.
→

Tip: use the ← and → keys to move between pages.