# 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.