# Drupal theme

This section contains comprehensive documentation for developing and customising CivicTheme for Drupal.

## Installation

For installation instructions, see [Drupal theme installation](https://docs.civictheme.io/installation/drupal-theme).

## Core Development

* [assets](https://docs.civictheme.io/development/drupal-theme/assets) - Asset management (CSS, JS, fonts, images)
* [templates](https://docs.civictheme.io/development/drupal-theme/templates) - Using CivicTheme UI Kit components in Drupal
* [namespaces](https://docs.civictheme.io/development/drupal-theme/namespaces) - Component namespace system and organisation
* [sub-theme](https://docs.civictheme.io/development/drupal-theme/sub-theme) - Creating and customising sub-themes

## Systems Architecture

The systems section contains CivicTheme's unique architectural approaches:

* [systems](https://docs.civictheme.io/development/drupal-theme/systems) - Overview of all systems and learning path
* [systems/build](https://docs.civictheme.io/development/drupal-theme/systems/build) - Custom build system and development workflows
* [systems/components](https://docs.civictheme.io/development/drupal-theme/systems/components) - Component-centric architecture and template separation
* [systems/colors](https://docs.civictheme.io/development/drupal-theme/systems/colors) - Color override system and design token customisation
* [systems/mapping](https://docs.civictheme.io/development/drupal-theme/systems/mapping) - How Drupal entities map to component templates

## Theme Customisation

* [color-selector](https://docs.civictheme.io/development/drupal-theme/color-selector) - Color customisation tools and options
* [layout-builder](https://docs.civictheme.io/development/drupal-theme/layout-builder) - Working with Drupal's Layout Builder
* [automated-list](https://docs.civictheme.io/development/drupal-theme/automated-list) - Automated list component implementation

## Platform-Specific Guides

* [using-in-govcms-saas](https://docs.civictheme.io/installation/govcms-saas) - GovCMS SaaS implementation guide
* [updating-civitheme-govcms-sass](https://github.com/civictheme/docs/blob/main/development/drupal-theme/updating-civitheme-govcms-sass.md) - SASS update procedures for GovCMS

## Key Concepts

CivicTheme emphasises these core principles:

1. **Component-centric development** - Organised folder structure for maintainable code
2. **Template separation** - Component Twig templates separated from Drupal HTML files
3. **Preprocess functions** - Custom data population for component templates
4. **Build system** - Custom asset compilation workflows
5. **Color system** - Flexible theming capabilities

## Learning Path

To effectively work with CivicTheme:

1. Start with [templates](https://docs.civictheme.io/development/drupal-theme/templates) to understand component separation
2. Review [systems/build](https://docs.civictheme.io/development/drupal-theme/systems/build) for development workflow
3. Study [systems/components](https://docs.civictheme.io/development/drupal-theme/systems/components) for data flow patterns
4. Explore [systems/colors](https://docs.civictheme.io/development/drupal-theme/systems/colors) and [assets](https://docs.civictheme.io/development/drupal-theme/assets) for theming

This documentation provides everything needed to build maintainable, component-centric Drupal sites using CivicTheme's ecosystem.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.civictheme.io/development/drupal-theme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.