Skip to content

TUI Notes is a minimal, keyboard-driven terminal note-taking application built in Go using Bubbletea, Bubbles, and Lipgloss from the Charmbracelet ecosystem. It focuses on clean UI, fast performance, and event-driven state management, making it a great learning project for building interactive TUI applications with Go.

Notifications You must be signed in to change notification settings

vxnsh1/tui-notes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TUI Notes 🧾

A minimal and interactive terminal-based note-taking application built using Go, powered by Bubbletea, Bubbles, and Lipgloss — part of the Charmbracelet

Setup

Prerequisites

  • Go v1.19 or higher

  • make (optional but recommended)

# Clone the repo
git clone https://github.com/yourusername/tui-notes.git
cd tui-notes

# Build
make build

# Run
make run

Features

  • Create, edit, and delete notes
  • Local JSON-based storage
  • Keyboard-only navigation
  • Clean terminal interface
  • Fast and cross-platform
  • Modular, extensible design

Learning Focus

This project focuses on understanding:

  • Go-based stateful applications
  • Event-driven UI handling (init → update → view cycle)
  • Component-based architecture in terminal apps
  • Styling and layout using Lipgloss

Feel free to explore, modify, and improve it! 🖤

About

TUI Notes is a minimal, keyboard-driven terminal note-taking application built in Go using Bubbletea, Bubbles, and Lipgloss from the Charmbracelet ecosystem. It focuses on clean UI, fast performance, and event-driven state management, making it a great learning project for building interactive TUI applications with Go.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published