Website design and build guide

Build a portfolio that tells your story

Help visitors see your work, understand your contribution and find the next step. Plan five connected pages, then build the motion around a clear browsing journey.

By Updated:

Download the Arabic PDF
  1. 1Home
  2. 2Work
  3. 3About
  4. 4Behind the scenes
  5. 5Archive

What will you build with this guide?

Build a cinematic portfolio by planning five connected pages for your home page, work, background, process and archive, then add motion around that content. This guide includes a responsive gallery example and a worksheet for your first build.

  • Map five pages and give each a clear visitor goal.
  • Build a responsive work gallery from the included code example.
  • Check images, video and motion on phones and desktop.

Explore the page map

Choose a page or scroll inside the diagram. Each page answers a question and stays reachable through a direct link.

Tour progress0%
Home

An opening image, selected work and a next step.

Work

Project images with a clear role and contribution.

About

A short introduction and relevant experience.

Behind the scenes

On-set images with useful context.

Archive

A complete image gallery with descriptions.

01

Give five pages a clear purpose

Decide what each page should answer before adding animation. Visitors may arrive through any link.

Home
State what you do and show a strong image with three selected projects. Make work and contact easy to reach.
Work
Give every project an image, a short description, your role and the available result. Link to a dedicated detail page.
About and process
Use one page for your background and another for how the work happens. Explain preparation, collaboration and production through real material.
Archive
Group the remaining images clearly. Let each open at a useful size with a description and an easy return.

Write a one-sentence goal for each page. Keep navigation and the same contact action available throughout.

02

Prepare the content and identity

Collect the evidence and media before choosing motion. Give each project a folder for its text and approved public assets.

Project record
Prepare a title, format, confirmed date, role, contribution and description. Check missing facts against your records.
Media
Retain the originals and create lighter display versions. Prepare crops for tall phones and wide screens.
Visual system
Set background, text and accent colors, heading and reading fonts, spacing and button styles. Carry them across the pages.
Arabic edition
Review reading direction, menus and information order. Isolate dates and English fragments when needed.

Describe one project in two sentences and state your contribution. Use that as the first piece of build content.

03

Build a browsable work gallery

Begin with regular images and links. This example provides swipeable phone cards and a three-column layout when a wide screen has room.

Card content
Include an image, title and your role. Link to the project detail and preserve keyboard access.
Screen size
Leave part of the next card visible on phones. Keep the gallery within its own scrolling region and the surrounding page vertically scrollable.
Working example
Repeat the card for each project. Replace the image and page paths with your own files and write meaningful image alternatives.
<section class="work-gallery" tabindex="0"
         aria-label="Selected work">
  <a href="/work/project-one/">
    <img src="/media/project-one.webp" width="800"
         height="600" alt="Describe this project image">
    <h2>Project title</h2><p>Your role and contribution</p>
  </a>
  <!-- Repeat the card for each project. -->
</section>
<style>
.work-gallery {
  display: grid; grid-auto-flow: column;
  grid-auto-columns: min(84vw, 26rem); gap: 1rem;
  overflow-x: auto; scroll-snap-type: x proximity;
  padding: 1rem;
}
.work-gallery a { scroll-snap-align: start; color: inherit; }
.work-gallery img { width: 100%; height: auto; }
@media (min-width: 60rem) {
  .work-gallery { grid-template-columns: repeat(3, minmax(0, 1fr));
    grid-auto-flow: row; overflow: visible; }
}
</style>

Try three real cards first. Test swiping and links on a phone before adding the rest of the work.

04

Connect motion to the content

This portfolio format moves between an opening image, work cards, large typography and behind-the-scenes images. Give every scene a start and an end.

Opening
Display a useful image and heading immediately. Keep the work and contact actions available through any reveal or image turn.
Scroll progress
Map the scene position to a value from zero to one. Use it to move or reveal a layer so scrolling back returns to the corresponding state.
Page changes
Use a real link for each page. Test direct entry and browser Back, and restore a useful scroll and focus position.
Reduced motion
Respect the visitor’s preference. Keep text, images and links available and use normal flow where pinning becomes cramped.

Build one scene and test scrolling down, reversing and stopping halfway before adding the next.

05

Keep media manageable on phones

Large videos add transfer and decoding work. Start with a poster image and let visitors choose when to play a full project.

Opening image
Reserve its dimensions and prepare appropriate phone and wide-screen sizes. Protect the important part of the crop.
Video
For a silent background use a poster, muted and playsinline. Provide visible controls for sound or longer viewing, and test when autoplay is unavailable.
Later content
Defer distant images and reserve their dimensions. Show a still for a heavy project until playback is requested.
Phone galleries
Keep vertical page movement available outside the gallery. Test touch, zoom, viewer dismissal and keyboard access.

Use a fresh page load and a slower connection. Record the first-image load and media transfer, then compare changes under the same conditions.

06

Check the full journey and start building

Test a complete path from a work card to the detail page and contact. Record the location of a problem before adding another scene.

Phone and desktop
Check widths of 320, 390 and 1440 pixels and a short landscape phone. Increase text size and check navigation, controls and media.
Navigation and motion
Open every page directly. Test browser Back, keyboard access, image viewing, fast and reverse scrolling, reduced motion and unavailable autoplay.
Worksheet
My visitor is ____. The strongest three projects are ____. My role was ____. The opening image is ____. The next action is ____.
Build prompt
Build a five-page portfolio from the content I provide. Give each page a purpose, a browsable work gallery and real detail links. Add motion gradually and preserve access on phones, desktop and with reduced motion.

Start with a homepage and three work cards. Ask a new visitor what you do, what your contribution was and how they would contact you.

Technical references · Video playback · Reduced motion