Repository Structure

Pyxis CMS consists of two separate repositories, ensuring complete isolation between the backend and frontend.

1. Backend (pyxis-cms)

The core repository responsible for data management and the admin panel.

• app/Filament/ – Admin panel resource configurations (forms, tables, actions).
• app/Http/Controllers/Api/ – Controllers handling frontend requests.
• app/Http/Resources/ – Mapping database models to a standardized JSON format.
• app/Models/ – Data models (Page, Setting, User) with UUID, logic and methods.
• database/ – PostgreSQL migrations and seeders.
• storage/app/public/ – Main folder for media and user-uploaded files.

2. Frontend Starters (pyxis-view-*)

Starter repositories for the presentation layer (e.g., Astro, Next.js).

• src/pages/ – Route definitions and endpoints for preview and revalidation.
• src/components/ – Visual component library (blocks, UI, sections).
• src/layouts/ – Main page templates (e.g., BaseLayout).
• public/ – Static frontend assets (icons, fonts).