weaponsforge/todo-next repository overview

⁠todo-next

A monorepo containing the latest "local development" images of a typical TO-DO notes listing app built with NextJS and Redux Toolkit. It is a Docker template for client + server MERN app focusing on dev productivity for localhost development.

Live Preview
https://weaponsforge.github.io/todo-next/⁠

GitHub Repository
https://github.com/weaponsforge/todo-next⁠

⁠Basic Usage

1. Pull the "latest" client and server development images.

   docker pull weaponsforge/todo-next:client
   docker pull weaponsforge/todo-next:server
   

   Copy

2. Pull the public MongoDB image.
   docker pull mongo:4.4.6

3. Create .env files for the client and server.

   • Visit the client/README.md and server/README.md files of the todo-next⁠ GitHub repository for more information about the .env file contents.

4. Spin up the MongoDB container:
   docker run -d --name mongo -e MONGO_INITDB_ROOT_USERNAME=admin -e MONGO_INITDB_ROOT_PASSWORD=secret -e MONGO_INITDB_DATABASE=todo-next -p 27017:27017 mongo:4.4.6

5. Spin up the client and server containers with:

   docker run -it --rm -p 3000:3000 --env-file .env weaponsforge/todo-next:client
   docker run -it --rm -p 3001:3001 --env-file .env  --link mongo weaponsforge/todo-next:server
   

   Copy

6. Load the localhost website at:
   http://localhost:3000

⁠Usage with Docker Compose

1. Clone the todo-next⁠ repository.
   git clone https://github.com/weaponsforge/todo-next.git

2. Navigate to the cloned todo-next root project directory, then run:
   docker compose -f docker-compose.dev.yml pull

3. Set up the environment variables for the todo-next /client and /server directories.

   • Visit the client/README.md and server/README.md files for more information.
   • Take note of the .env variables setup for Windows and Linux to enable hot reload.

4. Run the development images.
   docker compose -f docker-compose.dev.yml up

5. Load the localhost website at:
   http://localhost:3000