README

DXPR CMS is a powerful and enhanced version of Drupal 10, incorporating some of the best modules and themes available. It is designed to help you quickly set up and start building your site. Unlike traditional distributions, DXPR CMS utilizes the Drupal recipe system, ensuring flexibility and ease of customization.

Getting started with DXPR CMS

Follow these steps to install DXPR CMS:

1. Install DDEV if you haven't already.

2. Clone the DXPR CMS repository:

   git clone https://github.com/dxpr/dxpr_cms.git

3. Navigate to the project directory:

   cd dxpr_cms

4. Configure and start the DDEV environment:

   ddev config --project-type=drupal11 --database=mariadb:11.4 --docroot=web
   ddev start
   ddev composer install

5. Complete the installation using one of these methods:

   Option A: Web-based installation Open your browser and navigate to http://dxpr-cms.ddev.site or https://dxpr-cms.ddev.site to access the Drupal installation wizard. During installation, you can select optional recipes (Case Studies, Events, Forms, Analytics, News, SEO Tools) to customize your site.

   Option B: AI-assisted installation (Claude Code) The repo includes a built-in AI skill that walks you through the full installation interactively -- language selection, recipes, API key, and more. Install Claude Code, then from the project root:

   claude

   Once Claude starts, type "install DXPR CMS" and follow the prompts. The skill is auto-detected from .claude/skills/dxpr-install/.

   Power users: To use the skill from anywhere (without cloning first), install it globally:

   mkdir -p ~/.claude/skills/dxpr-install && curl -sL \
     https://raw.githubusercontent.com/dxpr/dxpr_cms/1.x/.claude/skills/dxpr-install/SKILL.md \
     -o ~/.claude/skills/dxpr-install/SKILL.md

   Then run claude from any directory and type "install DXPR CMS".

   Option C: Command-line installation with API key For automated installation with your DXPR Builder API key:

   ddev drush site-install dxpr_cms_installer \
     dxpr_cms_installer_keys.dxpr_key='YOUR_DXPR_API_KEY' -y

   Replace YOUR_DXPR_API_KEY with your actual DXPR Builder product key from app.dxpr.com/getting-started.

   Option D: Command-line installation with recipes You can select optional recipes during command-line installation, mirroring the options available in the web-based installer. Use pipe-separated recipe names with the installer_recipes_form.add_ons parameter:

   ddev drush site-install dxpr_cms_installer \
     "installer_recipes_form.add_ons=Case Studies|Events|Forms|Google Analytics|News|SEO Tools|Multilingual" \
     site_name='My Site' \
     dxpr_cms_installer_keys.dxpr_key='YOUR_DXPR_API_KEY' -y

   Available recipes: Case Studies, Events, Forms, Google Analytics, News, SEO Tools, Multilingual.

   To install with all optional recipes, use *:

   ddev drush site-install dxpr_cms_installer \
     "installer_recipes_form.add_ons=*" \
     dxpr_cms_installer_keys.dxpr_key='YOUR_DXPR_API_KEY' -y

   When including the Multilingual recipe, you can also specify additional languages:

   ddev drush site-install dxpr_cms_installer \
     "installer_recipes_form.add_ons=Case Studies|Events|Multilingual" \
     "dxpr_cms_installer_multilingual_configuration.additional_languages.nl=nl" \
     "dxpr_cms_installer_multilingual_configuration.additional_languages.ar=ar" \
     dxpr_cms_installer_keys.dxpr_key='YOUR_DXPR_API_KEY' -y

   Installing optional recipes after installation If you want to add recipes later, install them manually:

   ddev drush recipe ../recipes/dxpr_cms_case_study
   ddev drush recipe ../recipes/dxpr_cms_events
   ddev drush recipe ../recipes/dxpr_cms_forms
   ddev drush recipe ../recipes/dxpr_cms_news
   ddev drush recipe ../recipes/dxpr_cms_multilingual
   ddev drush recipe ../recipes/dxpr_cms_google_analytics
   ddev drush recipe ../recipes/dxpr_cms_seo_tools

AI Coding Assistant Integration

DXPR CMS includes built-in Agent Skills files that teach AI coding assistants how to install, configure, and manage your site through natural language.

Example -- building a Case Studies section from scratch:

1. "Create a case_study content type with fields for client name, industry, challenge, solution, and results"
2. "Create a view showing case studies as a card grid, filterable by industry"
3. "Build a case study detail page template with a hero section and sidebar stats"
4. "Add Case Studies to the main menu after About Us"

The AI assistant handles the entire workflow -- content types, fields, views, page layout, and navigation -- through conversation.

Quick Setup

After installing DXPR CMS, enable AI assistant support:

drush dxb:setup-ai    # Page builder
drush dxt:setup-ai    # Theme settings
drush rl:setup-ai     # A/B testing
drush wm:setup-ai     # Site management

Compatible with Claude Code, Codex CLI, Gemini CLI, GitHub Copilot, Cursor, and other tools supporting the Agent Skills standard.

Compatible with Claude Code, Codex CLI, Gemini CLI, GitHub Copilot, Cursor, and other tools supporting the Agent Skills standard.

Future-proof your digital strategy with scalable tools for efficient content management

Welcome to DXPR CMS, a dynamic Drupal distribution that simplifies complex content management challenges. Designed to enhance productivity, ensure data security, and leverage the potential of AI, this platform integrates tools like DXPR Builder and DXPR Theme, alongside cutting-edge AI modules to empower users, streamline workflows, and reduce operational costs.

Key features of DXPR CMS

DXPR Builder: empowering content management

DXPR Builder is an intuitive drag-and-drop page builder that allows users of all technical levels to create engaging, mobile-responsive web pages effortlessly. While it does not yet integrate AI features, it remains a key part of our CMS, streamlining content creation and management with minimal backend involvement.

DXPR Theme: simplifying customization

The DXPR Theme offers a visual interface that enables developers to swiftly align site design with organizational branding guidelines. Although it doesn't yet feature AI integrations, it minimizes time spent on styling and enhances site functionality, promoting consistent brand identity across digital assets.

AI-first features: a new approach to content management

DXPR CMS distinguishes itself by offering AI-powered assistance directly within the user interface. Unlike other platforms that rely on cramped sidebars or popup tools, we make AI a central part of the content creation experience. Our AI modules enhance productivity and usability without distraction.

AI-enhanced content management modules

AI Image Alt Text

The AI Image Alt Text module automatically generates alt texts for images using AI vision models. Integrated with image widgets, it exposes a button for authorized users to generate alt texts, supporting alt text creation in the language of the entity.

AI Views Sorting (coming soon)

The AI Views Sorting module introduces an AI-based sorting plugin for Drupal Views. Using the UCB2 algorithm, it ranks and displays content dynamically based on user engagement metrics. This feature will be a powerful tool for improving content relevance and discovery over time.

Analyze Module (coming soon)

The Analyze Module provides an API framework for adding content-related information to Drupal entities. Its "Analyze" tab serves as a unified interface where other modules can display their analysis results.

AI Security Analyze (coming soon)

AI-powered security analysis helps detect in-content security threats such as malicious links or PII disclosure. By scanning content in real-time, this module mitigates risks during the content creation process and enhances overall security.

AI Sentiments Analysis (coming soon)

The AI Sentiments Analysis feature provides real-time content analysis to identify emotional tones such as joy, anger, or neutrality. This will allow content editors to gauge the emotional impact of their content and make adjustments accordingly.

AI CKEditor Assistant (coming soon)

The AI CKEditor Assistant will introduce generative AI capabilities into CKEditor via a slash command interface. Users will be able to prompt the AI to generate content, perform corrections, or provide enhancements -- all within the CKEditor environment. This tool will make content creation faster and smarter.

Technical advantages

Developer and site builder tools

DXPR CMS is equipped with a comprehensive suite of tools that enhance site functionality and allow for deep integration with existing systems. Extensive API support and customizable modules facilitate adoption and provide continuous technical support. With upcoming AI modules, developers and site builders will find it even easier to configure and optimize AI-driven functionalities.

Enhanced security

Our platform incorporates robust security protocols from the start, using built-in modules and best practices to safeguard against emerging threats. The AI security analysis feature adds an extra layer of protection, identifying risks in real-time and ensuring your content remains secure and compliant.

Multilingual and localization support

DXPR CMS excels in managing multilingual content, including complex scenarios involving right-to-left (RTL) languages. Features include:

• Full RTL language support: Ensures that text, layout, and user interfaces adapt seamlessly for RTL languages.
• Sophisticated language navigation tools: Enables easy switching between languages while maintaining user context.
• Localized user experiences: Automatically adjusts date formats, currency, and form validations to match local preferences.
• Integration with leading translation services: Supports both automated and manual translation workflows to ensure content accuracy and relevance.

Community and support

Join the DXPR CMS community to connect with developers, share insights, and collaborate on projects. Our forums are an invaluable resource for support and staying updated with the latest developments.

Case studies and success stories

Explore how diverse organizations utilize DXPR CMS to enhance their online presence. Our case studies demonstrate the practical applications and significant impacts of our distribution on digital strategies.

Innovative Contributions to Drupal

Pushing Boundaries in Drupal

DXPR CMS integrates open-source flexibility with enhanced features through our open core DXPR Builder. While DXPR Builder and DXPR Theme do not yet have AI capabilities, DXPR is actively contributing to Drupal's innovation with a suite of AI-first modules. These include AI Image Alt Text, AI Views Sorting, AI Sentiments Analysis, AI Security Analyze, and the upcoming AI CKEditor Assistant, among others.

Community Collaboration

Strengthening Drupal Together:
We invite the Drupal community to collaborate on DXPR CMS, enhancing both our platform and the broader ecosystem. By contributing to the open-source core and sharing advancements, we empower users and developers to join us in shaping a forward-thinking digital landscape.