A modern React-based web application for Pennsylvania schools to manage and report fire and security drill compliance data for PIMS (Pennsylvania Information Management System).
This application provides an intuitive interface for school administrators to:
- Track fire and security drills across all school months
- Ensure compliance with Pennsylvania state requirements
- Generate PIMS-compliant CSV exports
- Validate drill data with built-in error checking
- Select from comprehensive Pennsylvania district and school database
- Support for all school types (SD, CS, CTC, IU)
- Multi-school district support
- Monthly drill management (July through June + First Day of School)
- Fire and Security drill types
- Configurable drill limits per month based on state requirements
- Date tracking and validation
- Real-time validation of drill requirements
- Error highlighting for missing required fields
- Warning system for potential compliance issues
- Security drill timing validation (90-day rule)
- Generate PIMS-compliant CSV files
- Automatic filename generation with timestamps
- Ready-to-upload format for state reporting
- Frontend: React 18 with TypeScript
- Styling: Tailwind CSS
- Icons: Lucide React
- Build Tool: Vite
- Data Processing: PapaParse for CSV generation
- File Handling: FileSaver.js
- Node.js (v16 or higher)
- npm or yarn
- Clone the repository:
git clone https://github.com/Bwest8/FIRESEC-tool.git
cd FIRESEC-tool- Install dependencies:
npm install- Start the development server:
npm run dev- Open your browser to
http://localhost:5173
npm run buildThe built files will be in the dist directory.
- Select School Year: Choose the appropriate academic year
- Choose District: Select your school district from the dropdown
- Enter Drill Data: For each school and month:
- Select drill type (Fire or Security)
- Mark if drill was conducted (Yes/No)
- Enter date if conducted
- Provide reason if not conducted
- Add comments as needed
- Validate: The system automatically validates entries
- Export: Generate CSV file for PIMS submission
- Required monthly (except First Day of School)
- Maximum 3 drills per month
- Date required when conducted
- Maximum 1 drill per month
- Special timing rules apply (90-day validation)
- Date required when conducted
- Must be marked as conducted
- Date is required
- Only fire drills allowed
npm run dev- Start development servernpm run build- Build for productionnpm run preview- Preview production buildnpm run lint- Run ESLint
src/
├── components/
│ └── DrillForm.tsx # Main application component
public/
│ └── DistrictLocation.json # Pennsylvania district and school data source
├── App.tsx # Root component
├── main.tsx # Application entry point
└── index.css # Global styles
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
This project is licensed under the MIT License.
This is an unofficial tool designed to assist with PIMS compliance reporting. Users should verify all data and requirements with official Pennsylvania Department of Education guidelines.