# Project pack: Grist @ 2a1e3ce

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

> Grist combines the ease of a spreadsheet with the structure of a database. Tables can link to each other, columns have types, formulas are Python, and you can build dashboards with charts and cards on top. It is good for inventories, trackers, small CRMs and family records.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Install the project's own desktop app or installer. 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/gristlabs/grist-core/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/gristlabs/grist-core
- Pinned commit: `2a1e3ce9ef13fd562d086c84b03d4040077a78ae`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/gristlabs/grist-core/archive/2a1e3ce9ef13fd562d086c84b03d4040077a78ae.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://support.getgrist.com
- Live demo: https://docs.getgrist.com/. The official hosted version, free for personal use. Don't enter private data in public documents.
- Licence: **Apache-2.0**. Free to use, change and share, even commercially. Keep the licence and copyright notices, and note your changes. It includes a patent licence.

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

  ```sh
  git clone https://github.com/gristlabs/grist-core bespoke-grist
  cd bespoke-grist
  git checkout --detach 2a1e3ce9ef13fd562d086c84b03d4040077a78ae
  # Prepare development requirements and local configuration first.
  yarn install
  yarn run install:python
  yarn start
  ```

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

  ```sh
  docker run -d --name grist -p 8484:8484 -v grist-persist:/persist gristlabs/grist
  # then open http://localhost:8484
  ```
- Tools these commands use: Docker for a trial, Node 22 and Python 3.11 for development
- Develop: `yarn start`
- Test: `yarn test`
- Check/lint: `yarn lint`
- Stack: typescript, python (Express, Knockout, Pyodide, Yarn). Difficulty for a non-developer with an AI: **advanced**. A large TypeScript and Python code base with its own formula engine. Most customisation happens inside documents: tables, formulas, widgets and custom widgets. Source changes are rare.
Personal data: **yes**. Stored in: SQLite document files and a small home database under /persist. Secrets are entered by the person, never in chat.

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