[PR #680] [CLOSED] docs: add tutorial for customizing themes (opening early for reference) #734

New issue

Closed

opened 2026-10-18 14:14:18 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-18 14:14:18 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/680
Author: @silentoplayz
Created: 9/5/2025
Status: ❌ Closed

Base: main ← Head: customizing-and-adding-new-themes

📝 Commits (2)

7a600a1 docs: add tutorial for customizing themes
95ecedc refac

📊 Changes

1 file changed (+119 additions, -0 deletions)

View changed files

➕ docs/tutorials/theming.mdx (+119 -0)

📄 Description

Description

This PR adds a new documentation page that provides a comprehensive guide on how to customize and add new themes to Open WebUI, particularly animated themes powered by Particle.js.

The new page is located at docs/tutorials/theming.mdx and covers how users can propose new themes and provides a step-by-step guide for developers to create and register their own themes, specifically animated themes powered by Particle.js.

Motivation

The goal of this new documentation page is to empower the community to contribute to the look and feel of Open WebUI by providing clear and actionable instructions on theme creation. This will hopefully lead to a richer and more diverse set of themes available for all users.

How to Test

Check out this PR.

Install the dependencies:

npm install

Build the documentation site to ensure there are no errors:

npm run build

Serve the built site locally:

npm run serve

Open your browser and navigate to the locally served documentation.
Find the new "Customizing Themes" page under the "Tutorials" section in the sidebar.
Verify that the content renders correctly and is easy to follow.

My apologies for opening up both this PR and https://github.com/open-webui/docs/pull/675 on the `main` branch. I need to update my local dev environment so that my changes are being made on the `dev` branch.

This PR links to a PR I've yet to submit over on the main repo!

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/open-webui/docs/pull/680 **Author:** [@silentoplayz](https://github.com/silentoplayz) **Created:** 9/5/2025 **Status:** ❌ Closed **Base:** `main` ← **Head:** `customizing-and-adding-new-themes` --- ### 📝 Commits (2) - [`7a600a1`](https://github.com/open-webui/docs/commit/7a600a1e4212a480df950b235e1ac1379f054b0c) docs: add tutorial for customizing themes - [`95ecedc`](https://github.com/open-webui/docs/commit/95ecedc96e066ead2bc7c523262d42d853b69c68) refac ### 📊 Changes **1 file changed** (+119 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `docs/tutorials/theming.mdx` (+119 -0) </details> ### 📄 Description ## Description This PR adds a new documentation page that provides a comprehensive guide on how to customize and add new themes to Open WebUI, particularly animated themes powered by [Particle.js](https://vincentgarreau.com/particles.js/). The new page is located at `docs/tutorials/theming.mdx` and covers how users can propose new themes and provides a step-by-step guide for developers to create and register their own themes, specifically animated themes powered by Particle.js. ### Motivation The goal of this new documentation page is to empower the community to contribute to the look and feel of Open WebUI by providing clear and actionable instructions on theme creation. This will hopefully lead to a richer and more diverse set of themes available for all users. ### How to Test Check out this PR. Install the dependencies: ``` npm install ``` - Build the documentation site to ensure there are no errors: ``` npm run build ``` - Serve the built site locally: ``` npm run serve ``` - Open your browser and navigate to the locally served documentation. - Find the new "Customizing Themes" page under the "Tutorials" section in the sidebar. - Verify that the content renders correctly and is easy to follow. #### My apologies for opening up both this PR and https://github.com/open-webui/docs/pull/675 on the `main` branch. I need to update my local dev environment so that my changes are being made on the `dev` branch. ### This PR links to a PR I've yet to submit over on the main repo! --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 14:14:18 +00:00