Code Structure

Prax is organized into two main packages: frontend/ and backend/. Each has a modular, feature-oriented structure.

Root Layout

bashCopyEdit/prax
  ├── frontend/        # React-based visual builder
  ├── backend/         # Node.js flow engine + API
  ├── .env.example     # Sample environment config
  ├── docker-compose.yml
  └── README.md

---

Frontend Structure (React)

bashCopyEdit/frontend
  ├── components/       # Reusable UI elements (buttons, forms)
  ├── flows/            # Flow builder logic and canvas UI
  ├── pages/            # App routes (Next.js or Vite)
  ├── services/         # API clients and utility functions
  ├── hooks/            # Custom React hooks
  ├── themes/           # Light/dark mode settings and styles
  └── utils/            # Helpers and formatting functions

---

Backend Structure (Node.js)

bashCopyEdit/backend
  ├── api/              # Flow API, execution routes
  ├── nodes/            # Built-in and custom nodes
  ├── services/         # Memory, tools, model providers
  ├── database/         # DB connection and schema
  ├── flows/            # Flow loader, validator, and runner
  └── utils/            # Shared helpers