# Local install

`acdev dev` hands your app to the runtime only temporarily. To keep the app in the Dopame desktop on this machine:

```sh
acdev install
```

This runs `acdev build`, then installs the package into `$XDG_DATA_HOME/acde/packages/<id>` (by default `~/.local/share/acde/packages/<id>`, on Windows `%USERPROFILE%\.local\share\acde\packages\<id>`). It copies to a temporary directory first and then swaps the whole directory in, so you never end up with half a package. A handwritten package (no config, with its own `acdev` manifest in `package.json`) is installed as a symlink to the project.

Once installed, the next session you start (and `acdev dev --desktop dopame`) will see it.

## Package lookup

In this order; for a given id, the first one found wins:

1. Directories in `ACDE_PATH` (this is how `acdev dev` hands over its builds);
2. `$XDG_DATA_HOME/acde/packages/*`;
3. `$XDG_DATA_DIRS/acde/packages/*` (system-wide installs).

## Uninstall

```sh
acdev uninstall          # the installed packages: id and path
acdev uninstall <id>     # or the project directory it was installed from
```

It says what it removes and asks first (`--yes` skips the question, and is needed outside a terminal). A copied package's directory is removed; for a handwritten package only the link is removed, never the project. A package that a running `acdev dev` session uses is not removed: stop that session first.

The apps' data is kept: under `~/.local/share/acde/` their storage (`storage/app-<id>/`), backend data (`apps/<id>/`) and private files (`files/<id>/`), their folder grants (`~/.local/state/acde/grants/<id>.json`), and their entries in `~/.config/acde/permissions.json` (camera and microphone decisions) and `~/.local/state/acde/windows.json` (window places). It is kept unless you ask, and removing it takes all of these (other apps' entries in the shared files stay): in a terminal `acdev uninstall` asks whether to remove it too; `--data` removes it and `--keep-data` keeps it without asking. With `--yes` alone it is kept, and the paths are printed. [acdev uninstall](https://docs.dopame.ai/reference/cli.md#acdev-uninstall) lists the exit codes.

## Publishing

An app store and `acdev publish` are still in the works. For now, distributing an app means distributing the built package directory (`.acde/`); put it in any of the locations above.
