Installation and run

Table Of contents

  1. Stack
  2. To do it manually
    1. Requirements
    2. Installation
    3. Run
    4. Build
  3. To do it via docker
    1. Requirements
    2. Run
    3. Build
  4. Demo Access

This page may require some additional info about backend and might not be fully covered, because all of it’s current content was based on Fronted README.md.

Stack

  • React 18
  • Vite
  • TypeScript
  • Tailwind CSS
  • React Router
  • Axios with baseURL: /api
  • i18next + react-i18next
  • lucide-react icons

To do it manually

Requirements

  • Node.js 20+ recommended
  • npm

The project was last checked with Node 24.14.1.

Installation

Clone the repo and cd into project:

git clone https://github.com/novAIcariusQ/Cebola-Frontend.git
cd Cebola-Frontend

Install:

npm install

If npm optional dependencies break on Windows, clean the install and run it again:

Remove-Item -Recurse -Force node_modules, package-lock.json
npm install

Run

npm run dev

Default local URL is http://localhost:3000

Vite proxies /api to http://localhost:3001

The proxy is configured in vite.config.ts.

Build

npm run build

This runs TypeScript checks and then vite build.

To do it via docker

Requirements

  • docker
  • docker-compose

You may also need to add your user to docker group and reboot your pc. You can follow for exmple this guide to install Docker on your system.

Run

Clone the repo and cd into project:

git clone https://github.com/novAIcariusQ/Cebola-Frontend.git
cd Cebola-Frontend

Run:

docker compose up

Build

docker build . -t cebola-frontend

Demo Access

Backend auth is not required for merchant frontend development. Open /login/sign-in and click Use local demo access; this stores a local frontend token and redirects to /merchant/shops.

The customer storefront is public and starts at /. It can use backend public endpoints or local demo data derived from merchant demo storage.