Getting Started
Install your first DrupalReady template in minutes.
Prerequisites
Before you begin, make sure you have the following installed:
- PHP 8.3 or higher with required extensions (gd, xml, mbstring, curl, zip)
- Composer 2.x — the PHP dependency manager
- Lando or DDEV — for local development environments
- Node.js 20+ — for theme asset compilation
- Git — for version control
Step 1: Create Your Project
Choose a template and create your project with Composer:
# For agency/business sites composer create-project drupalready/starter-business my-site
# For government/education sites composer create-project drupalready/starter-government my-site
# For nonprofit/healthcare sites
composer create-project drupalready/starter-nonprofit my-site
`
This downloads Drupal 11, all required modules, the custom theme, and configuration.
Step 2: Start Local Development
Navigate to your project and start the local environment:
cd my-site lando start
This spins up PHP, MariaDB, and all required services. Your site will be available at the URL shown in the terminal output.
Step 3: Install Drupal
Install Drupal with the exported configuration:
lando drush site:install --existing-config -y
This creates the database, applies all configuration, and sets up the admin account.
Step 4: Apply Recipes
Apply the base recipe to configure content types, views, and permissions:
lando drush recipe recipes/base
You can also apply optional recipes for specific features like blog, portfolio, or commerce.
Next Steps
Your site is now running! Log in at /user/login with the credentials shown in the terminal. From here you can:
- Customize the theme in `web/themes/custom/`
- Modify content types and fields via the Drupal admin UI
- Read the Customization Guide for deeper changes
- Read the Deployment Guide when you're ready to go live