A Obsidian theme combining the colour schemes of Halcyon and Flexoki.

I really liked the vibrant colours of the Halcyon colour scheme, and the inky aesthetic of the Flexoki colour scheme. Hence, I decided to combine the two which started this theme.

There is also a light mode colour scheme combining Origami theme's and Flexoki light's colour schemes.

To install this theme via the community store, navigate to Settings > Appearance

1. Under Themes, click Manage
2. Type "Flexcyon in the search bar > Select it > Click "Install and Use"

Installation of Style Settings is highly recommended for this theme, as most customisation and functionality is built around it.

To install this theme via BRAT, navigate to Settings > Community Plugins > Browse

1. Type "BRAT" in the search bar > Select it (the one by TftHacker) > Click install
2. Wait for installation to complete then click Enable
3. Click Options
4. Click Add Beta Theme
5. Input https://github.com/bladeacer/flexcyon and then click Add Theme

Flexcyon is officially supported from Obsidian Version 1.6.3 onwards.

Obsidian 1.6 and above was chosen to be the minimum version supported as support for RTL languages was added then.

Beta or insider versions of Obsidian will not be officially supported, although the theme should (hopefully) not break too much.

If significant issues are found, do open an issue here. I (bladeacer) will try to troubleshoot them once the beta or insider version of Obsidian has a public equivalent.

You can also find this in the documentation.

A huge thanks to GitHub Pages for hosting the documentation.

如果您更熟悉中文, 请 单击此处 查看中文文档。

This theme tries to:

• be "reasonably opinionated"
  • Choose between the opinionated Flex Max mode
  • or customising the theme extensively
  • Opt into customisations you choose instead of opting out
• be decently lightweight, meaning:
  • fonts, svgs and the like are not embedded in this theme
  • (hopefully) sane defaults, customisable with style settings
• dim inactive or unfocused UI elements to reduce information overload
• have a decent feature set of style settings for customisation
• bundle numerous callout metadata utilites

Refer to the documentation for the full set of features in Flexcyon.

• vim mode status (when using builtin vim keybinds)
• Status bar options like Powerlevel10k inspired status bar styling
• Smiley toggle icons and other options for settings
• ASCII art or custom quote in new empty tabs
• subtle opacity effects for UI elements
• a light and dark mode colour scheme
• ASCII checkboxes
• Heading options like underline, numbered, coloured
• A plethora of cssclasses and callout customisation options
• A plethora of cssclasses and callout customisation options
• Workspace Layouts like card layout with TUI inspired add-on, angled layout
• Configure left, right sidebar and modal background images
• Animation options for tabs
• And many more...

• multiple colour schemes (though you can override the existing one with your own, see Style Settings)
• alternate checkboxes
• embedded fonts, svgs

View supported plugins and snippets here

For plugins/snippets that are not styled yet, feel free to open a Pull Request/ Feature Request/start a Discussion on it.

Some of the theme's snippets like ASCII Art and its callouts can be found here.

Feel free to talk about it at:

• this Discord thread.
• this Obsidian forum topic

You can create your own fork before making a pull request.

Before doing this, do open an issue at this repository first.

This repository comes with some scripts. The important ones include:

• npm run dev: SCSS to CSS compiler, assumes you have Sass (Dart, Node) installed
• npm run lint: Lints the entire SCSS codebase. Reruns linting when a file write is detected in source files
• npm run lint-once: As its namesake says, lints the codebase once
• npm run fix: Equivalent to running stylelint --fix. Run this only after your file changes are saved.

If you prefer to use CSS instead of SCSS, place your proposed code changes or snippets in the css/ folder. The maintainer will try to integrate them.

Alternatively, you can open an issue at the repository or start a GitHub discussion here.

Do note that this repository has its own Code of Conduct and Contributing Guide.

Documentation for style settings of this theme can be found here

Documentation on installing and using style settings can be found here

This theme is licensed under the MIT License

Without these contributors and tools, flexcyon would not be possible.

The code of conduct was adopted from the Contributor Covenant

The contributing guide was adopted from conduct