diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml index 84d0aab..19b2bf4 100644 --- a/docker-compose.dev.yml +++ b/docker-compose.dev.yml @@ -28,8 +28,13 @@ services: YAML_TEMPLATE: "config/oxford.yaml" command: "yarn dev" volumes: + - ./.material:/app/.material + - ./config:/app/config - ./components:/app/components + - ./lib:/app/lib - ./pages:/app/pages + - ./public:/app/public + - ./styles:/app/styles ports: - "3000:3000" links: diff --git a/docs/development/docker.md b/docs/development/docker.md index 4a7d017..223985d 100644 --- a/docs/development/docker.md +++ b/docs/development/docker.md @@ -40,3 +40,18 @@ value (under `services.gutenberg.build.args`) to a different config yaml file or changing `MATERIAL_METHOD` to `"copy"` to copy a locally checked out folder into the container at build-time instead of pulling fresh - for more details on how to pull material to edit locally follow the below section. + +## Local development with Docker + +`docker-compose.dev.yaml` configures a local development environment in Docker, +including Node and Yarn. It runs the app in development mode, so that you can make +changes to the code and see them on http://localhost:3000. + +```sh +# build the development image +docker compose -f docker-compose.dev.yaml build +# run the Next.js app on http://localhost:3000 in development mode +docker compose -f docker-compose.dev.yaml up +# shut down the app and database when you're finished +docker compose -f docker-compose.dev.yaml down +```