RefractTrack Home

RefractTrack Documentation

RefractTrack is a small, self-hosted kanban tool for tracking development tasks across one or more game projects. It runs on plain PHP 8 and MySQL/MariaDB with no framework and no build step, uses Jira-style task IDs (PREFIX-123) with matching clean URLs (/task/FE-12), and supports fine-grained role-based permissions, per-project stages/groups/saved lists, CSV/JSON export and import, 15 selectable color themes, and automatic schema migrations.

This documentation describes RefractTrack as of package version v99.

Getting started

Sales Pitch — some feature highlights and why it will work for you
Buy It! — for sale at itch.io
Installation — guided wizard and manual setup, requirements, upgrading an existing install
Server Setup — the standalone prereqs.sh provisioning script for a fresh Debian/Ubuntu box
Configuration — config/config.php settings and Clean URLs

Core concepts

Projects — multi-project support, task numbering, soft delete
Tasks — task fields, task types, bug-specific fields, task codes
Board and List Views — the kanban board, drag-and-drop, list/filter view
Stages — per-project swimlanes/workflow stages
Groups — per-project many-to-many task tags
Markdown Formatting — the supported text-formatting subset and task-code auto-linking

Workflows

Bulk Task Creation and Saved Lists — mail-merge style batch task creation
Archiving — archiving/unarchiving tasks individually or in bulk
Approvals and Review — the task review workflow (pending / approved / won't do)
Comments and Activity Log — discussion and automatic system history on each task
Attachments — file uploads on tasks
Export and Import — CSV/JSON project export and import

Administration

Users — accounts, activation, password resets
Permissions and Roles — the full RBAC model, role presets, per-user overrides
Themes and Branding — the 15 color themes and application name
Per User Preferences — what the app remembers per user across sessions
Migrations and Upgrades — automatic schema migrations, web and CLI upgrade paths

Reference

Feature Inventory — a flat checklist of everything the app can do
Data Model — database tables at a glance
Security — the hardening measures built into the app
Architecture — request lifecycle and where things live in the codebase (for maintainers)
Known Limitations — things that are deliberately not supported yet