Getting Started with Fewer
Install, import your first directory, and navigate the graph. Everything you need to start exploring directory structures visually.
There is a web version available at https://app.fewer.directory/app.
But if you want to run this locally, follow this quickstart guide.
Installation
git clone https://github.com/qvesera/fewer.git
cd fewer
bun install
bun run devOpen http://localhost:3000.
Quick Start
- Click Load sample project in the welcome dialog
- Use arrow keys (↑↓←→) to navigate the tree
- Right-click (or long-press on touch) any node for context menu
- Press Ctrl+I to see all keyboard shortcuts
- Click Export to save the graph
Import a Real Directory
- Click Import from disk (or Alt+I)
- Select a folder and the depth level
- The graph builds instantly
Advanced Import Options
If Power User mode is enabled in Settings, you will see the below options in the import dialog.
| Option | Default | Description |
| Max Depth | 6 | How many folder levels to import |
| Include Hidden Files | Off | Include dotfiles (.gitignore, .env, etc.) |
| Include File Nodes | On | Show files or folders only |
| Extension Filter | None | Comma-separated whitelist |
| Auto-hide Large Folders | On | Folders with >10 children hide children |
First Graph
After import, you'll see:
- Orange cards for folders (children inline, scrollable)
- Purple cards for files (name, extension, size)
- Edges connecting parent → child with 3 style options
- Minimap in bottom-right for navigation
- Breadcrumb bar showing selected node's full path
Keyboard Navigation
| Key | Action |
| ↑↓←→ | Tree navigation (parent/child/sibling) |
| Alt+N | New node |
| Ctrl+F | Search (fuzzy, click-to-zoom) |
| Ctrl+E | Export panel |
| Ctrl+Z / Ctrl+Shift+Z | Undo / Redo |
| Ctrl+A | Select all |
| Ctrl+L | Cycle layout direction |
| Ctrl+I | Shortcuts reference |
| F2 | Rename |
| Delete/Backspace | Remove (cascading) |
| Space | Fit view |
| + / - / 0 | Zoom in/out/reset |
Sign In (Optional)
Fewer works fully without an account. If you'd like to save your directories to your account, access them across devices, and share them, click Sign in in the top navbar. See Accounts & Saved Graphs for details.