Introduction

Welcome to the official documentation for THLSPress, a modern, modular Content Management System (CMS) designed for high-performance web applications. Built with a powerful stack including Next.js, TypeScript, and Prisma, THLSPress provides a solid, scalable foundation that can be extended with powerful, feature-rich modules.

This documentation serves as a comprehensive guide for developers, contributors, and system administrators.

Project Philosophy

THLSPress is built upon a set of core principles that guide its architecture and development:

• Modularity First: The core CMS is intentionally lean and unopinionated. All significant functionalities, such as e-commerce or reservation systems, are implemented as self-contained, installable modules. This allows developers to build applications with only the features they need, ensuring optimal performance and a clean codebase.
• Superior Developer Experience (DX): The development environment is a first-class citizen. By leveraging a PNPM + Turborepo monorepo, we ensure blazing-fast dependency management, intelligent task caching, and a streamlined workflow that scales with the project's complexity.
• Seamless Extensibility: The system is engineered for growth. The thlspress-cli tool provides a robust, automated mechanism for adding modules. It intelligently handles file scaffolding, database schema modifications, and code injections, abstracting away the complexity of extending the system.
• End-to-End Type Safety: We embrace TypeScript across the entire stack—from the database schema with Prisma to the frontend components in React. This ensures code reliability, reduces runtime errors, and makes the codebase easier to maintain and refactor.

Core Concepts

• Monorepo (thlspress-cms): The entire project ecosystem resides in a single Git repository. This includes the core CMS application, the command-line interface (CLI), end-to-end tests, and all official module templates.
• Core CMS (/cms): A production-ready Next.js application utilizing the App Router. This is the foundational package that end-users deploy. It provides essential CMS functionalities like page building, user management, and media handling.
• Modules (/templates): Versioned, self-contained packages of features. Each module template contains the necessary application code (/app), database snippets (/prisma), and code modifications (/codemods) to integrate its functionality into the Core CMS.
• CLI (/packages/cli): A command-line tool, published to NPM and runnable via npx. Its primary role is to fetch module templates from a central repository (e.g., GitHub) and intelligently inject them into a user's THLSPress instance.