No description
Find a file
2025-10-13 07:41:23 +02:00
.github fix: ensure default values for bump and beta inputs in CI workflow 2025-03-19 20:20:12 +01:00
docs fix: hovering and is-active should not be overwritten 2025-09-22 18:12:01 +02:00
hooks Initial commit 2024-11-26 21:13:47 +01:00
src fix: update regex to include additional punctuation in string replacement 2025-10-13 07:41:23 +02:00
tests test: update test with default color generation 2025-04-16 13:14:23 +02:00
.editorconfig Initial commit 2024-11-26 21:13:47 +01:00
.gitignore Initial commit 2024-11-26 21:13:47 +01:00
.npmrc Initial commit 2024-11-26 21:13:47 +01:00
biome.json chore(dep): update dep 2025-09-22 18:12:31 +02:00
bun.lock chore: update dep 2025-10-13 07:35:25 +02:00
CHANGELOG-beta.md chore(release): 1.2.0-0 2025-07-05 21:45:22 +02:00
CHANGELOG.md chore(release): 1.2.2 2025-09-22 18:12:39 +02:00
commit-and-tag-version.mjs Initial commit 2024-11-26 21:13:47 +01:00
esbuild.config.mjs chore: update dep 2025-10-13 07:35:25 +02:00
LICENSE chore: fix license copyright version 2025-04-24 09:24:34 +02:00
manifest-beta.json chore(release): 1.2.2 2025-09-22 18:12:39 +02:00
manifest.json chore(release): 1.2.2 2025-09-22 18:12:39 +02:00
package.json chore: update dep 2025-10-13 07:35:25 +02:00
README.md feat: inject the data-path into .tree-item.nav-folder to avoid using :has selector. 2025-06-28 21:29:51 +02:00
tsconfig.json feat: add TypeScript types for Bun and implement tests for CSS variable generation 2025-03-19 12:56:30 +01:00
version-bump.mjs Initial commit 2024-11-26 21:13:47 +01:00
versions.json Initial commit 2024-11-26 21:13:47 +01:00

Simple Colored Folder

Automagically add color to roots folders, and customize them with Style Settings.

tree with colored folders

📦 Features

  • Automatically applies variables & colors to root-level folders in your vault
  • Customizable colors for each folder through style settings
  • Custom styling options through template
  • Folder style changes update in real-time
  • Supports both light & dark themes
  • Support for renaming folder while keeping styling

Warning

This plugin requires the Style Settings plugin to customize folder colors. You'll see a warning if Style Settings isn't installed.

⚙️ Usage

  1. Install the plugin
  2. Make sure you also have the Style Settings installed & enabled.
  3. Access Style settings to customize your folder color.
  4. Under the "Simple Colored folder" section, you can change colors for each root folder.

style settings

🎨 Configuration

In the plugin settings, you can customize :

  • Export to a css snippets (instead of inject into the DOM)1
  • Default colors (when creating new folders)
  • Folder name prefix for CSS variable
  • Custom CSS and Style Settings templates

settings

Note

You can see some example of css template here

📥 Installation

  • From Obsidian's community plugins
  • Using BRAT with https://github.com/Mara-Li/obsidian-simple-colored-folder
  • From the release page:
    • Download the latest release
    • Unzip simple-colored-folder.zip in .obsidian/plugins/ path
    • In Obsidian settings, reload the plugin
    • Enable the plugin

🎼 Languages

  • English
  • French

To add a translation:

  1. Fork the repository
  2. Add the translation in the src/i18n/locales folder with the name of the language (ex: fr.json).
    • You can get your locale language from Obsidian using obsidian translation or using the commands (in templater for example) : <% tp.obsidian.moment.locale() %>
    • Copy the content of the en.json file in the new file
    • Translate the content
  3. Edit i18n/i18next.ts :
    • Add import * as <lang> from "./locales/<lang>.json";
    • Edit the ressource part with adding : <lang> : {translation: <lang>}

  1. Some styles can be broken while disabling the plugin, as it injects the folder path into tree-item.nav-folder to improve performance, instead to use :has. ↩︎