mirror of
https://github.com/Ylianst/MeshCentral.git
synced 2025-11-07 12:52:54 -05:00
Add initial support for custom stylesheets (#7164)
* Add initial support for custom stylesheets Allow an override file `custom.css` that can partially override the stylesheet used for the web interface. # Changes 1. Update default views to use custom stylesheet 2. Update documentation Related to: https://github.com/Ylianst/MeshCentral/issues/7144 * Add custom style support to more views Load `custom.css` in the following views: - agentinvite.handlebars - invite.handlebars - login2.handlebars - message2.handlebars - messenger.handlebars - player.handlebars - sharing.handlebars
This commit is contained in:
@@ -59,6 +59,36 @@ To update device icons, you need to edit these files: `meshcentral-web/public/im
|
||||
By following these steps, you can customize any icon in MeshCentral. Just find and change the corresponding image files in the `meshcentral-web/public/images` folder. Similarly, you can also move other folders from `node_modules/meshcentral` to `meshcentral-web` while keeping the original folder structure. This allows you to modify other parts of MeshCentral too, like the `.handlebars` templates for the web interface. Simply copy files from `node_modules/meshcentral/views` to `meshcentral-web/views` and make your changes in `meshcentral-web`. This lets you match MeshCentral's look to your company's brand or your own style.
|
||||

|
||||
|
||||
### Customizing Web Style
|
||||
MeshCentral gives you the flexibility to override some or all of the web interface. An easy way to modify the style is to do the following:
|
||||
|
||||
1. Create the file `custom.css` under `meshcentral-web/public/styles`. See [above](#customizing-web-style) for more information on `meshcentral-web`.
|
||||
2. Anything added to this file will override the default stylesheets.
|
||||
|
||||
An example file:
|
||||
|
||||
```css
|
||||
#masthead {
|
||||
background-color: red;
|
||||
}
|
||||
|
||||
#page_leftbar {
|
||||
background: linear-gradient(to bottom, #104893 0%,green 100%)
|
||||
}
|
||||
|
||||
#footer {
|
||||
background-color: green;
|
||||
}
|
||||
```
|
||||
|
||||
Gives:
|
||||
|
||||

|
||||
|
||||
!!!note
|
||||
You can of course override the stylesheets by directly copying them into `meshcentral-web/public/styles` but run the risk that future updates to those files in MeshCentral will be masked. `custom.css` is guaranteed to be loaded last on every page and will contain no content by default which means upgrades will work as normal.
|
||||
|
||||
|
||||
### Customizing Agent Invitation
|
||||
Agents can be invited by public link or via email. [Click Here](assistant.md#agent-invitation) to see details.
|
||||
|
||||
|
||||
BIN
docs/docs/meshcentral/images/custom-style-example.png
Normal file
BIN
docs/docs/meshcentral/images/custom-style-example.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 56 KiB |
Reference in New Issue
Block a user