Skip to content

JadnK/CodeDeck

Repository files navigation

CodeDeck logo

CodeDeck

Your local development cockpit.
Organize projects, launch tools, run commands, manage Git, and start complete development setups from one desktop app.

Download CodeDeck · Documentation · Report a bug

CI status Latest release License Tauri 2 React and TypeScript

CodeDeck demo showing the main development workflow

Why CodeDeck?

A local development workflow is usually spread across project folders, terminals, editors, Git tools, and browser tabs. CodeDeck brings those repeated steps into one searchable desktop dashboard.

Add an existing project, clone a repository, or create one from a template. Then open the correct IDE, run development commands, inspect Git changes, manage project tasks, and launch multi-project environments without rebuilding your setup every time.

CodeDeck is local-first: no account or server is required, and the app configuration stays on your machine.

Features

Project dashboard Search, favorite, archive, scan, and organize local development projects.
Project creation Add folders, clone HTTPS/SSH/local Git repositories, or create projects from built-in and custom templates.
IDE and terminal launchers Open each project in its preferred IDE, terminal, or system file manager.
Build and run Save commands, working directories, environment variables, build/run actions, and development ports.
Live processes Follow stdout and stderr, inspect command status, stop active processes, and receive optional desktop notifications.
Git workbench View diffs, manage branches, stage files, commit, fetch, pull, push, and resolve text merge conflicts.
Launch sets Start several projects, commands, terminals, IDEs, folders, and URLs in parallel or sequence.
Project todos Keep lightweight project-specific tasks with status, priority, and manual ordering.
Local configuration Import and export settings, use light/dark/system themes, and keep CodeDeck available in the system tray.
German and English UI Switch the application interface between German and English.

Screenshots

Project details and development actions
Project details
Git Management
Git Management
Launch set configuration
Launch sets
Project todo management
Project todos

Download

Download the latest build from GitHub Releases.

Platform Packages
Windows .msi or setup .exe
macOS .dmg
Linux .AppImage or .deb

CodeDeck can check published releases and install signed updates from inside the application.

Getting started

  1. Install and open CodeDeck.
  2. Add an existing project folder, scan a projects directory, clone a repository, or create a project from a template.
  3. Select the preferred IDE and configure saved commands or build/run actions.
  4. Use the project dashboard for daily work, or create a launch set for workflows that need multiple projects and tools.

The complete page-by-page guide is available in docs/README.md.

User guides

Run from source

Requirements

Development

git clone https://github.com/JadnK/CodeDeck.git
cd CodeDeck

pnpm install --frozen-lockfile
pnpm tauri:dev

For frontend-only development:

pnpm dev

The frontend-only version is useful for interface work. Filesystem dialogs, process execution, IDE launching, system tray integration, and other native features require the Tauri application.

Checks and production build

pnpm build
cargo check --manifest-path src-tauri/Cargo.toml
pnpm tauri:build

Generated platform packages are written to:

src-tauri/target/release/bundle/

Local data and command safety

  • Adding a project does not move its folder or silently rewrite its source files.
  • Cloning a repository does not automatically execute its project scripts.
  • Commands only start after an explicit user action and run with the permissions of the current operating-system user.
  • Imported commands are treated as untrusted and require confirmation before their first run.
  • Only import configurations and custom templates from sources you trust.

Project structure

CodeDeck/
├── src/                         # React and TypeScript frontend
│   ├── app/                     # Application state and actions
│   ├── features/                # Projects, processes, settings, onboarding, and launch sets
│   └── shared/                  # Shared components, types, storage, and Tauri bridge
├── src-tauri/                   # Rust backend and native integrations
│   ├── src/
│   ├── capabilities/
│   └── tauri.conf.json
├── docs/                        # User documentation and screenshots
├── .github/workflows/           # CI and release workflows
├── CHANGELOG.md
└── CONTRIBUTING.md

Roadmap

Current areas of interest include:

  • SQLite-backed application storage
  • Docker Compose controls
  • A richer port and process overview
  • Reusable launch-set templates
  • A command palette

Ideas, bug reports, and focused feature requests are welcome in GitHub Issues.

Contributing

Contributions are welcome.

Please read CONTRIBUTING.md before opening a pull request and follow the CODE_OF_CONDUCT.md when participating in the project.

Before submitting changes, run:

pnpm build
cargo check --manifest-path src-tauri/Cargo.toml

Useful links:

Tech stack

License

CodeDeck is available under the MIT License.


Built for developers who want less setup and more time inside their projects.
If CodeDeck helps your workflow, consider giving the repository a ⭐.