Chasqui Frontend

Chasqui is a lightweight, modular CMS and server. This repository contains the Frontend component, built with Astro.

Note: This is the companion to the Chasqui Server (backend). The frontend relies on the server to provide content via its API and to trigger site rebuilds via the internal webhook.

The frontend's build process is designed to consume data from the backend's modular API and generate a static site by fetching data from the Pages module.

The frontend is built with a focus on speed, simplicity, and delivering the smallest possible payload to the client.

Note: This project is very early in development.

Installation

The deployment environment is designed to be "ready-to-run" and performs no building locally (Prerequisites: Docker (desktop is NOT required), Docker Compose, and Git).

Note: If you are unable to run the container in your specific environment, please open an issue in the repository!

1. clone the repository:

   git clone https://github.com/aur9ra/chasqui-frontend.git
   cd chasqui-frontend

2. start the frontend:

   export GITHUB_USER=aur9ra
   ./run-frontend.sh

Common Docker Commands

• view logs: docker compose -f docker-compose.deploy.yml logs -f
• check status: docker ps
• stop containers: docker compose -f docker-compose.deploy.yml stop
• shutdown & remove containers: docker compose -f docker-compose.deploy.yml down
• restart containers: docker compose -f docker-compose.deploy.yml restart
• update image: ./run-frontend.sh (Pulls latest and restarts)

---

Local Development (Build Mode)

If you'd like to build the container yourself or run the frontend without Docker, please refer to BUILD.md.