{ "label": "Extensions (Beta)", "position": 5 } # Themes (Beta) ## Get Started ![Theme demo](/img/docs/themed-xplorer.webp) The Theme extension is a way to define the look of the Xplorer. Xplorer comes with a few default themes (which are `light`, `dark`, `light+`, and `dark+`), but you can also create your own, which is a great way to personalize your Xplorer and is documented in [this guide](/docs/Extensions/create).

How do I change between themes?

You can switch between themes by opening settings and on the Preference page, you can see a dropdown menu with the available themes under `App Theme` section. ![Switching between themes](/img/docs/theme-switching.gif)

## Installing a theme There are 2 ways to install a theme: ### Via `.xtension` file You can download `.xtension` file from the theme developer and simply double clicking it on Xplorer. ![Install theme via .xtension file](/img/docs/install-theme-via-xtension.gif) ### Install from public URL via Xplorer CLI. You can also install a theme from a public URL via Xplorer CLI by running following command: ```bash xplorer extensions theme install ``` #### Example ##### [Shades of Purple](https://github.com/kimlimjustin/xplorer/tree/master/example/themes/shades%20of%20purple) Run following command to install [Shades of Purple](https://github.com/kimlimjustin/xplorer/tree/master/example/themes/shades%20of%20purple) theme: ```bash xplorer extensions theme install https://raw.githubusercontent.com/kimlimjustin/xplorer/master/example/themes/shades%20of%20purple/dist/themes.xtension ``` ##### [Winter](https://github.com/kimlimjustin/xplorer/tree/master/example/themes/winter) Run following command to install [Winter](https://github.com/kimlimjustin/xplorer/tree/master/example/themes/shades%20of%20purple) theme: ```bash xplorer extensions theme install https://raw.githubusercontent.com/kimlimjustin/xplorer/master/example/themes/winter/dist/themes.xtension ``` ## Uninstalling a theme To uninstall a theme, you can run following command: ```bash xplorer extensions uninstall ``` ## Official Themes There are currently 2 official themes: - [Shades of Purple](https://github.com/kimlimjustin/xplorer/tree/master/example/themes/shades%20of%20purple) - [Winter](https://github.com/kimlimjustin/xplorer/tree/master/example/themes/winter) ## Show yours! 👋 Our community is always looking for new themes. If you have a theme that you think would be a good fit, please [tell it to us](https://github.com/kimlimjustin/xplorer/discussions/new?category=show-and-tell). # <%= extensionName %> theme This project was generated with `generator-xplorer-extensions`, learn more [here](https://xplorer.space/docs/Extensions/create/). ## Available Scripts In this project directory, you can run: ### `npm start` Runs the theme in development mode. This will automatically opens Xplorer with your theme being loaded in development mode. The theme will be automatically reloaded when you make changes to the theme files. ### `npm run build` Build and package the theme for production to the `dist/themes.xtension` file. ### `npm run xplorer:install` Install the theme in Xplorer. ## Learn more You can find more information about the theme in the [Xplorer documentation](https://xplorer.space/docs/Extensions/create).

Extensions Skill

Explore Related Technologies & Topics