First Run (Linear Guide)

Use this if you want one straight path from zero to first successful sync.

1) Install declarch

Choose one method from Installation, then verify:

declarch --version
declarch --help

declarch init

If you are unsure where files are created on your OS:

declarch info --doctor

Declarative-first path (recommended):

// ~/.config/declarch/modules/base.kdl
pkg {
    aur { bat fd ripgrep }
    npm { typescript }
}

Then apply with preview:

declarch --dry-run sync
declarch sync

Direct install shortcut (still valid):

declarch install aur:bat aur:fd aur:ripgrep
declarch install npm:typescript
// check it at `decl edit others`

Alternative: use one backend for all packages in a command:

declarch install bat fzf ripgrep --backend aur

declarch --dry-run sync

Review what will be installed/adopted/removed.

declarch sync

If a command fails, run this sequence:

declarch lint --mode validate
declarch info --doctor
declarch --dry-run sync

Then check Troubleshooting for targeted fixes.