Lepton is a lean code snippet manager powered by GitHub Gist. Check out the latest release.
Features
| Organize |
Markdown |
Jupyter Notebook |
|
 |
 |
| Search snippets (⇧ + Space) |
Immersive Mode (⌘/Ctrl + i) |
Dashboard (⌘/Ctrl + d) |
 |
 |
 |
Shortcuts
| Function |
Shortcut |
Note |
| New Snippet |
Cmd/Ctrl + N |
Create a snippet |
| Edit Snippet |
Cmd/Ctrl + E |
Edit a snippet |
| Delete Snippet |
Cmd/Ctrl + Del |
Delete selected snippet |
| Submit |
Cmd/Ctrl + S |
Submit the changes from the editor |
| Sync |
Cmd/Ctrl + R |
Sync snippets with GitHub Gist |
| Immersive Mode |
Cmd/Ctrl + I |
Toggle the Immersive mode |
| Dashboard |
Cmd/Ctrl + D |
Toggle the dashboard |
| About Page |
Cmd/Ctrl + , |
Toggle the About page |
| Search |
Shift + Space |
Toggle snippet search |
See the Search FAQ for searchable fields and content-search behavior.
Customization
Lepton's can be customized by <home_dir>/.leptonrc! You can find its exact path in the About page by Command/Ctrl + ,. Create the file if it does not exist.
- Theme (
light, dark, one-dark, atom-one-dark, github-light, github-dark, catppuccin-latte, catppuccin-mocha, solarized-light, solarized-dark, dracula, material-theme, or ayu)
- Snippet
- Editor
- Logger
- Proxy
- Shortcuts
- Zoom
- Enterprise
- Notifications
- Interface language (
i18n.locale: en, es, fr, ja, ko, tr, zh-Hans, or zh-Hant)
Check out the configuration docs to explore different customization options.
Missing a locale? See How do I add a new interface locale?
Tech Stack
- Framework: Electron
- Bundler: Webpack, Babel, electron-builder
- Language: ES6, Sass/SCSS
- UI/state: React 19, Redux, React Redux, Redux Thunk
- Editor/rendering: CodeMirror, Highlight.js, Markdown/Jupyter rendering
- Tests/lint: Vitest, Electron smoke tests, ESLint
Now you can learn about Lepton project's code structure in DeepWiki!
Installation
brew install --cask lepton
snap install lepton
Support
Lepton is a free and open source project. We do not accept project donations, but if you would like to support the maintainer, you can buy me a coffee.
We also recommend donating to Wikimedia Foundation, which helps sustain free knowledge through Wikipedia and its sister projects.
Development
Runtime requirements
Lepton's current development toolchain is known to work with Node.js 24 LTS and
npm 11.x. This is the host runtime used to install dependencies and run the
webpack build; the bundled Electron app runtime is managed by the Electron
version in package.json.
Recommended:
- Node.js 24.18.0
- npm 11.16.x
If you use nvm, the repository includes an .nvmrc:
$ nvm install
$ nvm use
Apple Silicon development should use the native arm64 Node.js runtime.
Install dependencies
$ git clone https://github.com/hackjutsu/Lepton.git
$ cd Lepton
$ npm ci
# inspect stale dependencies
$ npm run check-outdated
Client ID/Secret
Register your application, and put your client id and client secret in ./configs/account.js.
module.exports = {
client_id: <your_client_id>,
client_secret: <your_client_secret>
}
configs/account.js is intentionally ignored by Git. If it is missing, the app
falls back to configs/accountDummy.js, which is useful for rendering tests but
will not support real GitHub login. Release builds create configs/account.js
from GitHub Actions secrets before packaging.
Run
$ npm run build && npm start
For iterative renderer work, run webpack in watch mode in one terminal and
restart Electron from another terminal when needed:
$ npm run webpack-watch
$ npm start
Build
# Development bundle
$ npm run build
# Production bundle
$ npm run webpack-prod
Automated Validation
Use these commands before opening a pull request:
# Lint application source
$ npm run lint
# Normal local check: Vitest unit tests plus webpack development build
$ npm test
# Unit tests only
$ npm run test:unit
# Unit tests in watch mode
$ npm run test:unit:watch
The project also has Electron smoke checks. These are useful for Electron,
React, layout, preload, or packaging changes, and are run by CI.
# Launches Electron with isolated config/user-data and verifies login plus
# fixture-backed authenticated renderer surfaces
$ npm run test:smoke
# Builds an unpacked app and verifies the packaged app can render the login UI.
# This is primarily for macOS CI or release verification.
$ npm run test:packaged-smoke
Renderer smoke fixtures are opt-in through the smoke runner and use deterministic
mock state to check initial rendering. Fixture names include active, edit,
new, about, dashboard, search, delete, raw, pinned-tags, and
immersive.
# Launch one fixture directly when debugging the automated smoke check
$ npm run build
$ LEPTON_RENDER_FIXTURE=active npm start
Fixtures verify that important React surfaces mount without renderer warnings,
errors, failed loads, or crashes. They do not verify GitHub OAuth, snippet CRUD,
sync behavior, real API responses, OS shortcut delivery, or full interaction
flows.
GitHub Actions currently runs:
lint-test-build: lint, unit tests, and webpack build verificationelectron-smoke: Electron renderer smoke testpackaged-smoke: packaged app smoke testrelease: tag-driven cross-platform packaging and publishing
The smoke jobs are currently configured as non-blocking CI checks while the
cross-platform Electron validation continues to mature.
Manual Verification
For UI or Electron changes, also launch the app locally:
$ npm run build && npm start
Confirm the login page visibly renders. After login, manually verify the
surfaces affected by your change, such as new snippet, edit snippet,
settings/about, dashboard, search, sync, and GitHub Gist backend interactions.
Manual verification is still required for visual quality and real GitHub
behavior; automated smoke checks do not replace backend workflow testing.
Local Packaging
Build an unpacked app for the current platform.
$ npm run pack
Build apps for macOS.
$ npm run dist -- -m
Build apps for Windows.
$ npm run dist -- -w
Build apps for Linux.
Need a running Docker daemon to build a snap package.
$ npm run dist -- -l
Build apps for macOS, Windows and Linux.
$ npm run dist -- -wml
Build apps for the current OS with the current arch.
$ npm run dist
FAQ
--> Wiki FAQ
Contributors
Lepton 是一个基于 GitHub Gist 的免费、轻量的代码片段管理工具——它可以在 macOS、Windows 和 Linux 上管理你的代码片段,所有内容都通过你的 GitHub 账号同步。