π PostMortem Tracker
A high-performance, enterprise-grade Incident and Root Cause Analysis (RCA) tracker.
Built for engineers who value Extreme Ownership and need a structured way to document, track, and resolve system failures with clarity and precision.
π Features
π΄ Incident Tracking Track incidents from detection to resolution with severity levels and timestamps.
π Real-time Analytics Automatic dashboard metrics to monitor system health and critical failures.
π Smart Search Instant filtering and search across all incidents.
πΎ Data Portability Export and import full incident history using JSON.
β‘ Event-Driven UI Optimized UI using native DOM APIs and event delegation.
π§ Type Safety First Built with strict TypeScript for reliable, predictable behavior.
π Tech Stack Language: TypeScript Build Tool: Vite Storage: LocalStorage (Web Storage API) Architecture: Layered Architecture (MVC-inspired separation) Models Services Components Utils π¦ Getting Started Prerequisites Node.js (v18+ recommended) npm (comes with Node.js)
π§ Installation
-
Clone the repository git clone https://github.com/codecruncher0723/postmortem-tracker.git
-
Navigate to project cd postmortem-tracker/Project
-
Install dependencies npm install
-
Start development server npm run dev
-
Open in browser Visit: http://localhost:5173
Project/ βββ public/ # Static assets βββ src/ β βββ components/ # UI components (Incident cards, dashboard UI) β βββ models/ # TypeScript interfaces & types β βββ services/ # Business logic + localStorage handling β βββ utils/ # Helper functions (analytics, factories) β βββ styles/ # Global styles β βββ main.ts # Application entry point β βββ index.html # App root HTML βββ vite.config.ts # Vite configuration βββ tsconfig.json # TypeScript config βββ package.json # Dependencies & scripts βββ dist/ # Production build output (auto-generated)
π§ Engineering Philosophy
This project follows:
Single Responsibility Principle (SRP) Layered Architecture Separation of Concerns Framework-agnostic design
Business logic is fully decoupled from UI components to ensure scalability and maintainability.
π¦ Build for Production npm run build
Output will be generated in: dist/
π Deployment (GitHub Pages) npm run deploy
Make sure vite.config.ts contains: base: '/postmortem-tracker/'
π License This project is open-source and intended for educational use.