Skip to content

hslcrb/jsonote

JSONOTE (v1.0.5)

JSONOTE Logo

Korean Japanese Version License Build Status Platform Docker

The Ultimate JSON-based Note-taking Application with GitHub Integration & MCP Support.

Official First Release: Monday, January 19, 2026 (KST)


πŸ› οΈ Installation & Setup (v1.0.5)

1. πŸ’» Desktop App (Windows, macOS, Linux) - Recommended

The fastest and most stable way to use JSONOTE as a native application. Download from our Releases Page.

  • Windows: JSONOTE-Setup-1.0.5.exe (Installer) or .zip (Portable)
  • macOS: JSONOTE-1.0.5.dmg (Universal Intel/Apple Silicon) or .zip
  • Linux: JSONOTE-1.0.5.AppImage (Universal Package) or .tar.gz

2. 🐳 Docker (Containerized Deployment)

Perfect for hosting your own instance or running instantly:

# Pull and Run
docker pull ghcr.io/hslcrb/jsonote:latest
docker run -d -p 3000:3000 --name jsonote-instance ghcr.io/hslcrb/jsonote:latest

Visit http://localhost:3000 to start.

3. πŸ—οΈ Developer Quick Start (Native Build)

Requires Node.js v22.12.0 or higher.

# 1. Clone
git clone https://github.com/hslcrb/jsonote.git
cd jsonote

# 2. Setup
npm install

# 3. Execution (Choose one)
npm run dev          # Start Web Development Server
npm run electron:dev # Start Electron Desktop in Dev Mode

# 4. Production Build
npm run build
npm run start

πŸš€ Key Features

1. Universal Storage Synchronization

  • GitHub Native: Store notes as .json in your private repo.
  • Local / Browser: Direct local folder storage via Electron (Desktop) or File System Access API (Web - Chrome/Edge).
  • Real-time sync with visual feedback.

2. Notion-Inspired Workspace

  • Infinite Hierarchy: Nest pages within pages to build a knowledge base.
  • Database Views: Switch between List, Table, and Board views.
  • Custom Properties: Add metadata fields (Text, Number, Date, etc.) to any note.

3. MCP (Model Context Protocol) Integration

  • Connect to external AI tools (Notion, GitHub, etc.) directly within the editor.

4. Developer-Friendly UI

  • Glassmorphism Design: Premium obsidian-dark aesthetic.
  • Markdown Support: Syntax highlighting, standard URL images, and easy formatting.

βš™οΈ Post-Installation Setup

  1. Open Settings in the app.
  2. Enter your GitHub Personal Access Token (Repo permissions required).
  3. Specify your Owner, Repo, and Branch.
  4. Click Test Connection (μ—°κ²° 진단) to verify.
  5. Everything is ready! Your notes will sync automatically.

πŸ“ Documentations


βš–οΈ License

Licensed under the Apache License 2.0. Copyright 2008-2026 Rheehose (Rhee Creative). All rights reserved.

About

The Ultimate JSON-based Note-taking Application with GitHub Integration & MCP Support.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors