Overriding styles using the Visual Theme System #2837

New Issue

OVERLORD · 2026-02-05T05:24:29+03:00

OVERLORD commented

2026-02-05 05:24:29 +03:00

Originally created by @stevenmasci on GitHub (Jun 9, 2022).

Attempted Debugging

I have read the debugging page

Searched GitHub Issues

I have searched GitHub for the issue.

Describe the Scenario

Hi, is it possible to override styles using the Visual Theme System? I have attempted to place scss files are various folders under my custom theme folder but it has no effect.

Or do I have to override individual blade.php files and use inline styles?

Thanks for your help!

Exact BookStack Version

v22.06-dev

Log Content

No response

PHP Version

8.1.6

Hosting Environment

Docker

Originally created by @stevenmasci on GitHub (Jun 9, 2022). ### Attempted Debugging - [X] I have read the debugging page ### Searched GitHub Issues - [X] I have searched GitHub for the issue. ### Describe the Scenario Hi, is it possible to override styles using the Visual Theme System? I have attempted to place scss files are various folders under my custom theme folder but it has no effect. Or do I have to override individual blade.php files and use inline styles? Thanks for your help! ### Exact BookStack Version v22.06-dev ### Log Content _No response_ ### PHP Version 8.1.6 ### Hosting Environment Docker

OVERLORD added the 🐕 Support label 2026-02-05 05:24:29 +03:00

OVERLORD closed this issue

2026-02-05 05:24:41 +03:00

OVERLORD commented

2026-02-05 05:24:44 +03:00

@ssddanbrown commented on GitHub (Jun 9, 2022):

Hi @stevenmasci,
It's not possible to override SCSS (Or JavaScript) files using the visual theme system since these require a build/transpile step for their final formats and I don't really want to complicate the theme system with such additional requirements.

You can however just add custom inline styles via template overrides or use the "Custom HTML Head Content" setting in the settings of BookStack to directly add some inline style HTML.
If you did go the template override route via the visual theme system, then this template is probably a good candidate for override since it's used in most non-export views.

@ssddanbrown commented on GitHub (Jun 9, 2022): Hi @stevenmasci, It's not possible to override SCSS (Or JavaScript) files using the visual theme system since these require a build/transpile step for their final formats and I don't really want to complicate the theme system with such additional requirements. You can however just add custom inline styles via template overrides or use the "Custom HTML Head Content" setting in the settings of BookStack to directly add some inline style HTML. If you did go the template override route via the visual theme system, [then this template](https://github.com/BookStackApp/BookStack/blob/a61c9c5e98b0a411b081543e3eaf1994d12919b3/resources/views/common/custom-styles.blade.php#L1-L11) is probably a good candidate for override since it's used in most non-export views.

OVERLORD commented

2026-02-05 05:24:48 +03:00

@stevenmasci commented on GitHub (Jun 9, 2022):

Hi @ssddanbrown, overriding the custom-styles.blade.php file works great!

Thanks for the prompt response and pointing me in the right direction.

@stevenmasci commented on GitHub (Jun 9, 2022): Hi @ssddanbrown, overriding the `custom-styles.blade.php` file works great! Thanks for the prompt response and pointing me in the right direction.

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#2837