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.
Download the Arabic PDF- 1Home
- 2Work
- 3About
- 4Behind the scenes
- 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.
An opening image, selected work and a next step.
Project images with a clear role and contribution.
A short introduction and relevant experience.
On-set images with useful context.
A complete image gallery with descriptions.
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.
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.
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.
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.
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.
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