Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Designing the front page

How theme designers approach the front page of an Exponential site - the three ways a front page is built (a layout, a class of its own, an override of the root node), how to choose with the client, designing for…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/theme-designers/designing-the-front-page.md

On this page

Designing the front page

This page is for theme designers who design a site's front page. It is the page clients care most about and the one that changes most often, so how it is built decides what editors can change without you. Exponential offers three ways to build it; the choice is a design decision as much as a technical one, and it should be made before the mockup is final.

Contents

  1. Three ways to build it
  2. Choosing with the client
  3. Designing a front page built from blocks
  4. Designing a fixed front page
  5. Content that changes every day
  6. The front page and the frame
  7. Checks

Three ways to build it

WayHowWho changes the arrangement
A layoutthe root page gets a layout from the layouts editor; editors place and order blockseditors
A class of its owna front page class with fields (hero, featured items, intro), drawn by its own full view templatethe template; editors fill the fields
An override of the root nodethe root node's full view gets a dedicated template, matched by remote idthe template; content comes from fetches

The template-based ways are explained in Override a single node and its alternatives; the layouts way in Tutorial: build a landing page with layouts.

Choosing with the client

QuestionPoints toward
Will editors want to change the order or add sections themselves?a layout
Is the front page one strict composition the brand depends on?a class or an override
Will several pages (campaign pages, section fronts) share the same structure?a layout, or a class used for all of them
Is the front page mostly automatic (latest news, upcoming events)?an override with fetches, or list blocks with queries in a layout

Most content sites end up with a layout: editors get freedom within the blocks and view types you designed. Write down the choice and the reason; it decides what the client can do without a designer later.

Designing a front page built from blocks

Design the front page as an example arrangement of your blocks, not as a fixed composition, and say so when you present it. Then:

  • check that each block in it also works in other positions and next to other blocks (Designing layout blocks);
  • design two or three alternative arrangements (a campaign week, a quiet week), to show the system holds;
  • decide which blocks belong to a shared layout (often a pre-footer area) and appear on many pages (Shared layouts and linked zones).

Designing a fixed front page

A fixed composition must still take changing content. Map each area to its source: a field of the front page object, a fetch of the latest items of a class, or a relation list editors fill (Mapping a design to content classes). Draw each area with zero, one and the maximum number of items.

Content that changes every day

  • The hero image changes; design its slot for any picture editors pick, with a crop rule and text that stays readable on any image (text beside the image, or on a solid band, rather than on top of the photo) (Designing image crops and art direction).
  • Lists of the latest items vary in length of titles and presence of images (Designing content listings and cards).
  • Avoid areas that only look right with exactly three items.
  • Front pages are cached; a developer decides how freshly automatic lists update (Caching for designers).

The front page and the frame

The front page sits inside the same pagelayout as every other page. If the front page needs a different header (for example a transparent header over the hero), that is a variation of the frame for one page, which costs a condition in the pagelayout and testing in both forms. Prefer a front page that works with the normal header (Designing headers and footers).

Checks

  • To do: The way of building it is chosen and written down.
  • To do: Each area mapped to a source; zero, one and many items drawn.
  • To do: Two alternative arrangements, if it is a layout.
  • To do: Hero readable with a dark and a light photo, in light and dark themes.
  • To do: The first screen meets the performance budget (Designing for performance budgets).

Become an Exponential Partner

Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x