Chapter I
Introduction
Artisan CMS is a premium content management platform designed for publishers, luxury brands, and editorial teams who demand excellence in every detail of their digital presence.
Table of Contents
Philosophy and Design Principles
Artisan was conceived with the belief that content management should be an act of craftsmanship, not compromise. Every interface, every workflow, and every API endpoint has been considered with the care of a master artisan shaping their finest work.
The platform separates content structure from presentation through a modular architecture. Content models define the shape of your data. Templates control the visual rendering. Workflows govern the editorial process from draft through review to publication.
“The details are not the details. They make the design.” — Charles Eames
Artisan ships with zero assumptions about your content. There are no default post types, no mandatory taxonomies, and no prescribed URL structures. You begin with a blank canvas and compose exactly the content architecture your project demands.
Architecture Overview
The Artisan runtime comprises four layers: the Content Layer stores structured data in a versioned document store with full revision history. The Media Layer handles asset ingestion, transformation, and delivery via a built-in CDN. The Presentation Layer renders content through a Twig-based templating engine with inheritance and partials. The API Layer exposes all functionality through RESTful and GraphQL endpoints.
Content Layer
Versioned document store with field-level diffing, branch-based editing, and merge conflict resolution for collaborative workflows.
Media Layer
On-the-fly image transformations, responsive breakpoint generation, and WebP/AVIF conversion with global CDN distribution.
Presentation Layer
Twig-based templating with layout inheritance, reusable partials, and a live preview mode that renders changes in real time.
API Layer
RESTful and GraphQL endpoints with fine-grained permissions, cursor-based pagination, and webhook integrations for external systems.
Configuration Reference
The display name of your Artisan installation, shown in the admin panel header and default meta tags.
Maximum number of content revisions retained per entry. Set to -1 for unlimited history. Default: 50.
Maximum file upload size. Accepts values like '50MB' or '1GB'. Applies to all media types uniformly.
Base URL for the CDN origin server. All media assets are served through this endpoint with automatic cache headers.
Session duration in seconds for admin panel users. Default: 86400 (24 hours).
Require multi-factor authentication for all admin users. Default: false. Recommended for production.
Maximum API requests per minute per authenticated client. Default: 300.