Europa Museum — Craft CMS Demo

Overview

Europa is a fictitious art museum website build with Craft CMS. This repository houses the source code for our demo, which you can try for yourself by visiting craftcms.com/demo.

We’ve also included instructions below for setting up the demo in a local development environment with Docker Compose and DDEV.

Europa shows off many of Craft’s core features and includes some popular plugins to spark your curiosity.

Development Technologies

• Craft CMS 5.x
• PHP 8.2
• PostgreSQL 13
• Native Twig templates
• Built on the Yii 2 framework

Read more about Craft’s technical requirements in the official documentation.

Front End Dependencies

Europa’s front-end was built with modern Javascript and CSS tools. Craft itself has no rules about how you structure your front-end code—so we’ve taken the opportunity to share a handful of techniques that couple Twig templates with front-end interactivity.

• Babel with ES6
• Sass
• Laravel Mix with PurgeCSS and Critical CSS
• Highway.js
• GSAP
• Lazysizes
• LocomotiveScroll

Local Development

This repository is ready to use with DDEV and Docker Compose.

Tip

If you’re using a different local environment, see Craft’s Server Requirements and Installation Instructions.

DDEV

DDEV is our recommended local development environment, for Craft developers at any level of experience. Our quick-start guide covers this process in detail—but we’ve done the config for you, so all that’s required is…

git clone https://github.com/craftcms/europa-museum.git
cd europa-museum
ddev start
ddev composer install
ddev import-db < seed.sql
ddev craft setup/security-key

As with the vanilla Docker setup process, you can create a user for yourself with the CLI:

ddev craft users/create --admin
# ...
ddev launch admin

Docker Compose

We test demo projects in automated pipelines, so the project is ready to go if you have Docker Compose installed! The Makefile contains all the steps to boot up the project:

# Create containers and install dependencies:
make init
# Restore the bundled database backup:
make restore

You can use the CLI to create a new user, as well:

docker-compose exec web php craft users/create --admin

Tip

Visit the control panel in your running project http://localhost:8080/admin!

Front End

Run npm install with Node.js 14.15.0 or later.

Tip

DDEV users can run npm commands within the application container, via ddev npm ...!

These development scripts are available in package.json:

• npm run watch to watch and automatically recompile assets for local development
• npm run sync to watch files and reload with BrowserSync for local development
• npm run dev to compile assets for local development
• npm run prod to compile optimized assets for production

If you use a different site URL, update DEFAULT_SITE_URL in .env or the production build process will fail:

DEFAULT_SITE_URL=https://europa.ddev.site

License

The source code of this project is licensed under the BSD Zero Clause License unless stated otherwise.

The imagery used by this project is the property of each respective license holder. You are not free to use it for your own projects.