Decision Tracker (Prime)

A modern, local-first web application for tracking, scoring, and analyzing decisions using a structured dimension-based approach.

Overview

Decision Tracker helps you make better choices by breaking down complex decisions into measurable dimensions (e.g., Logic, Emotion, Financial, Long-term impact). It allows you to score these dimensions, categorizes your decisions, and provides insights over time to improve your decision-making process.

Features

• Structured Decision Making: Evaluate choices across customizable dimensions
• Scoring System: Visual score badges to quickly assess decision quality
• History & Analytics: Track past decisions and view aggregated insights
• Local Storage: All your data stays on your device (browser local storage)
• Tagging & Categorization: Organize decisions by context

Tech Stack

This project is built with a modern frontend stack:

• Framework: React 19 + TypeScript
• Build Tool: Vite
• Routing: React Router v6
• Styling: Tailwind CSS v4
• State Management: Custom React Hooks + LocalStorage
• Icons & UI: Heroicons (assumed/suggested based on typical stacks for these apps), custom components

Project Structure

src/
├── app/          # App setup, Layout, and Router root
├── assets/       # Static assets (images, icons)
├── components/   # Reusable UI components
│   └── ui/       # Foundational components (Button, Card, Input, etc.)
├── hooks/        # Custom React hooks (useDecisions, useInsights, etc.)
├── lib/          # Utilities, constants, and business logic
│   ├── scoring.ts  # Logic for calculating decision scores
│   ├── storage.ts  # LocalStorage wrapper
│   └── ...
├── pages/        # Route components (Dashboard, History, New Decision, etc.)
├── styles/       # Global CSS (Tailwind imports)
└── types/        # TypeScript type definitions

Getting Started

Prerequisites

• Node.js (v18+ recommended)
• npm or yarn or pnpm

Installation

1. Clone the repository
2. Install dependencies:

npm install

Development

Start the development server with Hot Module Replacement (HMR):

npm run dev

Building for Production

Compile TypeScript and build the Vite project:

npm run build

Preview the production build locally:

npm run preview

Linting

Run ESLint to check for code quality and formatting issues:

npm run lint

Data Privacy

This application is entirely local-first. All decisions, tags, and preferences are stored using your browser's localStorage. No data is sent to external servers.