This project is not covered by Drupal’s security advisory policy.
APEX Theme is the base theme of the APEX design system. It is for site builders who want a configurable Drupal front end with 28 regions, or a branded sub-theme on top.
Layout, width, typography, colors, menus and overlays are set on a settings page, without code. Twelve ready-made APEX sub-themes build on it, and a starter sub-theme is included for your own brand.
Start here
- Pick one of the 12 APEX sub-themes
- Install the APEX module suite, which this theme needs
Features
- 28 regions: from Overlay Search and Hero to four Bottom regions and a Copyright region. They are listed below.
- 17 default block placements: branding, main navigation, off-canvas navigation, page title, breadcrumbs, messages, help, local tasks, search and login overlays, user account menu, footer menu, social icons and copyright. They install with the theme.
- Theme settings page: one page for every design control, at Appearance → Settings → APEX Theme. The groups are listed below.
- Page layouts: two, three and four column grids, mobile ordering, and collapsible sidebars with a "Sidebar controls" toolbar.
- Overlays: search and login panels with "Close" labels. The search overlay closes with Escape or an outside click, keeps focus inside while open, and returns focus when closed.
- Accessibility in the templates: skip links for header, navigation, main content and footer, all on by default and hidden until focused. Page landmarks, a visible focus ring and form borders at 3:1 contrast, and styles for reduced motion, high contrast and forced colors.
- Templates: 93 Twig templates for forms, fields, nodes, comments, tables, menus, pagers, Views, user pages, media, book, forum and region output.
- Layered CSS: all styles load in named
@layer apex.*layers, so your own CSS can override them in a defined order. - Hero and container queries: CSS for a full-width Hero region and for container-query layouts, plus a title size token for the Hero region.
- Display size tokens:
--apex-display-smup to--apex-display-2xl, and--apex-leading-display, for large headings. - User view mode suggestions: a hook adds
user--<view_mode>template suggestions, so a custom user view mode can have its own template. - Dialogs: the core dialog library is extended with APEX styling through the library
apex_theme/core-dialog. - Editor icons: a
wysiwyg-iconsfolder holds the editor icon set (Google Material Symbols, Apache-2.0). The file name is the icon name, and a sub-theme can add or replace icons.
Installation: get started in 3 steps
- Install the theme with Composer:
composer require drupal/apex_theme - Install the APEX modules and the theme, and set it as the default theme:
drush apex:install drush crAdd
--no-themetodrush apex:installto install the modules only. The Appearance page refuses to install the theme until its modules are enabled. - Open the theme settings at Appearance → Settings → APEX Theme, then open "Global Site" and set "Layout & Dimensions" for your site.
Starting look
A fresh install uses the Enterprise Charcoal color scheme in light mode, a 1400 px site width, a 16 px base font size and a sticky main navigation. The login page is centered. Change any of these on the settings page.
Regions
28 regions are available.
- Overlays: Overlay Search, Overlay Login.
- Header and navigation: Highlight, Header, Primary Navigation, Off-Canvas Navigation, Hero.
- Page opening: Top First, Top Second, Top Third, Messages, Title, Breadcrumb.
- Main content: Content Above, Sidebar First, Content, Sidebar Second, Content Below.
- Lower content: Bottom First, Bottom Second, Bottom Third, Bottom Fourth.
- Footer: Footer First, Footer Second, Footer Third, Footer Navigation, Copyright.
- Other: Hidden.
Theme settings
The settings page is provided by the APEX Theme Settings module, not by the theme itself. A setting has no effect while the module that owns it is turned off.
- Global Site: tabs "Layout & Dimensions", "Branding", "Typography & Content", "Edit Colors live", "Block & Visibility", "Form Elements", "Interface Behavior", "Accessibility" and "System Tabs".
- Header: tabs "Region Configuration", "Header Layout & Positioning" and "Typography Settings".
- Other sections: "Comments", "Back to Top" and "Loading & Transitions".
Other regions have their own settings sections on the same page.
Sub-themes
Use a sub-theme when the site needs its own identity. A sub-theme gets every template and hook of this theme. It does not get the regions, so each sub-theme lists all 28 again. These 12 sub-themes build on APEX Theme:
- APEX Studio
- APEX Publication
- APEX University
- APEX Government
- APEX Healthcare
- APEX Nonprofit
- APEX Corporate
- APEX SaaS
- APEX Cultural
- APEX Creative
- APEX Events
- APEX Associations
Build your own sub-theme
Generate one with drush apex:subtheme, or copy the included apex_theme_subtheme directory and rename it. The starter has an info file, a library file, a .theme file, a stylesheet, a behavior file and a templates directory. Install the APEX modules first with drush apex:install --no-theme, then install the sub-theme with drush theme:install.
Put sub-theme CSS in an APEX layer: apex.components for components, apex.layout for layout, apex.base for element defaults and apex.tokens for defaults a site setting must be able to override. Do not write unlayered CSS. It beats every APEX module, including the color scheme a site builder chose. To set a brand, feed the parent's variables such as --apex-font-* and --r-*.
Requirements
- Drupal 11.3 or later, or Drupal 12
- PHP 8.3
- APEX and the 21 other modules the theme declares: APEX Theme Settings, Layout, Width, Typography, Color, Color Editor, Font, Schemes, Style, Form, Menu, Display, A11y, Breadcrumb, Off Canvas, Overlay Search, Overlay Login, Copyright, Social, Back to Top and Block
While an APEX theme is active, the core progress bar, password strength and vertical tabs styles are removed so the APEX styles apply.
Other themes from Flash Web Center
APEX Theme stands on its own. If you need a different set of features, see our other themes:
- W3CSS Theme: a base theme built on W3.CSS, with 22 regions, horizontal or vertical menus, color themes and fonts, all set from the theme settings.
- Solo: a responsive, accessible theme with 24 regions and 50 color schemes, all set from the theme settings.
Support and maintenance
Questions, ideas, and bug reports are welcome. Please use this project’s issue queue so discussions and solutions remain available to the Drupal community.
Maintainers monitor issues, but response times depend on availability.

Developed and maintained by Alaa Haddad of Flash Web Center, LLC.
AI disclosure: AI tools assisted with drafting and reviewing this project description. The maintainer verified the final content against the project source.
Project information
Maintenance fixes only
Considered feature-complete by its maintainers.- Created by flashwebcenter on , updated
This project is not covered by the security advisory policy.
Use at your own risk! It may have publicly disclosed vulnerabilities.
