Nick Moreton Blog

This is a copy of my blog site, which is built using Wagtail CMS. It's derived from my Wagtail Starter Kit.

Features

• Docker Development Environment
• Postgresql, Mysql or Sqlite3 Database
• Frontend Node SASS and Javascript compilation
• Pico CSS for almost classless styling
• esbuild javascript bundler
• Wagtail CMS v6.3

Requirements

Required:

• Python >= 3.10 (developemnt and deployment)
• Docker (for local development)
• Docker Compose (for local development)
• Node.js (for frontend build tools) (for frontend build tools in development)

Optional:

• Git (optional, for version control)
• Make (optional, for running commands)
• NVM (optional, for managing Node versions)
• pre-commit (optional, for running code checks)
• UV (optional, for managing Python dependencies)

Getting started

1. Clone this repository https://github.com/wagtail-examples/nickmoreton to a location on your computer
2. Change into the project directory
3. Run make build to build the Docker containers
4. Run make up to start the Docker containers
5. Run make migrate to apply database migrations
6. Run make superuser to create a superuser
7. Run make run to start the Django development server

Quick start

There is a make command to run most of the steps above in one go:

make quickstart

You'll need to run make superuser separately.

If you haven't made changes to the configuration the app will have available the following services for use in development:

• Use sqlite as the database
• A mail utility will be available at http://localhost:8025
• A database management utility will be available at http://localhost:8080

Working with the fronend

The project uses Pico CSS for styling. It's a minmal setup that you can build on.

When you first run the project you may notice that no styling is applied. This is because the first time you run the project with make up the compiled frontend files might not be available. Just run the frontend build script and refresh the page. Read on

Working with the backend

The project uses Docker for local development. The Wagtail project is in the app directory. The project is set up to use a SQLite database by default. You can change this to use Mysql or Postgres. Read on

View the site

The site will be available at http://localhost:8000.

The Wagtail admin interface will be available at http://localhost:8000/admin.

Deployment

WIP for heroku deployment

Contributing

If you have any suggestions or improvements, please open an issue or a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.