PolicyEngine app v2

A modern web application for policy analysis and simulation, built with React, TypeScript, and Mantine.

Getting started

Prerequisites

• Node.js 20 or higher
• npm

Installation

make install

Development

Start the development server:

make dev

The application will be available at http://localhost:5173

Building

Build for production:

make build

Testing

Run tests:

make test

Run linters:

make lint

Format code:

make format

Project structure

.
├── app/                  # Main application code
│   ├── src/             # Source files
│   ├── public/          # Static assets
│   └── package.json     # Dependencies
├── .github/             # GitHub Actions workflows
└── Makefile            # Build commands

Deployment

The application automatically deploys to GitHub Pages when changes are pushed to the main branch.

Development workflow

1. Create a new branch from main
2. Make your changes
3. Run tests and linting: make test && make lint
4. Create a pull request
5. Once approved and merged, changes deploy automatically

Technologies

• React 19
• TypeScript
• Mantine UI
• Vite
• Redux Toolkit
• React Query
• React Router
• Plotly.js for visualisations