Local Setup

DIGIT UI – CCRS (Citizen Complaint Resolution System)

Overview

A React App built on top of DIGIT UI Core — India’s largest governance platform. The CCRS UI lets citizens raise complaints and employees manage them. It uses the Workbench module to manage Master Data (MDMS V2) and Localisation data.


📂 Project Structure (Simplified)

graphqlCopyEditCitizen-Complaint-Resolution-System/
└── frontend/
    └── micro-ui/
        └── web/
            └── micro-ui-internals/
                ├── example/
                ├── node_modules/
                ├── packages/
                │   ├── css/        # Tailwind CSS config & styles
                │   ├── modules/
                │   │   ├── pgr/    # Public Grievance Redressal module (PGR forms/UI)

🛠 Tech Stack

  • React (UI framework)

  • React Hook Form (form handling)

  • React Query (API data fetching)

  • Tailwind CSS (styling)

  • Webpack (bundler)


🔗 External Dependencies

Package
Source Repo
Branch

@egovernments/digit-ui-libraries

digit-ui-libraries

develop

@egovernments/digit-ui-module-core

digit-frontend

develop

@egovernments/digit-ui-react-components

digit-frontend

develop

@egovernments/digit-ui-svg-components

digit-frontend

develop

@egovernments/digit-ui-module-utilities

digit-frontend

develop

@egovernments/digit-ui-components

digit-ui-libraries

develop


🚀 Run Locally – Step-by-Step

Pre-requisites

  • Node.js v14.18 (Use nvm to manage versions)

  • Yarn (preferred over npm)

Install Yarn if not available:

npm install -g yarn

Set Node version:

nvm install 14
nvm use 14

Steps

1. Clone the Repository

git clone https://github.com/egovernments/Citizen-Complaint-Resolution-System.git

2. Navigate to Project Directory

cd frontend/micro-ui/web/micro-ui-internals

3. Install Dependencies

yarn install

4. Configure Environment Variables

Create .env inside:

micro-ui/web/micro-ui-internals/example/.env

Required Variables:

iniCopyEditREACT_APP_PROXY_API=<server-url>
REACT_APP_GLOBAL=<server-url>
REACT_APP_PROXY_ASSETS=<server-url>
REACT_APP_USER_TYPE=EMPLOYEE   # or CITIZEN
SKIP_PREFLIGHT_CHECK=true

5. Start the Development Server

yarn start

Access the app in your browser (usually http://localhost:3000).


📄 License

Licensed under MIT License – free to use, modify, and distribute.


Last updated

Was this helpful?