Project Structure
Overview of the folder structure for the SolidX Fullstack Application.
This project is organized into a backend API (solid-api) and frontend UI (solid-ui) along with supporting scripts and configurations.
.
├── .vscode/ # VS Code settings
├── solid-api/ # Backend API (NestJS)
├── solid-ui/ # Frontend UI (Next.js)
└── upgrade.sh # SolidX upgrade scriptsolid-api/ - Backend (NestJS & TypeORM)
This folder contains all backend services, business logic, and configurations.
solid-api/
├── .env, .gitignore, etc. # Config and ignore files
├── logs/ # Application / Error logs
├── media-files-storage/ # Uploaded or generated files
├── media-uploads/ # Temporary upload folder
├── module-metadata/ # Module metadata (JSON)
├── src/ # Source code for the backend
├── test/ # E2E tests
├── rebuild*.sh / refresh.bat # Rebuild and refresh scriptsNotable Subfolders
src/- Contains
main.ts(entry point for the SolidX backend) and all SolidX modules likefees-portal/ main-cli.ts— entry point for the SolidX CLI commandsapp.module.ts— contains the application module configurationapp-default-database.module.ts— contains all the database configuration
- Contains
SolidX Dependencies
@solidstarters/solid-core— contains the core SolidX module which provides the core backend services for SolidX@solidstarters/solid-code-builder— contains the functionality for generating the code in the SolidX backend
SolidX Modules
A SolidX module is a logical container that groups together related models and functionality under a unified domain or feature area (e.g., fees-portal).
You can find the structure for a SolidX module here: Generated Code
solid-ui/ - Frontend (Next.js & Prime React)
The frontend is built using Next.js and Prime React components.
solid-ui/
├── .env, .gitignore # Config / ignore files
├── .next/ # Next.js build output
├── app/ # App Router pages (e.g., admin, auth)
├── public/ # Static assets like icons and SVGs
├── redux/ # Global Redux store config
├── types/ # TypeScript type declarations
├── next.config.js # Next.js configuration
├── middleware.ts # App-wide config and middlewaresNotable Subfolders
app/— entry point for routes like/admin,/auth, etc. Layout and providers vialayout.tsxandGlobalProvider.tsxpublic/— contains static files and theme assetsredux/— global state configuration
SolidX Dependencies
@solidstarters/solid-core-ui— contains the core UI components for the SolidX UI
Debugging - VS Code
Contains editor-specific configurations like launch.json for debugging and IDE behavior.
Upgrade Scripts
upgrade.sh: Used for upgrading the core SolidX backend/frontend dependencies.
Tip: All environment variables are stored in
.envfiles within each app folder.