ChapterX — Setup Instructions

Clone the Repository from !Github, with command git clone https://github.com/kristina/chapterx.

Project Structure

chapterX/
├── chapterx-frontend/        # React + TypeScript frontend
├── ChapterX.API/             # ASP.NET Core Web API
├── ChapterX.Application/     # Application layer (MediatR)
├── ChapterX.Domain/          # Domain entities & interfaces
└── ChapterX.Infrastructure/  # EF Core, repositories

Database

Before starting the applications, a new database needs to be created and populated with the tables required for the application to work properly.

To create and populate the tables, run the ddl.sql and dml.sql scripts in an appropriate environment such as DBeaver, pgAdmin 4, or similar.

Backend

Start the backend

cd ChapterX.API

# Copy the example config and fill in your database credentials and JWT key
cp appsettings.Development.json.example appsettings.Development.json

# Run the backend
dotnet run --project ChapterX.API

The application should be available at ​https://localhost:7125.

Frontend

Start the frontend

cd chapterx-frontend

# Install dependencies and start the app
npm install
npm run dev

The application should be available at ​http://localhost:5173.