README

This project provides a ready-to-use DDEV environment, Craft CMS configuration, and a prebuilt content builder to accelerate development across Craft-based projects.

🧭 Overview

The Craft Starter Project serves as a baseline for all new Craft CMS projects. It includes a minimal setup with core sections, a content builder, and an optimized DDEV workflow. You can install it directly from Packagist using Composer — cloning the GitHub repository is not required.

⚙️ Requirements

Before you begin, make sure you have:

Docker
DDEV
PHP ≥ 8.2
Composer ≥ 2.x

🏗️ Installation

Follow the steps below to create and configure a new Craft CMS project using the starter pack.

1. Create a new project directory

mkdir my-craft-site && cd my-craft-site

2. Configure DDEV for Craft CMS

ddev config --project-type=craftcms --docroot=web
ddev start

3. Create a new project from the package

composer create-project "developion/craft:dev-master"

💡 Always use the Packagist package instead of cloning the GitHub repository.

4. Follow the CLI setup

During installation, the CLI will guide you through:

Database configuration
Admin user setup
Site name and URL
Initial environment setup

🔧 Environment Configuration

After the installation, open the generated .env file and ensure it includes the following values:

DISALLOW_ROBOTS=true
CP_TRIGGER=admin
ALLOW_ADMIN_CHANGES=true
DEV_MODE=true
ACTION_TRIGGER=actions

These variables configure the control panel trigger, development mode, and prevent indexing in local environments.

🧑‍💻 Local Development

Launch the project

ddev launch

You’ll see a blank homepage — this is expected for a clean starter setup.

Access the admin panel

https://your-project-name.ddev.site/admin

Once logged in, you can start building your site structure, fields, and templates.

🧩 Project Structure

The starter pack comes with a preconfigured Craft setup:

Area	Description
Home Page	Single section ready for customization
Pages Channel	Fully working channel for standard pages
Content Builder	Includes 6 flexible block types for modular content

You’re free to add, remove, or modify everything to match your project needs.

🎨 Frontend Development

Building Assets

When you have installed the project, you also need to install Node modules for asset building.

Install Node modules
In the root of your project, run:
```
ddev npm ci
```
Work with CSS
Every time you work with CSS or make frontend changes, run:
```
ddev npm run dev
```
Explore other commands
You can view the rest of the available frontend commands in the gulpfile.js file.

🗂️ Example Directory Structure

craft-starter-project/
├── config/
│   ├── general.php
│   ├── db.php
│   └── routes.php
├── modules/
│   └── app/
├── templates/
│   ├── _layouts/
│   ├── _partials/
│   └── index.twig
├── web/
│   ├── index.php
│   └── cpresources/
├── composer.json
├── gulpfile.js
├── package.json
├── ddev/
└── .env

🧰 Useful Commands

Command	Description
`ddev start`	Start the DDEV containers
`ddev stop`	Stop all running DDEV containers
`ddev launch`	Open the site in your default browser
`ddev ssh`	Access the web container shell
`composer install`	Install dependencies
`composer update`	Update dependencies
`ddev npm ci`	Install Node modules
`ddev npm run dev`	Build frontend assets in development mode

✨ Features

⚡ Preconfigured Craft CMS 4+ setup
🧱 Content builder with 6 flexible block types
🧩 Working Pages channel and Home single section
🐳 DDEV-based Docker environment for local development
🎨 Frontend build pipeline with npm and Gulp
🔐 Ready .env configuration for local or staging environments
🪶 Lightweight structure — easy to extend or customize

📦 Package Information

GitHub Repository:
https://github.com/developion/craft-starter-project
Packagist Package:
https://packagist.org/packages/developion/craft

Use the Packagist package to install the latest stable or development version.

developion / craft

Maintainers

Details