# Project pack: Dashy @ 93a33d9

Facts about **Dashy** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> Dashy is a self-hosted start page for your home server and favourite links. You describe your sections, apps and widgets in a single YAML file or the built-in editor, then get a good-looking dashboard with status checks, search, themes, icons and many widgets. It has an extensive documentation and a large community.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Run the source directly with the language runtime (PHP, Node or Python). No Docker.
- Offer Docker only if the person asks or this path fails. The commands further down may use Docker; they are not the starting point.
- Verdict source: https://raw.githubusercontent.com/Lissy93/dashy/HEAD/README.md
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/Lissy93/dashy
- Pinned commit: `93a33d945c8b84e5dd37c8bef103770d4701d175`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/Lissy93/dashy/archive/93a33d945c8b84e5dd37c8bef103770d4701d175.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://dashy.to/docs
- Live demo: https://demo.dashy.to. Official demo dashboard.
- Licence: **MIT**. Free to use, change and share, even commercially. Keep the original copyright notice.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/Lissy93/dashy bespoke-dashy
  cd bespoke-dashy
  git checkout --detach 93a33d945c8b84e5dd37c8bef103770d4701d175
  # Prepare development requirements and local configuration first.
  yarn install
  yarn dev
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  docker run -d --name dashy -p 4000:8080 -v dashy-config:/app/user-data lissy93/dashy
  # then open http://localhost:4000
  ```
- Tools these commands use: Docker for a trial, Node 20 and Yarn for development
- Develop: `yarn dev`
- Test: `yarn test`
- Check/lint: `yarn lint`
- Build: `yarn build`
- Stack: javascript, vue (Vue, Vite, Node.js). Difficulty for a non-developer with an AI: **easy**. A Vue single-page app served by a small Node server. Almost all customisation is in conf.yml, themes and widgets.
Personal data: **no**. Stored in: A YAML file in the user-data folder. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/dashy/93a33d9/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/dashy/93a33d9/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/dashy/93a33d9/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/dashy/93a33d9/r3/SKILL.md)