Drupal Community
This playbook is a step-by-step guide for teams building and maintaining a CivicTheme site on standalone Drupal. It is written for tech leads, project managers, and site managers — people who need to understand the process of setting up, customising, and keeping a CivicTheme site running.
CivicTheme is an open-source, government-grade design system built as a Drupal theme. It provides a library of accessible, reusable components following atomic design principles. On a standard Drupal site, CivicTheme installs via Composer like any other contributed theme, with full control over your deployment workflow.
How to use this playbook
Work through the chapters in order. Each chapter builds on the previous one, following the natural lifecycle of a CivicTheme project: install, configure, customise, maintain.
The playbook provides the task-oriented workflow — the sequencing, decisions, and practical steps your team needs. Where detailed reference material already exists in the CivicTheme documentation, the playbook links to it rather than duplicating it. This keeps everything in one place and ensures the information stays current.
Chapters
Site Development
Installation — Install CivicTheme via Composer, enable required modules, generate your sub-theme, build assets, and provision content.
Setting Up Your Sub-Theme — Understand the sub-theme directory structure, configure the build system, run Storybook locally, and connect your sub-theme to Drupal.
Configuring Colors and Theme Settings — Set up your brand colors, configure the header and footer, and understand how CivicTheme's color system derives a full palette from your brand values.
Overriding Existing Components — Change how an existing CivicTheme component looks or behaves by copying it into your sub-theme and modifying it there.
Creating New Components — Build a new component from scratch following CivicTheme conventions, from atomic design placement through to Drupal integration.
Site Maintenance
Updating Packages — Keep your CivicTheme base theme, sub-theme dependencies, and Node.js packages up to date with a clear update and rebuild workflow.
Security Updates — Subscribe to security advisories, assess severity, and apply patches to your Drupal site.
Who is this for?
Tech lead
End-to-end process for setting up and customising a CivicTheme site, including component architecture and override patterns
Project manager
Understanding of the process of installing and managing a CivicTheme site, dependencies between steps, and what the team needs at each stage
Site manager
Understanding of the maintenance process for keeping the site secure and up to date after the initial build
Getting help
If you run into issues at any point, CivicTheme has active support channels including a Drupal Slack channel, issue queues, and email support. For all options, see Getting help.
Last updated
Was this helpful?