Lines Police CAD

December 30, 2025 · View on GitHub

Lines Police CAD Logo

Repository

World's Leading Free-to-use service for Role-play communities

A free to use Civilian, Police, EMS and Dispatch management CAD (Computer Aided Dispatch). Built to help facilitate role-play communities across the globe. This is Web and Mobile friendly and can support community specific operations when creating civilians, citations and more.

Features

  • 🚔 Civilian & Officer Management - Signup/login for both Civilians and Police Officers
  • 📱 Mobile Friendly - Responsive design that works on all devices
  • 🌐 Web-Based - Easy to access from any browser
  • 🎮 GTA V FiveM Integration - Built for GTA V's Modding framework: FiveM
  • 🔄 Modern Stack - Next.js 14, React, TypeScript, Express.js, MongoDB

Requirements

  1. Node.js (v20.x recommended)
  2. MongoDB

Getting Started

1. Clone the Repository

git clone https://github.com/Linesmerrill/police-cad.git
cd police-cad

2. Install Dependencies

npm install

3. Configure Environment Variables

Duplicate .env.example and rename the new file to .env. Edit to your configurations.

cp .env.example .env

4. Set Up MongoDB

macOS (via Homebrew)

  1. Install MongoDB: Step by step instructions
  2. Start MongoDB: Step by step instructions

Other Platforms

Follow the MongoDB installation guide for your platform.

5. Run the Backend API Service

We have migrated most of our backend code to our police-cad-api microservice. This is now required to be running in order to access certain parts of the app.

Follow the instructions to start and run that service here.

Once running, you will need to add two new environment variables. You can see an example of those here.

6. Start the Development Server

npm run dev

The application will be available at http://localhost:8080.

7. Production Build

npm run build:local  # Runs linting and builds
npm start            # Starts the production server

Development Scripts

  • npm run dev - Start development server with hot reload
  • npm run next:dev - Start Next.js development server only
  • npm run lint - Run ESLint
  • npm run lint:fix - Run ESLint and auto-fix issues
  • npm run build:local - Run linting and build for production
  • npm start - Start production server

Project Structure

  • /app - Next.js App Router pages and components
  • /components - React components (Navbar, Footer, etc.)
  • /views - Legacy EJS templates (being migrated to Next.js)
  • /public - Static assets (images, etc.)
  • /app/routes.js - Express.js routes
  • /server.js - Next.js integrated Express server

Technology Stack

  • Frontend: Next.js 14, React, TypeScript
  • Backend: Express.js, Node.js
  • Database: MongoDB
  • Styling: Tailwind CSS, Inline Styles
  • Authentication: Passport.js

Contributing

We welcome contributions! Please feel free to submit a Pull Request.

License

See LICENSE file for details.

Support

Note: This project is actively being migrated from EJS templates to Next.js. Some pages may still use the legacy EJS format.