# Project pack: Glance @ 8958aa8

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

> Glance is a self-hosted dashboard that puts everything you check each day on one fast page: RSS feeds, weather, Reddit, YouTube, stock prices, calendars, server stats and more. It is a single small program configured with one YAML file, and looks good on desktop and phone.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Download the prebuilt program for your system and run it. 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/glanceapp/glance/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/glanceapp/glance
- Pinned commit: `8958aa827275cf81c01f3d5afe7180354a200cc6`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/glanceapp/glance/archive/8958aa827275cf81c01f3d5afe7180354a200cc6.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://github.com/glanceapp/glance/blob/main/docs/configuration.md
- Licence: **AGPL-3.0-only**. Free to use and change. If other people use your changed version, including over a network (for example a website you host for them), you must offer them your source code under the same licence. Using it privately for yourself or your household has no extra obligations.

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

  ```sh
  git clone https://github.com/glanceapp/glance bespoke-glance
  cd bespoke-glance
  git checkout --detach 8958aa827275cf81c01f3d5afe7180354a200cc6
  # Prepare development requirements and local configuration first.
  go run . --config docs/glance.yml
  ```

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

  ```sh
  mkdir glance && cd glance
  curl -o glance.yml https://raw.githubusercontent.com/glanceapp/glance/main/docs/glance.yml
  docker run -d --name glance -p 8080:8080 -v ./glance.yml:/app/config/glance.yml glanceapp/glance
  # then open http://localhost:8080
  ```
- Tools these commands use: Docker for a trial, Go 1.23+ for development
- Develop: `go run . --config docs/glance.yml`
- Test: `go test ./...`
- Stack: go, html, javascript (Go standard library, HTML templates, vanilla JavaScript). Difficulty for a non-developer with an AI: **easy**. A single Go binary with templates and widgets as separate files. You rarely need code: widgets and a custom-api widget cover most needs.
Personal data: **no**. Stored in: A YAML configuration file. Nothing else is stored. Secrets are entered by the person, never in chat.

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