Official Documentation
A comprehensive guide to installing, configuring, and mastering DevDeck.
1. Getting Started
DevDeck is designed to stay completely out of your way until you need it. When you first launch the app, you will be greeted by the Interactive Tour.
We highly recommend taking the 5-step tour to familiarize yourself with the interface. Once the tour finishes, click the Auto-Detect button. DevDeck will automatically scan all your drives (A: to Z:) to find your Node.js, Rust, and Python projects and organize them for you.
2. Managing Workspaces & Projects
A Workspace is simply a parent folder on your hard drive that contains your projects. For example, if you keep all your code in C:\Users\John\Documents\GitHub, that directory is your workspace.
- Navigating: Select a workspace on the left sidebar to view its child projects.
- Filtering & Searching: Use the search bar at the bottom to quickly find a project by name, or filter by framework (React, Next.js, Rust, Vue, etc.) using the dropdown menu.
- Hiding Projects: Right-click or use the UI to hide projects you don't care about (e.g. old deprecated repositories). You can unhide them via the "Hidden Projects" toggle at the bottom.
3. The Script Runner
When you click on a project, DevDeck parses your package.json or Cargo.toml and lists all available scripts.
Click the Run button next to any script (like npm run dev or cargo build) to execute it. The built-in terminal will pop up, streaming the live output seamlessly into the UI. You can run multiple scripts across multiple projects simultaneously, and DevDeck manages the terminals in the background.
4. Process Manager
Ever tried to run a server and got an EADDRINUSE error because port 3000 is already taken? The Process Manager solves this.
Click Process Manager on the bottom left. It automatically queries your OS for any active Node, Rust, or Python servers running in the background. You can instantly kill them with one click, reclaiming your ports and keeping your system clean.