# Firesoft Project

## Overview

EMS/Fire department incident management software built with Expo React Native.

**Status:** In Progress  
**Workspace:** `/home/mike/code/Firesoft`  
**Project ID:** `bf1cbed2-9943-49e0-bf64-6e2f132b8790`  
**Repository:** https://git.freno.me/Mike/Firesoft.git

## Tech Stack

- **Framework:** Expo (React Native 0.81.5, React 19.1.0, Expo SDK 54)
- **Language:** TypeScript
- **Database:** Turso (libsql) with local-first architecture
- **State Management:** MobX
- **Authentication:** Clerk
- **Navigation:** Expo Router (file-based routing)
- **Theming:** Light/dark mode support

## Architecture

### Key Directories

- `app/` - File-based routing (Expo Router)
  - `(auth)/` - Authentication screens
  - `(tabs)/` - Main tab navigation
- `components/` - Reusable UI components
  - `ui/` - Basic UI components
  - `layouts/` - Screen layout wrappers
- `services/` - Business logic and API calls
- `hooks/` - Custom React hooks
- `stores/` - MobX stores
- `database/` - Turso database utilities
- `types/` - TypeScript type definitions

### Data Layer

- **Local-first:** Works offline with sync queue
- **Services:** IncidentService, ProfileService, etc.
- **Custom Hooks:** useIncidents, useTrainingRecords, useDepartments, useUsers

## Current Focus

Phase 2: Code Quality Improvements (FRE-5)

- **Completed:** FRE-16 - Custom data hooks created
- **Next:** Continue modularization and component consolidation

## Key Features

- Incident tracking and reporting
- Training records management
- Department management
- User management with roles/permissions
- Export functionality (NERIS format)
- Offline support with sync

## Last Updated

2026-03-10