# Project pack: Spliit @ 73478ed

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

> Spliit is a free, simple way to share expenses, like Splitwise without ads or limits. Make a group for a holiday, a shared flat or a family, add who paid for what, and Spliit works out the balances and the fewest payments to settle up. Nobody needs an account: you share the group's link. Use the free spliit.app site, or run your own copy.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Use it in a web browser; nothing to install on your computer. Uses the free official site; it is not your own copy, so code changes need a self-hosted instance.
- 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/spliit-app/spliit/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/spliit-app/spliit
- Pinned commit: `73478ed2f67a59e83866948caeece6bf2ecb985e`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/spliit-app/spliit/archive/73478ed2f67a59e83866948caeece6bf2ecb985e.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.
- Live demo: https://spliit.app. The official free instance run by the project, not a throwaway demo. Groups you create there are real and stay until deleted. Anyone with a group's link can see and change it.
- Licence: **MIT**. Free to use, change and share for any purpose, including commercially. Just keep the copyright notice and licence text with the code. You don't have to publish your changes.

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

  ```sh
  git clone https://github.com/spliit-app/spliit bespoke-spliit
  cd bespoke-spliit
  git checkout --detach 73478ed2f67a59e83866948caeece6bf2ecb985e
  # Prepare development requirements and local configuration first.
  # Setup notes: http://localhost:3000; npm install also applies migrations
  cp .env.example .env && ./scripts/start-local-db.sh && npm install && npm run dev
  ```

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

  ```sh
  Copy the sample docker-compose.yml from the README (the Spliit image ghcr.io/spliit-app/spliit:latest plus PostgreSQL), change the database password in both places, then run: docker compose up -d # then open http://localhost:8080
  ```
- Tools these commands use: Docker, or for development Node.js + npm + PostgreSQL (scripts/start-local-db.sh starts one in Docker)
- Develop: `cp .env.example .env && ./scripts/start-local-db.sh && npm install && npm run dev   # http://localhost:3000; npm install also applies migrations`
- Test: `npm test`
- Check/lint: `npm run lint && npm run check-types && npm run check-formatting`
- Stack: typescript (Next.js 16, React 19, tRPC, Prisma, Tailwind CSS, shadcn/ui, next-intl). Difficulty for a non-developer with an AI: **easy**. One Next.js app in TypeScript with a small Prisma schema. Most changes are a page under src/app/groups/[groupId]/, a component, a tRPC router or a translation file. Database changes need a Prisma migration.
Personal data: **yes**. Stored in: PostgreSQL database (the database volume in docker compose); receipt photos in S3 if enabled. Secrets are entered by the person, never in chat.

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