Getting Started

Prerequisites

• .NET 8 SDK
• Docker Desktop (for PostgreSQL)

Installation

1. Clone the repository

   git clone https://github.com/baryodev/barakoCMS.git
   cd barakoCMS

2. Start the Database

   docker-compose up -d

3. Run the Application

   cd barakoCMS
   dotnet run

   The API will be available at http://localhost:5000 (or configured port).

First Steps

1. Access Swagger UI: Go to http://localhost:5000/swagger to explore the API.
2. Authenticate: Use the default admin credentials (if configured) or the seeded users from the AttendancePOC.
   • SuperAdmin: See appsettings.json or console output.
   • HR Manager: hr_manager / HRPassword123!
   • Standard User: john_viewer / UserPassword123!

Building a Frontend

BarakoCMS is headless-first. We provide a Next.js Starter Kit to get you up and running quickly.

Using the Starter Kit

1. Navigate to the examples directory:

   cd examples/nextjs-starter

2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

4. Open http://localhost:3000. It will connect to your local BarakoCMS backend (http://localhost:5005) to fetch content.