Skip to content

First run

When to read this. You've never used condash. You want to get to a working dashboard on your machine in one sitting, with a tree of realistic items to poke at before you commit to building your own.

By the end, you'll have condash installed, running against the bundled conception-demo tree, and the Projects, Code, Knowledge, and History tabs will all render with content.

1. Install condash

The fastest path is a prebuilt installer from the GitHub Releases page. Each release ships a per-OS bundle:

Platform Artifact
Linux condash_<version>_amd64.AppImage or condash_<version>_amd64.deb
macOS condash_<version>_<arch>.dmg
Windows condash_<version>_x64_en-US.msi

The builds are unsigned — your OS will ask you to confirm once on first launch. See Install for the per-platform bypass.

If you'd rather build from source, clone the repo and run:

make setup                 # one-off, installs cargo-tauri into the rustup toolchain
make frontend              # bundle the dashboard JS/CSS
make build                 # produce the platform installer under src-tauri/target/release/bundle/

That's the same pipeline CI uses. You'll need a Rust toolchain and, on Linux, the usual WebKitGTK + libappindicator system packages.

2. Fetch the demo tree

The condash repo ships a realistic demo tree at examples/conception-demo/. It has nine items, all six statuses, a knowledge tree, and two deliverable PDFs — enough for every feature in the rest of the tutorials to have something to act on.

Copy it into a working location:

mkdir -p ~/conception-demo
curl -fsSL https://codeload.github.com/vcoeur/condash-tauri/tar.gz/main \
  | tar -xz --strip-components=2 -C ~/conception-demo \
      condash-tauri-main/examples/conception-demo

Inspect what you got:

~/conception-demo/
├── README.md
├── configuration.yml
├── projects/
│   ├── 2026-03/         # items created last month (2 done)
│   └── 2026-04/         # 7 items created this month (3 now, 1 review, 1 soon, 1 later, 1 backlog)
└── knowledge/
    ├── conventions.md
    ├── internal/
    └── topics/

Everything is plain Markdown. Open projects/2026-04/2026-04-02-fuzzy-search-v2/README.md in your editor to see the header format.

3. Point condash at the tree

On first launch with no tree configured, condash opens a native folder picker and writes your choice to ${XDG_CONFIG_HOME:-~/.config}/condash/settings.yaml. Pick ~/conception-demo the first time and the next launches reuse it automatically.

For a one-shot run without touching the saved path, set the env var:

CONDASH_CONCEPTION_PATH=~/conception-demo condash

To make a different tree the default, either re-launch with the picker (delete settings.yaml first) or edit conception_path in settings.yaml by hand.

4. Launch

condash

Tauri opens a native desktop window on your OS's webview and points it at the local dashboard. You should see this:

Dashboard rendering the demo tree — Current tab selected Dashboard rendering the demo tree — Current tab selected

The header shows four top-level tabs with counts: Projects (9), Code (3), Knowledge (8), History (9). Under Projects, the sub-tabs are Current / Next / Backlog / Done. The demo tree was built so every bucket has something in it.

5. Walk around

Take two minutes to click through:

  • Current — 3 items with status now (one of each kind: document, incident, project) and 1 item with status review. Click the fuzzy-search-v2 row; the card expands, showing the README on the left and a step list on the right with all four marker states ([x], [~], [ ], [-]).
  • Next — the soon bucket. One project (json-export).
  • Backlog — one project, parked.
  • Done — two archived items from the previous month.
  • Code — three repos: condash scanned workspace_path: /tmp/conception-demo-workspace from configuration.yml and found one .git/ per entry. (If the Code tab shows 0, the workspace path on your machine doesn't exist yet — we'll set that up properly in Your first project.)
  • Knowledge — the knowledge/ tree rendered as an explorer: conventions.md at the root, Internal and Topics folders with index files.
  • History — full-text search across every item + note. Type fuzzy to see ranked matches.

Click the gear icon in the top right to see the Configuration modal — a plain-text YAML editor backed by conception-demo/configuration.yml. Save is atomic (temp file → rename). Per-machine preferences (terminal, pdf_viewer, open_with) live separately in ${XDG_CONFIG_HOME:-~/.config}/condash/settings.yaml and are hand-edited. You'll use this modal in the next tutorial.

6. Close the window

Closing the native window exits condash. Relaunch with condash whenever you want to come back — state lives in the files, not in the app.

What you just learned

  • Installing condash is either a one-click installer from GitHub Releases or three make targets from source.
  • The first-launch folder picker plus CONDASH_CONCEPTION_PATH is the whole setup flow. The path is the only thing you must set.
  • The dashboard renders the files as-is on every page load. There's no database, no watcher, no cache.
  • The tree carries two YAML config files in config/ — one team-shared (configuration.yml), one per-machine (settings.yaml). We'll dig into that split in Configure the conception path.

Next

Your first project → — create a real item, wire its steps, link it to another item, add a note.