README.md

A dark Neovim colorscheme. Ethereal cyan, cool silver, deep OLED blacks.

Install · Configure · Palette · Plugins · Extras

Philosophy

Sora sits between Tokyo Night's saturation and Lume's muted pastels. The background is near-black with a cool blue undertone, deep enough for OLED. Syntax colors are muted but readable - they don't compete with each other.

The signature ethereal cyan (#80c8e0) for functions is lighter and softer than Tokyo Night's blue, cooler than Lume's lavender. A single warm accent - gold (#d4b878) for constants and numbers - acts like a star against the cool palette. That one warm point in a field of cool tones is what gives Sora its look.

Eight named accents, each with a clear role. No neon, no Christmas tree.

Installation

{
  "Aejkatappaja/sora",
  lazy = false,
  priority = 1000,
  opts = {},
  config = function(_, opts)
    require("sora").setup(opts)
    vim.cmd("colorscheme sora")
  end,
}

use {
  "Aejkatappaja/sora",
  config = function()
    require("sora").setup()
    vim.cmd("colorscheme sora")
  end,
}

MiniDeps.add("Aejkatappaja/sora")
require("sora").setup()
vim.cmd("colorscheme sora")

Configuration

Defaults - pass only what you want to change:

require("sora").setup({
  transparent = false,      -- transparent background (also strips float/statusline bg)
  italic = true,            -- italics globally
  italic_comments = true,   -- italics for comments (ignored if italic = false)

  on_colors = function(colors) end,        -- override palette before highlights build
  on_highlights = function(hl, colors) end, -- override highlight groups after they build
})

Recipes

require("sora").setup({ transparent = true })

require("sora").setup({ italic = false })
-- or keep italics everywhere but comments:
require("sora").setup({ italic_comments = false })

require("sora").setup({
  on_colors = function(colors)
    colors.bg = "#000000"
    colors.bg_float = "#000000"
    colors.bg_statusline = "#000000"
  end,
})

require("sora").setup({
  on_colors = function(colors)
    colors.func = "#a0d8f0"  -- brighter functions
    colors.string = colors.sage
  end,
})

require("sora").setup({
  on_highlights = function(hl, colors)
    hl.Comment = { fg = colors.fg_comment, italic = true }
    hl.LineNr = { fg = colors.fg_gutter }
    hl.CursorLineNr = { fg = colors.cyan, bold = true }
    hl.FloatBorder = { fg = colors.border, bg = colors.bg_float }
  end,
})

Palette

Role	Color	Hex
Background		#0e1018
Foreground		#c8d0e0
Cyan		#80c8e0
Purple		#b0a0d8
Sage		#90c8a0
Peach		#d0a888
Gold		#d4b878
Rose		#d0909c
Teal		#78b8b0
Steel		#8898b8

Supported Plugins

Sora includes highlight groups for:

• telescope.nvim
• nvim-cmp / blink.cmp
• gitsigns.nvim
• nvim-tree.lua / neo-tree.nvim / oil.nvim
• lualine.nvim (built-in theme)
• mini.statusline
• indent-blankline.nvim / snacks.nvim
• which-key.nvim
• trouble.nvim
• lazy.nvim / mason.nvim
• noice.nvim / nvim-notify
• flash.nvim / fzf-lua
• render-markdown.nvim
• dashboard-nvim
• treesitter-context

Full Treesitter and LSP semantic token support.

Lualine

require("lualine").setup({
  options = { theme = "sora" },
})

Extras

Sora everywhere:

tmux

For a basic tmux setup, add to your tmux.conf:

source-file /path/to/sora.nvim/extras/tmux/sora.tmux.conf

If you use tokyo-night-tmux, paste the contents of extras/tmux/tokyo-night-tmux-sora.sh into the plugin's src/themes.sh (before the default *) case), then add to your tmux.conf:

set -g @tokyo-night-tmux_theme "sora"

License

MIT