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 - Feature highlights.
• 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