StoryTracker

Pivotal Tracker replacement for Agile project management.

Features

• No stories lost/hidden - everyone sees the same stories
• Easy drag-based prioritization
• Flow/Kanban style - you just work on the next item in backlog
• Simple tag-based views
• Velocity/estimation dates are tracked automatically
• SSE for real-time updates
• In our experience, no tool can match the visibility and simplicity of this approach
• Suitable for truly Agile teams

Limitations

• Currently designed for self-deployment (no SaaS yet)
• Define your organization's domain in .env file

Technical stack

Built with:

• Database: PostgreSQL
• Backend: Kotlin/Klite
• Unit tests: JUnit
• Frontend: Svelte/TailwindCSS/TypeScript, including:
  • Internationalization
  • TypeScript types generation
  • Unit tests
• Development config

Prerequisites (install these first):

• JDK 21+
• Node 24+
• Docker

Building

See Dockerfile for more information

Build server

./gradlew jar

Build UI

Inside of ui directory:

Install the dependencies using: npm install and

Build UI using: npm run build

Development

Start API by running the Launcher.

It will automatically try to start the database using docker compose up -d db To access DB via IDE use credentials from .env file.

Start UI using: cd ui && npm start

Running tests

Server tests: ./gradlew test

Repository tests are integration tests, connecting to the real database, which runs in Docker. The test database name is cos_test.

UI tests: cd ui && npm test

Deployment instructions

The easiest way to deploy is via Docker compose:

docker compose up -d

This will build and start the application and the database.