Lepton is a lean code snippet manager powered by GitHub Gist. Check out the latest release.
- Unlimited public/secret snippets
- Unlimited tags
- Language groups
- Markdown/JupyterNotebook
- GitHub Enterprise
- GitHub token
- Immersive mode
- Customizable
- Built-in themes
- macOS/Win/Linux
- Dashboard
- Search
- Proxy
- Free
| Light Theme | Dark Theme |
|---|---|
 |
 |
| Organize | Markdown | Jupyter Notebook |
|---|---|---|
|
 |
 |
| Search (β§ + Space) | Immersive Mode (β/Ctrl + i) | Dashboard (β/Ctrl + d) |
|---|---|---|
 |
 |
 |
| 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 with remote Gist server |
| 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 the search bar |
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, orayu) - Snippet
- Gist
- Editor
- Logger
- Proxy
- Shortcuts
- Enterprise
- Notifications
- Interface language (
i18n.locale:en,es,fr,ja,ko,tr,zh-Hans, orzh-Hant)
Check out the configuration docs to explore different customization options.
Example:
{
"i18n": {
"locale": "ja"
}
}
- 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!
- macOS/Windows/Linux: Download the released packages
- macOS: Install via Homebrew
brew install --cask lepton- Linux: Install via Snap Store
snap install lepton
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 useApple Silicon development should use the native arm64 Node.js runtime.
$ git clone https://github.com/hackjutsu/Lepton.git
$ cd Lepton
$ npm ci# inspect stale dependencies
$ npm run check-outdatedRegister 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>
}$ npm run build && npm startFor 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# Development bundle
$ npm run build
# Production bundle
$ npm run webpack-prodUse 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:watchThe 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-smokeRenderer 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 startFixtures verify that important React surfaces mount without renderer warnings, errors, failed loads, or crashes. They do not verify GitHub OAuth, Gist 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 test
The smoke jobs are currently configured as non-blocking CI checks while the cross-platform Electron validation continues to mature.
For UI or Electron changes, also launch the app locally:
$ npm run build && npm startConfirm 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.
Read electron-builder docs and check out the code signing wiki before building the installer app.
Build an unpacked app for the current platform.
$ npm run packBuild apps for macOS.
$ npm run dist -- -mBuild apps for Windows.
$ npm run dist -- -wBuild apps for Linux.
Need a running Docker daemon to build a
snappackage.
$ npm run dist -- -lBuild apps for macOS, Windows and Linux.
$ npm run dist -- -wmlBuild apps for the current OS with the current arch.
$ npm run dist
MIT Β© hackjutsu