# Staffora HRIS — LLM Context

> This file helps AI agents understand and install this project.
> For the full installation guide, see: /llms-full.txt

## What is Staffora?

Staffora is an open-source enterprise Human Resource Information System (HRIS).
It is a multi-tenant, UK-compliant HR platform built with TypeScript.

## Tech Stack

- Backend: Elysia.js (Bun runtime), TypeScript
- Frontend: React 18, React Router v7, TanStack Query, Tailwind CSS
- Database: PostgreSQL 16 with Row-Level Security
- Cache: Redis 7
- Infrastructure: Docker, PgBouncer, Nginx
- Testing: Bun Test (backend), Vitest (frontend), Storybook 8

## Repository

Source: https://github.com/Jamesb123456/HRIS-open-source
License: MIT

## Quick Install (Docker)

```
git clone https://github.com/Jamesb123456/HRIS-open-source.git
cd HRIS-open-source
cp docker/.env.example docker/.env
docker compose -f docker/docker-compose.yml up -d
bun run migrate
bun run --cwd packages/api src/scripts/bootstrap-root.cli.ts
```

Frontend: http://localhost:5173
API: http://localhost:3000
Swagger: http://localhost:3000/docs

## Site Pages

- /                    — Home (platform overview)
- /features            — Feature reference (18 categories)
- /architecture        — System design deep-dive
- /documentation       — Developer documentation
- /api-reference       — REST API endpoint reference
- /installation        — Setup guide (Docker + manual)
- /contributing        — Contributor guide
- /project-structure   — Codebase layout
- /roadmap             — Development trajectory
- /changelog           — Version history
- /license             — License details

## Full Installation Guide

See /llms-full.txt for the complete machine-readable installation guide
with all environment variables, commands, and configuration details.