Thanks to visit codestin.com
Credit goes to github.com

Skip to content

A vibecoded hackathon project, only for the reviewers.

Notifications You must be signed in to change notification settings

electr1fy0/blue

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Blue

A secure, local-first, terminal-based markdown note-taking application built as a Hackathon project.

Features

  • Encrypted Storage: Notes are encrypted locally with password protection
  • Real-time Sync: WebSocket-based synchronization across devices
  • Rich Text Support: Markdown rendering with syntax highlighting
  • Organization Tools: Pin, favorite, archive, and tag your notes
  • Search & Filter: Quick search with live filtering
  • Terminal UI: Clean, keyboard-driven interface built with Bubble Tea

Installation

go install github.com/electr1fy0/blue@latest

Usage

Simply run blue to start the application. On first run, you'll create a password-protected notebook.

Keyboard Shortcuts

Main List View

  • a - Add new note
  • enter - View selected note
  • d - Delete note
  • / - Search notes
  • c - Clear search
  • s - Toggle sort (by title/date)
  • e - Export notes
  • g - Toggle archived notes view
  • p - Pin/unpin note
  • f - Favorite/unfavorite note
  • t - Edit tags
  • P - Change password
  • q - Quit

Note View

  • e - Edit note
  • d - Delete note
  • b - Back to list
  • p - Pin/unpin
  • f - Favorite/unfavorite
  • t - Edit tags
  • r - Archive/unarchive

Search Mode

  • enter - Execute search
  • esc - Cancel search

Note Format

Notes support YAML frontmatter for metadata:

---
pinned: true
favorite: false
archived: false
tags: [work, project]
---

# My Note Title

Note content goes here...

Sync Server

Blue includes WebSocket-based synchronization. The sync status is displayed in the bottom right:

  • connected - Successfully connected to sync server
  • disconnected - No connection to sync server

Project Structure

  • Model: TUI state management and event handling
  • Storage: Encrypted notebook persistence
  • Server: WebSocket synchronization
  • Utils: Editor integration and utilities

Dependencies

  • Bubble Tea - TUI framework
  • Glamour - Markdown rendering
  • WebSocket for real-time sync when multiple devices have the app open

Note:

It has been tested on UNIX based platforms only. Experience on Windows may vary.

It's slightly buggy due to heavy reliance on LLMs.

About

A vibecoded hackathon project, only for the reviewers.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages