AI docs error: mkdocs serve ERROR - Config value 'theme': Unrecognised theme name: 'material'

Created on 23 July 2025, 9 days ago

Problem/Motivation

Followed the docs here:

https://project.pages.drupalcode.org/ai/1.2.x/documentation/

to view locally and ran into this error:

mkdocs serve
ERROR   -  Config value 'theme': Unrecognised theme name: 'material'. The available installed themes are: mkdocs, readthedocs

Steps to reproduce (required for bugs, but not feature requests)

Please provide information like AI modules enabled, which AI provider, browser, etc.

Proposed resolution

Although it does have this section:

How do I install mkdocs
Install MkDocs: pip install mkdocs mkdocs-material

Before that, it says to run mkdocs serve

So it would be better to switch the order

Remaining tasks

Update order of mkdocs info so that people don't run into this error

Optional: Other details as applicable (e.g., User interface changes, API changes, Data model changes)

πŸ› Bug report
Status

Active

Version

1.2

Component

Documentation

Created by

πŸ‡ΊπŸ‡ΈUnited States Kristen Pol Santa Cruz, CA, USA

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Merge Requests

Comments & Activities

Production build 0.71.5 2024