# Project pack: Rallly @ fc272a5

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

> Rallly helps a group agree on when to meet. Suggest a few dates or times, share one link, and everyone ticks yes, if need be, or no. Nobody needs an account to vote. You see the best option at a glance, pick it, and Rallly emails everyone the final date with a calendar invite. Good for book clubs, committees, family get-togethers and team meetings.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. Docker Desktop on Windows may need a computer restart and an admin-only Windows feature (virtualisation); say so and let the person decide.
- Verdict source: https://raw.githubusercontent.com/lukevella/rallly/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/lukevella/rallly
- Pinned commit: `fc272a5094e548462f158e4a90799de7febc98b1`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/lukevella/rallly/archive/fc272a5094e548462f158e4a90799de7febc98b1.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.rallly.co
- Licence: **AGPL-3.0-or-later**. Free to use and change. If you run a changed version that other people use over the internet, you must offer them your source code under the same licence. Self-hosting is free for one registered user (anyone can vote without an account); the author asks groups with more registered users to buy a one-off licence key, on an honour system.

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

  ```sh
  git clone https://github.com/lukevella/rallly bespoke-rallly
  cd bespoke-rallly
  git checkout --detach fc272a5094e548462f158e4a90799de7febc98b1
  # Prepare development requirements and local configuration first.
  pnpm install && cp apps/web/.env.sample apps/web/.env && cp packages/database/.env.sample packages/database/.env && pnpm db:generate && pnpm docker:up && pnpm db:reset && pnpm dev
  ```

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

  ```sh
  # On a server with Docker, a domain name and an SMTP email account:
  curl -fsSL https://get.rallly.co | bash
  # The official installer sets up Rallly, PostgreSQL, storage and HTTPS in /opt/rallly and asks for your domain and email settings.
  # Then sign up with the INITIAL_ADMIN_EMAIL address and open /control-panel to claim admin rights.
  ```
- Tools these commands use: A server with 2 GB RAM, Docker 19.03+ with Compose v2, ports 80 and 443 and a domain name, An SMTP email provider (sign-in uses emailed codes), For development, Node (version in .nvmrc), pnpm and Docker
- Develop: `pnpm install && cp apps/web/.env.sample apps/web/.env && cp packages/database/.env.sample packages/database/.env && pnpm db:generate && pnpm docker:up && pnpm db:reset && pnpm dev`
- Test: `pnpm test:unit`
- Check/lint: `pnpm check && pnpm lint && pnpm type-check`
- Build: `pnpm build`
- Stack: typescript (Next.js 16, React 19, tRPC, Prisma, Better Auth, Tailwind CSS, Base UI, Turborepo). Difficulty for a non-developer with an AI: **moderate**. One TypeScript monorepo with a thorough CLAUDE.md. Branding, sign-up rules, email and video-call links are settings. Code is organised by feature in apps/web/src/features/; data lives in a Prisma schema split across files; emails are React templates. Strict conventions (Intl date formatting, Base UI only, structure checks) need care.
- The project's own AI instructions, in the repository: `CLAUDE.md`, `CONTRIBUTING.md`.
Personal data: **yes**. Stored in: PostgreSQL database (bundled container or your own), plus S3-compatible storage for images. Secrets are entered by the person, never in chat.

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