feat: ui package with ascii logo

.gitignore

···
 # Editor/IDE
 # .idea/
 # .vscode/
+
+# Build artifacts
+/tmp

README.md

···
 # Noteleaf
 
-A task & time management CLI built with Golang & Charm.sh libs.
+```sh
+                                    ,,                       ,...
+`7MN.   `7MF'         mm          `7MM                     .d' ""
+  MMN.    M           MM            MM                     dM`
+  M YMb   M  ,pW"Wq.mmMMmm .gP"Ya   MM  .gP"Ya   ,6"Yb.   mMMmm
+  M  `MN. M 6W'   `Wb MM  ,M'   Yb  MM ,M'   Yb 8)   MM    MM
+  M   `MM.M 8M     M8 MM  8M""""""  MM 8M""""""  ,pm9MM    MM
+  M     YMM YA.   ,A9 MM  YM.    ,  MM YM.    , 8M   MM    MM
+.JML.    YM  `Ybmd9'  `Mbmo`Mbmmd'.JMML.`Mbmmd' `Moo9^Yo..JMML.
+```
+
+A note, task & time management CLI built with Golang & Charm.sh libs. Inspired by TaskWarrior & todo.txt CLI applications.
 
 ## Development
+
+Requires Go v1.24+

ROADMAP.md

···
 - `projects` - List all project names
 - `tags` - List all tag names
 
-- `create` - Add new task with description and optional metadata
+- `create|new` - Add new task with description and optional metadata
 
 - `view` - View task by ID
 - `done` - Mark task as completed
···
 - `config` - Manage configuration settings
 
 - `undo` - Reverse last operation
+
+## Notes
+
+- `create|new` - Creates a new markdown note and optionally opens in configured editor
+    - Creates a note from existing markdown file content
+- `list` - Opens interactive TUI browser for navigating and viewing notes
+- `read|view` - Displays formatted note content with syntax highlighting
+- `edit|update` - Opens configured editor OR Replaces note content with new markdown file
+- `remove|rm|delete|del` - Permanently removes the note file and metadata

cmd/cli/main.go

···
 	"context"
 	"fmt"
 	"os"
+	"strings"
 
 	"github.com/charmbracelet/fang"
 	"github.com/spf13/cobra"
 	"stormlightlabs.org/noteleaf/cmd/handlers"
 	"stormlightlabs.org/noteleaf/internal/store"
+	"stormlightlabs.org/noteleaf/internal/ui"
 	"stormlightlabs.org/noteleaf/internal/utils"
 )
 
···
 }
 
 func main() {
-	// Initialize logging early
 	logger := utils.NewLogger("info", "text")
 	utils.Logger = logger
 
···
 	rootCmd := &cobra.Command{
 		Use:   "noteleaf",
 		Short: "A TaskWarrior-inspired CLI with media queues and reading lists",
+		Run: func(cmd *cobra.Command, args []string) {
+			if len(args) == 0 {
+				fmt.Println(ui.Collosal.ColoredInViewport())
+				cmd.Help()
+				return
+			}
+
+			output := strings.Join(args, " ")
+			fmt.Println(output)
+		},
 	}
 
 	rootCmd.AddCommand(&cobra.Command{

go.mod

···
 require github.com/google/uuid v1.6.0
 
 require (
+	github.com/charmbracelet/bubbletea v1.3.4 // indirect
+	github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
+	github.com/mattn/go-localereader v0.0.1 // indirect
+	github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
+	golang.org/x/sync v0.13.0 // indirect
+)
+
+require (
 	github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
+	github.com/charmbracelet/bubbles v0.21.0
 	github.com/charmbracelet/colorprofile v0.3.1 // indirect
-	github.com/charmbracelet/lipgloss v1.1.0 // indirect
-	github.com/charmbracelet/lipgloss/v2 v2.0.0-beta1 // indirect
+	github.com/charmbracelet/lipgloss v1.1.0
+	github.com/charmbracelet/lipgloss/v2 v2.0.0-beta1
 	github.com/charmbracelet/log v0.4.2
 	github.com/charmbracelet/x/ansi v0.9.3 // indirect
 	github.com/charmbracelet/x/cellbuf v0.0.13 // indirect
 	github.com/charmbracelet/x/exp/charmtone v0.0.0-20250603201427-c31516f43444 // indirect
-	github.com/charmbracelet/x/exp/golden v0.0.0-20241011142426-46044092ad91 // indirect
 	github.com/charmbracelet/x/term v0.2.1 // indirect
 	github.com/go-logfmt/logfmt v0.6.0 // indirect
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
-	github.com/lucasb-eyer/go-colorful v1.2.0 // indirect
+	github.com/lucasb-eyer/go-colorful v1.2.0
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/mattn/go-runewidth v0.0.16 // indirect
 	github.com/muesli/cancelreader v0.2.2 // indirect
···
 	github.com/muesli/mango-cobra v1.2.0 // indirect
 	github.com/muesli/mango-pflag v0.1.0 // indirect
 	github.com/muesli/roff v0.1.0 // indirect
-	github.com/muesli/termenv v0.16.0 // indirect
+	github.com/muesli/termenv v0.16.0
 	github.com/rivo/uniseg v0.4.7 // indirect
 	github.com/spf13/pflag v1.0.6 // indirect
 	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect

go.sum

···
 github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8=
 github.com/aymanbagabas/go-udiff v0.2.0 h1:TK0fH4MteXUDspT88n8CKzvK0X9O2xu9yQjWpi6yML8=
 github.com/aymanbagabas/go-udiff v0.2.0/go.mod h1:RE4Ex0qsGkTAJoQdQQCA0uG+nAzJO/pI/QwceO5fgrA=
+github.com/charmbracelet/bubbles v0.21.0 h1:9TdC97SdRVg/1aaXNVWfFH3nnLAwOXr8Fn6u6mfQdFs=
+github.com/charmbracelet/bubbles v0.21.0/go.mod h1:HF+v6QUR4HkEpz62dx7ym2xc71/KBHg+zKwJtMw+qtg=
+github.com/charmbracelet/bubbletea v1.3.4 h1:kCg7B+jSCFPLYRA52SDZjr51kG/fMUEoPoZrkaDHyoI=
+github.com/charmbracelet/bubbletea v1.3.4/go.mod h1:dtcUCyCGEX3g9tosuYiut3MXgY/Jsv9nKVdibKKRRXo=
 github.com/charmbracelet/colorprofile v0.3.1 h1:k8dTHMd7fgw4bnFd7jXTLZrSU/CQrKnL3m+AxCzDz40=
 github.com/charmbracelet/colorprofile v0.3.1/go.mod h1:/GkGusxNs8VB/RSOh3fu0TJmQ4ICMMPApIIVn0KszZ0=
 github.com/charmbracelet/fang v0.3.0 h1:Be6TB+ExS8VWizTQRJgjqbJBudKrmVUet65xmFPGhaA=
···
 github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=
+github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
 github.com/go-logfmt/logfmt v0.6.0 h1:wGYYu3uicYdqXVgoYbvnkrPVXkuLM1p1ifugDMEdRi4=
 github.com/go-logfmt/logfmt v0.6.0/go.mod h1:WYhtIu8zTZfxdn5+rREduYbwxfcBr/Vr6KEVveWlfTs=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
···
 github.com/lucasb-eyer/go-colorful v1.2.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
 github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
 github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4=
+github.com/mattn/go-localereader v0.0.1/go.mod h1:8fBrzywKY7BI3czFoHkuzRoWE9C+EiG4R1k4Cjx5p88=
 github.com/mattn/go-runewidth v0.0.16 h1:E5ScNMtiwvlvB5paMFdw9p4kSQzbXFikJ5SQO6TULQc=
 github.com/mattn/go-runewidth v0.0.16/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
 github.com/mattn/go-sqlite3 v1.14.32 h1:JD12Ag3oLy1zQA+BNn74xRgaBbdhbNIDYvQUEuuErjs=
 github.com/mattn/go-sqlite3 v1.14.32/go.mod h1:Uh1q+B4BYcTPb+yiD3kU8Ct7aC0hY9fxUwlHK0RXw+Y=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=
+github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
 github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
 github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
 github.com/muesli/mango v0.1.0 h1:DZQK45d2gGbql1arsYA4vfg4d7I9Hfx5rX/GCmzsAvI=
···
 github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
 golang.org/x/exp v0.0.0-20231006140011-7918f672742d h1:jtJma62tbqLibJ5sFQz8bKtEM8rJBtfilJ2qTU199MI=
 golang.org/x/exp v0.0.0-20231006140011-7918f672742d/go.mod h1:ldy0pHrwJyGW56pPQzzkH36rKxoZW1tw7ZJpeKx+hdo=
+golang.org/x/sync v0.13.0 h1:AauUjRAJ9OSnvULf/ARrrVywoJDy0YS2AwQ98I37610=
+golang.org/x/sync v0.13.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
+golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.33.0 h1:q3i8TbbEz+JRD9ywIRlyRAQbM0qF7hu24q3teo2hbuw=
 golang.org/x/sys v0.33.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=

internal/ui/art/georgia.txt

···
+                                    ,,                       ,...
+`7MN.   `7MF'         mm          `7MM                     .d' ""
+  MMN.    M           MM            MM                     dM`
+  M YMb   M  ,pW"Wq.mmMMmm .gP"Ya   MM  .gP"Ya   ,6"Yb.   mMMmm
+  M  `MN. M 6W'   `Wb MM  ,M'   Yb  MM ,M'   Yb 8)   MM    MM
+  M   `MM.M 8M     M8 MM  8M""""""  MM 8M""""""  ,pm9MM    MM
+  M     YMM YA.   ,A9 MM  YM.    ,  MM YM.    , 8M   MM    MM
+.JML.    YM  `Ybmd9'  `Mbmo`Mbmmd'.JMML.`Mbmmd' `Moo9^Yo..JMML.

internal/ui/colors.go

···
+// This module contains colors from github.com/charmbracelet/x/exp/charmtone
+//
+// See: https://github.com/charmbracelet/x/blob/main/exp/charmtone/charmtone.go
+package ui
+
+import (
+	"fmt"
+	"image/color"
+	"slices"
+
+	"github.com/lucasb-eyer/go-colorful"
+)
+
+var _ color.Color = Key(0)
+
+// Key is a type for color keys.
+type Key int
+
+const (
+	Cumin Key = iota
+	Tang
+	Yam
+	Paprika
+	Bengal
+	Uni
+	Sriracha
+	Coral
+	Salmon
+	Chili
+	Cherry
+	Tuna
+	Macaron
+	Pony
+	Cheeky
+	Flamingo
+	Dolly
+	Blush
+	Urchin
+	Mochi
+	Lilac
+	Prince
+	Violet
+	Mauve
+	Grape
+	Plum
+	Orchid
+	Jelly
+	Charple
+	Hazy
+	Ox
+	Sapphire
+	Guppy
+	Oceania
+	Thunder
+	Anchovy
+	Damson
+	Malibu
+	Sardine
+	Zinc
+	Turtle
+	Lichen
+	Guac
+	Julep
+	Bok
+	Mustard
+	Citron
+	Zest
+	Pepper
+	BBQ
+	Charcoal
+	Iron
+	Oyster
+	Squid
+	Smoke
+	Ash
+	Salt
+	Butter
+
+	// Diffs: additions. The brightest color in this set is Julep, defined above.
+	Pickle
+	Gator
+	Spinach
+
+	// Diffs: deletions. The brightest color in this set is Cherry, defined above.
+	Pom
+	Steak
+	Toast
+
+	// Provisional.
+	NeueGuac
+	NeueZinc
+)
+
+func (k Key) Hex() string {
+	switch k {
+	case Cumin:
+		return "#BF976F"
+	case Tang:
+		return "#FF985A"
+	case Yam:
+		return "#FFB587"
+	case Paprika:
+		return "#D36C64"
+	case Bengal:
+		return "#FF6E63"
+	case Uni:
+		return "#FF937D"
+	case Sriracha:
+		return "#EB4268"
+	case Coral:
+		return "#FF577D"
+	case Salmon:
+		return "#FF7F90"
+	case Chili:
+		return "#E23080"
+	case Cherry:
+		return "#FF388B"
+	case Tuna:
+		return "#FF6DAA"
+	case Macaron:
+		return "#E940B0"
+	case Pony:
+		return "#FF4FBF"
+	case Cheeky:
+		return "#FF79D0"
+	case Flamingo:
+		return "#F947E3"
+	case Dolly:
+		return "#FF60FF"
+	case Blush:
+		return "#FF84FF"
+	case Urchin:
+		return "#C337E0"
+	case Mochi:
+		return "#EB5DFF"
+	case Lilac:
+		return "#F379FF"
+	case Prince:
+		return "#9C35E1"
+	case Violet:
+		return "#C259FF"
+	case Mauve:
+		return "#D46EFF"
+	case Grape:
+		return "#7134DD"
+	case Plum:
+		return "#9953FF"
+	case Orchid:
+		return "#AD6EFF"
+	case Jelly:
+		return "#4A30D9"
+	case Charple:
+		return "#6B50FF"
+	case Hazy:
+		return "#8B75FF"
+	case Ox:
+		return "#3331B2"
+	case Sapphire:
+		return "#4949FF"
+	case Guppy:
+		return "#7272FF"
+	case Oceania:
+		return "#2B55B3"
+	case Thunder:
+		return "#4776FF"
+	case Anchovy:
+		return "#719AFC"
+	case Damson:
+		return "#007AB8"
+	case Malibu:
+		return "#00A4FF"
+	case Sardine:
+		return "#4FBEFE"
+	case Zinc:
+		return "#10B1AE"
+	case Turtle:
+		return "#0ADCD9"
+	case Lichen:
+		return "#5CDFEA"
+	case Guac:
+		return "#12C78F"
+	case Julep:
+		return "#00FFB2"
+	case Bok:
+		return "#68FFD6"
+	case Mustard:
+		return "#F5EF34"
+	case Citron:
+		return "#E8FF27"
+	case Zest:
+		return "#E8FE96"
+	case Pepper:
+		return "#201F26"
+	case BBQ:
+		return "#2d2c35"
+	case Charcoal:
+		return "#3A3943"
+	case Iron:
+		return "#4D4C57"
+	case Oyster:
+		return "#605F6B"
+	case Squid:
+		return "#858392"
+	case Smoke:
+		return "#BFBCC8"
+	case Ash:
+		return "#DFDBDD"
+	case Salt:
+		return "#F1EFEF"
+	case Butter:
+		return "#FFFAF1"
+	// Diffs: additions.
+	case Pickle:
+		return "#00A475"
+	case Gator:
+		return "#18463D"
+	case Spinach:
+		return "#1C3634"
+	// Diffs: deletions.
+	case Pom:
+		return "#AB2454"
+	case Steak:
+		return "#582238"
+	case Toast:
+		return "#412130"
+	// Provisional.
+	case NeueGuac:
+		return "#00b875"
+	case NeueZinc:
+		return "#0e9996"
+	default:
+		return ""
+	}
+}
+
+func (k Key) String() string {
+	switch k {
+	case Cumin:
+		return "Cumin"
+	case Tang:
+		return "Tang"
+	case Yam:
+		return "Yam"
+	case Paprika:
+		return "Paprika"
+	case Bengal:
+		return "Bengal"
+	case Uni:
+		return "Uni"
+	case Sriracha:
+		return "Sriracha"
+	case Coral:
+		return "Coral"
+	case Salmon:
+		return "Salmon"
+	case Chili:
+		return "Chili"
+	case Cherry:
+		return "Cherry"
+	case Tuna:
+		return "Tuna"
+	case Macaron:
+		return "Macaron"
+	case Pony:
+		return "Pony"
+	case Cheeky:
+		return "Cheeky"
+	case Flamingo:
+		return "Flamingo"
+	case Dolly:
+		return "Dolly"
+	case Blush:
+		return "Blush"
+	case Urchin:
+		return "Urchin"
+	case Mochi:
+		return "Mochi"
+	case Lilac:
+		return "Lilac"
+	case Prince:
+		return "Prince"
+	case Violet:
+		return "Violet"
+	case Mauve:
+		return "Mauve"
+	case Grape:
+		return "Grape"
+	case Plum:
+		return "Plum"
+	case Orchid:
+		return "Orchid"
+	case Jelly:
+		return "Jelly"
+	case Charple:
+		return "Charple"
+	case Hazy:
+		return "Hazy"
+	case Ox:
+		return "Ox"
+	case Sapphire:
+		return "Sapphire"
+	case Guppy:
+		return "Guppy"
+	case Oceania:
+		return "Oceania"
+	case Thunder:
+		return "Thunder"
+	case Anchovy:
+		return "Anchovy"
+	case Damson:
+		return "Damson"
+	case Malibu:
+		return "Malibu"
+	case Sardine:
+		return "Sardine"
+	case Zinc:
+		return "Zinc"
+	case Turtle:
+		return "Turtle"
+	case Lichen:
+		return "Lichen"
+	case Guac:
+		return "Guac"
+	case Julep:
+		return "Julep"
+	case Bok:
+		return "Bok"
+	case Mustard:
+		return "Mustard"
+	case Citron:
+		return "Citron"
+	case Zest:
+		return "Zest"
+	case Pepper:
+		return "Pepper"
+	case BBQ:
+		return "BBQ"
+	case Charcoal:
+		return "Charcoal"
+	case Iron:
+		return "Iron"
+	case Oyster:
+		return "Oyster"
+	case Squid:
+		return "Squid"
+	case Smoke:
+		return "Smoke"
+	case Ash:
+		return "Ash"
+	case Salt:
+		return "Salt"
+	case Butter:
+		return "Butter"
+	case Pickle:
+		return "Pickle"
+	case Gator:
+		return "Gator"
+	case Spinach:
+		return "Spinach"
+	case Pom:
+		return "Pom"
+	case Steak:
+		return "Steak"
+	case Toast:
+		return "Toast"
+	case NeueGuac:
+		return "NeueGuac"
+	case NeueZinc:
+		return "NeueZinc"
+	default:
+		return fmt.Sprintf("Key(%d)", int(k))
+	}
+}
+
+// RGBA returns the red, green, blue, and alpha values of the color for interface [color.Color]
+func (k Key) RGBA() (r, g, b, a uint32) {
+	c, err := colorful.Hex(k.Hex())
+	if err != nil {
+		panic(fmt.Sprintf("invalid color key %d: %s: %v", k, k.String(), err))
+	}
+	return c.RGBA()
+}
+
+func (k Key) IsPrimary() bool {
+	return slices.Contains(PrimaryColors, k)
+}
+
+func (k Key) IsSecondary() bool {
+	return slices.Contains(SecondaryColors, k)
+}
+
+func (k Key) IsTertiary() bool {
+	return slices.Contains(TertiaryColors, k)
+}

internal/ui/logo.go

···
+// See https://patorjk.com/software/taag/
+package ui
+
+import (
+	_ "embed"
+	"strings"
+
+	"github.com/charmbracelet/bubbles/viewport"
+	"github.com/charmbracelet/lipgloss"
+)
+
+type Logo int
+
+const (
+	Collosal Logo = iota
+	Georgia
+	Alligator
+	ANSI
+	ANSIShadow
+)
+
+const collosal string = `
+888b    888          888            888                    .d888
+8888b   888          888            888                   d88P"
+88888b  888          888            888                   888
+888Y88b 888  .d88b.  888888 .d88b.  888  .d88b.   8888b.  888888
+888 Y88b888 d88""88b 888   d8P  Y8b 888 d8P  Y8b     "88b 888
+888  Y88888 888  888 888   88888888 888 88888888 .d888888 888
+888   Y8888 Y88..88P Y88b. Y8b.     888 Y8b.     888  888 888
+888    Y888  "Y88P"   "Y888 "Y8888  888  "Y8888  "Y888888 888
+`
+
+const alligator string = `
+::::    :::  :::::::: ::::::::::: :::::::::: :::        ::::::::::     :::     ::::::::::
+:+:+:   :+: :+:    :+:    :+:     :+:        :+:        :+:          :+: :+:   :+:
+:+:+:+  +:+ +:+    +:+    +:+     +:+        +:+        +:+         +:+   +:+  +:+
++#+ +:+ +#+ +#+    +:+    +#+     +#++:++#   +#+        +#++:++#   +#++:++#++: :#::+::#
++#+  +#+#+# +#+    +#+    +#+     +#+        +#+        +#+        +#+     +#+ +#+
+#+#   #+#+# #+#    #+#    #+#     #+#        #+#        #+#        #+#     #+# #+#
+###    ####  ########     ###     ########## ########## ########## ###     ### ###
+`
+
+const ansi = `
+███    ██  ██████  ████████ ███████ ██      ███████  █████  ███████
+████   ██ ██    ██    ██    ██      ██      ██      ██   ██ ██
+██ ██  ██ ██    ██    ██    █████   ██      █████   ███████ █████
+██  ██ ██ ██    ██    ██    ██      ██      ██      ██   ██ ██
+██   ████  ██████     ██    ███████ ███████ ███████ ██   ██ ██
+`
+
+const ansiShadow = `
+███╗   ██╗ ██████╗ ████████╗███████╗██╗     ███████╗ █████╗ ███████╗
+████╗  ██║██╔═══██╗╚══██╔══╝██╔════╝██║     ██╔════╝██╔══██╗██╔════╝
+██╔██╗ ██║██║   ██║   ██║   █████╗  ██║     █████╗  ███████║█████╗
+██║╚██╗██║██║   ██║   ██║   ██╔══╝  ██║     ██╔══╝  ██╔══██║██╔══╝
+██║ ╚████║╚██████╔╝   ██║   ███████╗███████╗███████╗██║  ██║██║
+╚═╝  ╚═══╝ ╚═════╝    ╚═╝   ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝╚═╝
+`
+
+//go:embed art/georgia.txt
+var georgia string
+
+func (l Logo) String() string {
+	switch l {
+	case Collosal:
+		return collosal
+	case Georgia:
+		return georgia
+	case Alligator:
+		return alligator
+	case ANSI:
+		return ansi
+	case ANSIShadow:
+		return ansiShadow
+	default:
+		return collosal
+	}
+}
+
+// Colored returns a colored version of the logo using lipgloss with vertical spiral design
+//
+// Creates a vertical spiral effect by coloring character by character:
+//
+//	Combine line position and character position & use modulo to build wave-like transitions
+func (l Logo) Colored() string {
+	logo := l.String()
+	lines := strings.Split(logo, "\n")
+
+	emeraldStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("#10b981"))
+	skyStyle := lipgloss.NewStyle().Foreground(lipgloss.Color("#0284c7"))
+
+	var coloredLines []string
+	for lineIdx, line := range lines {
+		if strings.TrimSpace(line) == "" {
+			coloredLines = append(coloredLines, line)
+			continue
+		}
+
+		var coloredLine strings.Builder
+		for charIdx, char := range line {
+
+			spiralPos := (lineIdx*3 + charIdx) % 8
+
+			if spiralPos < 4 {
+				coloredLine.WriteString(emeraldStyle.Render(string(char)))
+			} else {
+				coloredLine.WriteString(skyStyle.Render(string(char)))
+			}
+		}
+
+		coloredLines = append(coloredLines, coloredLine.String())
+	}
+
+	return strings.Join(coloredLines, "\n")
+}
+
+// ColoredInViewport returns the colored logo rendered inside a viewport bubble
+func (l Logo) ColoredInViewport(renderer ...*lipgloss.Renderer) string {
+	coloredLogo := l.Colored()
+	lines := strings.Split(coloredLogo, "\n")
+
+	maxWidth := 0
+	for _, line := range lines {
+		stripped := lipgloss.Width(line)
+		if stripped > maxWidth {
+			maxWidth = stripped
+		}
+	}
+
+	vp := viewport.New(maxWidth+4, len(lines))
+	vp.SetContent(coloredLogo)
+
+	style := lipgloss.NewStyle().
+		Border(lipgloss.RoundedBorder()).
+		BorderForeground(lipgloss.Color("#6b7280")).
+		Padding(1)
+
+	if len(renderer) > 0 && renderer[0] != nil {
+		style = style.Renderer(renderer[0])
+	}
+
+	return style.Render(vp.View())
+}

internal/ui/palette.go

···
+package ui
+
+import (
+	"image/color"
+
+	"github.com/charmbracelet/fang"
+	"github.com/charmbracelet/lipgloss"
+	lipglossv2 "github.com/charmbracelet/lipgloss/v2"
+)
+
+var PrimaryColors []Key = []Key{
+	Guac,
+	Julep,
+	Bok,
+	Pickle,
+	NeueGuac,
+}
+
+var SecondaryColors []Key = []Key{
+	Malibu,
+	Sardine,
+	Lichen,
+}
+
+var TertiaryColors []Key = []Key{
+	Violet,
+	Mauve,
+	Plum,
+	Orchid,
+	Charple,
+	Hazy,
+}
+
+var ProvisionalColors []Key = []Key{NeueGuac, NeueZinc}
+
+var AdditionColors []Key = []Key{Pickle, Gator, Spinach}
+
+var DeletionColors []Key = []Key{Pom, Steak, Toast}
+
+var NoteleafColorScheme fang.ColorSchemeFunc = noteleafColorScheme
+
+func noteleafColorScheme(c lipglossv2.LightDarkFunc) fang.ColorScheme {
+	return fang.ColorScheme{
+		Base:           c(Salt, Pepper),                  // Light/Dark base text
+		Title:          c(Guac, Julep),                   // Green primary for titles
+		Description:    c(Squid, Smoke),                  // Muted gray for descriptions
+		Codeblock:      c(Butter, BBQ),                   // Light/Dark background for code
+		Program:        c(Malibu, Sardine),               // Blue for program names
+		DimmedArgument: c(Oyster, Ash),                   // Subtle gray for dimmed text
+		Comment:        c(Pickle, NeueGuac),              // Green for comments
+		Flag:           c(Violet, Mauve),                 // Purple for flags
+		FlagDefault:    c(Lichen, Turtle),                // Teal for flag defaults
+		Command:        c(Julep, Guac),                   // Bright green for commands
+		QuotedString:   c(Citron, Mustard),               // Yellow for quoted strings
+		Argument:       c(Sapphire, Guppy),               // Blue for arguments
+		Help:           c(Smoke, Iron),                   // Gray for help text
+		Dash:           c(Iron, Oyster),                  // Medium gray for dashes
+		ErrorHeader:    [2]color.Color{Cherry, Sriracha}, // Red for error headers (fg, bg)
+		ErrorDetails:   c(Coral, Salmon),                 // Red/pink for error details
+	}
+}
+
+// Palette provides semantic color access
+type Palette struct {
+	scheme fang.ColorScheme
+}
+
+// NewPalette creates a new palette instance
+func NewPalette(isDark bool) *Palette {
+	return &Palette{
+		scheme: noteleafColorScheme(lipglossv2.LightDark(isDark)),
+	}
+}
+
+var (
+	Success = lipgloss.NewStyle().
+		Foreground(lipgloss.Color(Julep.Hex())).
+		Bold(true)
+
+	Error = lipgloss.NewStyle().
+		Foreground(lipgloss.Color(Cherry.Hex())).
+		Bold(true)
+
+	Info = lipgloss.NewStyle().
+		Foreground(lipgloss.Color(Malibu.Hex()))
+
+	Warning = lipgloss.NewStyle().
+		Foreground(lipgloss.Color(Citron.Hex())).
+		Bold(true)
+
+	Path = lipgloss.NewStyle().
+		Foreground(lipgloss.Color(Mustard.Hex())).
+		Italic(true)
+)
+
+var (
+	TaskTitle = lipgloss.NewStyle().
+			Foreground(lipgloss.Color(Salt.Hex())).
+			Bold(true)
+
+	TaskID = lipgloss.NewStyle().
+		Foreground(lipgloss.Color(Squid.Hex())).
+		Width(8)
+)
+
+var (
+	StatusPending = lipgloss.NewStyle().
+			Foreground(lipgloss.Color(Citron.Hex()))
+
+	StatusCompleted = lipgloss.NewStyle().
+			Foreground(lipgloss.Color(Julep.Hex()))
+)
+
+var (
+	PriorityHigh = lipgloss.NewStyle().
+			Foreground(lipgloss.Color(Cherry.Hex())).
+			Bold(true)
+
+	PriorityMedium = lipgloss.NewStyle().
+			Foreground(lipgloss.Color(Citron.Hex()))
+
+	PriorityLow = lipgloss.NewStyle().
+			Foreground(lipgloss.Color(Squid.Hex()))
+)
+
+var (
+	MovieStyle = lipgloss.NewStyle().
+			Foreground(lipgloss.Color(Coral.Hex())).
+			Bold(true)
+
+	TVStyle = lipgloss.NewStyle().
+		Foreground(lipgloss.Color(Violet.Hex())).
+		Bold(true)
+
+	BookStyle = lipgloss.NewStyle().
+			Foreground(lipgloss.Color(Guac.Hex())).
+			Bold(true)
+
+	MusicStyle = lipgloss.NewStyle().
+			Foreground(lipgloss.Color(Lichen.Hex())).
+			Bold(true)
+)
+
+// Table and UI styles
+var (
+	TableStyle = lipgloss.NewStyle().
+			BorderStyle(lipgloss.NormalBorder()).
+			BorderForeground(lipgloss.Color(Smoke.Hex()))
+
+	SelectedStyle = lipgloss.NewStyle().
+			Foreground(lipgloss.Color(Salt.Hex())).
+			Background(lipgloss.Color(Squid.Hex())).
+			Bold(true)
+
+	HeaderStyle = lipgloss.NewStyle().
+			BorderStyle(lipgloss.NormalBorder()).
+			BorderForeground(lipgloss.Color(Smoke.Hex())).
+			BorderBottom(true).
+			Bold(false)
+)

internal/ui/ui_test.go

···
+package ui
+
+import (
+	"bytes"
+	"os"
+	"regexp"
+	"strings"
+	"testing"
+
+	"github.com/charmbracelet/lipgloss"
+	"github.com/muesli/termenv"
+)
+
+func stripAnsi(str string) string {
+	return regexp.MustCompile(`\x1b\[[0-9;]*[a-zA-Z]`).ReplaceAllString(str, "")
+}
+
+func withColor(t *testing.T, fn func(r *lipgloss.Renderer)) {
+	t.Helper()
+
+	var buf bytes.Buffer
+	r := lipgloss.NewRenderer(&buf)
+	r.SetColorProfile(termenv.TrueColor)
+	lipgloss.SetDefaultRenderer(r)
+
+	fn(r)
+
+	lipgloss.SetDefaultRenderer(lipgloss.NewRenderer(os.Stdout))
+}
+
+func TestUI(t *testing.T) {
+	t.Run("Hex", func(t *testing.T) {
+		tests := []struct {
+			key      Key
+			expected string
+		}{
+			{Cumin, "#BF976F"},
+			{Cherry, "#FF388B"},
+			{Julep, "#00FFB2"},
+			{Butter, "#FFFAF1"},
+			{Key(-1), ""},
+		}
+
+		for _, tt := range tests {
+			t.Run(tt.key.String(), func(t *testing.T) {
+				if hex := tt.key.Hex(); hex != tt.expected {
+					t.Errorf("expected hex %q, got %q", tt.expected, hex)
+				}
+			})
+		}
+	})
+
+	t.Run("String", func(t *testing.T) {
+		tests := []struct {
+			key      Key
+			expected string
+		}{
+			{Cumin, "Cumin"},
+			{Cherry, "Cherry"},
+			{Key(-1), "Key(-1)"},
+		}
+
+		for _, tt := range tests {
+			t.Run(tt.expected, func(t *testing.T) {
+				if str := tt.key.String(); str != tt.expected {
+					t.Errorf("expected string %q, got %q", tt.expected, str)
+				}
+			})
+		}
+	})
+
+	t.Run("RGBA", func(t *testing.T) {
+		t.Run("valid key", func(t *testing.T) {
+			r, g, b, a := Cumin.RGBA()
+			if a == 0 {
+				t.Error("Alpha should not be zero for a valid color")
+			}
+			if !(r > 0 && g > 0 && b > 0) {
+				t.Error("RGB components should be greater than zero for Cumin")
+			}
+		})
+
+		t.Run("invalid key", func(t *testing.T) {
+			defer func() {
+				if r := recover(); r == nil {
+					t.Errorf("The code did not panic")
+				}
+			}()
+			Key(-1).RGBA()
+		})
+	})
+
+	t.Run("Color Categories", func(t *testing.T) {
+		if !Guac.IsPrimary() {
+			t.Error("Guac should be a primary color")
+		}
+		if Malibu.IsPrimary() {
+			t.Error("Malibu should not be a primary color")
+		}
+		if !Malibu.IsSecondary() {
+			t.Error("Malibu should be a secondary color")
+		}
+		if Guac.IsSecondary() {
+			t.Error("Guac should not be a secondary color")
+		}
+		if !Violet.IsTertiary() {
+			t.Error("Violet should be a tertiary color")
+		}
+		if Guac.IsTertiary() {
+			t.Error("Guac should not be a tertiary color")
+		}
+	})
+
+	t.Run("New Palette", func(t *testing.T) {
+		t.Run("dark mode", func(t *testing.T) {
+			p := NewPalette(true)
+			if p == nil {
+				t.Fatal("NewPalette(true) returned nil")
+			}
+			r, g, b, a := p.scheme.Base.RGBA()
+			pr, pg, pb, pa := Pepper.RGBA()
+			if r != pr || g != pg || b != pb || a != pa {
+				t.Errorf("dark mode base color mismatch: expected Pepper, got %v", p.scheme.Base)
+			}
+		})
+
+		t.Run("light mode", func(t *testing.T) {
+			p := NewPalette(false)
+			if p == nil {
+				t.Fatal("NewPalette(false) returned nil")
+			}
+			r, g, b, a := p.scheme.Base.RGBA()
+			sr, sg, sb, sa := Salt.RGBA()
+			if r != sr || g != sg || b != sb || a != sa {
+				t.Errorf("light mode base color mismatch: expected Salt, got %v", p.scheme.Base)
+			}
+		})
+	})
+
+	t.Run("Logo", func(t *testing.T) {
+		logos := []struct {
+			logo     Logo
+			name     string
+			contains string
+		}{
+			{Collosal, "Collosal", "888b    888"},
+			{Georgia, "Georgia", "`7MN.   `7MF'"},
+			{Alligator, "Alligator", "::::    :::  ::::::::"},
+			{ANSI, "ANSI", "███    ██"},
+			{ANSIShadow, "ANSIShadow", "███╗   ██╗"},
+		}
+		for _, l := range logos {
+			t.Run(l.name, func(t *testing.T) {
+				s := l.logo.String()
+				if s == "" {
+					t.Error("logo string should not be empty")
+				}
+				if !strings.Contains(s, l.contains) {
+					t.Errorf("logo string does not contain expected content: %q", l.contains)
+				}
+			})
+		}
+
+		t.Run("Colored", func(t *testing.T) {
+			withColor(t, func(r *lipgloss.Renderer) {
+				logo := Georgia
+				plain := logo.String()
+				colored := logo.Colored()
+
+				if colored == "" {
+					t.Fatal("colored logo is empty")
+				}
+				if plain == colored {
+					t.Error("Colored logo should be different from plain")
+				}
+				if !strings.Contains(colored, "\u001b[") {
+					t.Error("Colored logo should contain ANSI escape codes")
+				}
+			})
+		})
+
+		t.Run("Colored in Viewport", func(t *testing.T) {
+			withColor(t, func(r *lipgloss.Renderer) {
+				logo := Collosal
+				viewport := logo.ColoredInViewport(r)
+				t.Logf("viewport output:\n%s", viewport)
+
+				if viewport == "" {
+					t.Fatal("viewport is empty")
+				}
+
+				cleanedViewport := stripAnsi(viewport)
+				if !strings.Contains(cleanedViewport, "888") {
+					t.Error("Viewport should contain parts of the logo")
+				}
+
+				borderChars := []string{"╭", "╮", "╯", "╰"}
+				for _, char := range borderChars {
+					if !strings.Contains(viewport, char) {
+						t.Errorf("Viewport should contain rounded border character %s", char)
+					}
+				}
+			})
+		})
+	})
+
+}

justfile

···
 
 # Build the binary to /tmp/
 build:
-    mkdir -p /tmp/
-    go build -o /tmp/noteleaf ./cmd/cli/
-    @echo "Binary built: /tmp/noteleaf/noteleaf"
+    mkdir -p ./tmp/
+    go build -o ./tmp/noteleaf ./cmd/cli/
+    @echo "Binary built: ./tmp/noteleaf"
 
 # Clean build artifacts
 clean: