Docker Development Environment

1. Initial Setup

First, you'll need to install Docker. You can download it from Docker's website.

You'll also need Just, the command runner we use for every shortcut in the justfile. Install it with your package manager — for example brew install just on macOS — or follow the installation instructions for other platforms.

Once both are installed, create a new directory for your project:

2. Configuration Files

Look in the examples directory of the LocoMotion repository for these basic configuration files:

Copy these files into your project directory. Your directory structure should look like this:

~/Development
└── mycompany
    └── myproject
        ├── Dockerfile
        ├── justfile
        ├── dev
        │   └── Dockerfile
        ├── docker-compose.yml
        └── entrypoint.sh

3. Starting the Development Environment

With these files in place, you can now start your development environment:

Next: Create Your App

With the containers built and a shell open via just dev-shell, your development environment is ready — consistent across any OS, simple to debug, and isolated from your host system's dependencies.

From here, the Rails Setup guide picks up exactly where this one leaves off: creating the Rails app with rails new, configuring the database, and applying the LocoMotion-recommended setup (UUIDs, HAML, DaisyUI, and more).