How caelestia-dots/caelestia works
Caelestia is a collection of desktop and application configurations, with Hyprland as a central configurable environment and theme integrations for Firefox and VS Code. The documented user workflow is to invoke the external CLI to install selected manifest components, then use the configured applications. The README and tree establish those capabilities; sampled source confirms the VS Code scheme watcher and Firefox native-messaging/theme updates, but not the internals of the CLI or most configuration loading links.
Main entry points: hyprland.lua Hyprland config · src/extension.ts VS Code integration · src/extension.ts Firefox integration · app.fish Firefox native host
Components 22
Installation
- Caelestia CLI
- Component manifest
manifest.toml
Desktop environment
- Hyprland config
hypr/hyprland.lua - Hyprland defaults
hypr/variables.lua - Keybindings
hypr/hyprland/keybinds.lua - Hyprland utilities
hypr/utils/functions.lua - Session environment
uwsm/env-hyprland
Application configs
- Fish shell config
fish/config.fish - Foot terminal config
foot/foot.ini - Starship prompt
starship.toml - Fastfetch config
fastfetch/config.jsonc - Firefox profile config
firefox/user.js
Theme integrations
- Firefox native host
firefox/native_app/app.fish - Firefox integration
firefox/caelestia-firefox-integration/src/extension.ts - VS Code integration
vscode/caelestia-vscode-integration/src/extension.ts - Theme generator
vscode/caelestia-vscode-integration/src/theme.ts - VS Code theme
vscode/caelestia-vscode-integration/themes/caelestia.json
Other components
- User
- Firefox
- Dark Reader
- Current color scheme
- VS Code
Connections 16
- User → Caelestia CLI: runs install
- Caelestia CLI → Component manifest: reads components
- Caelestia CLI → Hyprland config: installs config
- Caelestia CLI → Fish shell config: installs config
- Caelestia CLI → Firefox profile config: installs config
- Hyprland config → Hyprland defaults: uses defaults
- Hyprland config → Keybindings: configures bindings
- Hyprland config → Hyprland utilities: uses utilities
- Hyprland config → Session environment: uses environment
- Firefox native host → Firefox integration: sends messages
- Firefox integration → Firefox: updates theme
- Firefox integration → Dark Reader: sends theme
- VS Code integration → Current color scheme: watches and reads
- VS Code integration → Theme generator: generates colors
- VS Code integration → VS Code theme: writes theme
- VS Code → VS Code integration: activates extension