A local-first personal finance app
Added Dev Container (#1023)
jonezy3554c8d5b7b89c
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex d090e7a4e2..dbfb038ce1 100644--- a/CONTRIBUTING.md+++ b/CONTRIBUTING.md@@ -32,3 +32,15 @@ We welcome all contributions from the community. If you have an idea for a featuIf you do not have ideas what to build: the issue list is always a good starting point. Look for issues labeled with "[help wanted](https://github.com/actualbudget/actual/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)".For first time contributions you can also filter the issues labeled with "[good first issue](https://github.com/actualbudget/actual/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)".+++## Development Environment+If you would like to contribute you can fork this repository and create a branch specific to the project you are working on.++There are two options for developing:+1. Yarn+ - This is the traditional way to get an envrionment stood up. Run `yarn` to install the dependencies followed by `yarn start:browser` to start the development server. You will then be able to access Actual at `localhost:3001`.+2. Docker Compose+ - If you prefer to work with docker containers, a `docker-compose.yml` file is included. Run `docker compose up -d` to start Actual. It will be accessible at `localhost:3001`.++Both options above will dynamically update as you make changes to files. If you are making changes to the front end UI, you may have to reload the page to see any changes you make.diff --git a/Dockerfile b/Dockerfilenew file mode 100644index 0000000000..afa01e9b83--- /dev/null+++ b/Dockerfile@@ -0,0 +1,11 @@+###################################################+# This Dockerfile is used by the docker-compose.yml+# file to build the development container.+# Do not make any changes here unless you know what+# you are doing.+###################################################++FROM node:16-bullseye as dev+RUN apt-get update -y && apt-get upgrade -y && apt-get install -y openssl+WORKDIR /app+CMD ["sh", "./docker-start.sh"]diff --git a/docker-compose.yml b/docker-compose.ymlnew file mode 100644index 0000000000..566adbf2f0--- /dev/null+++ b/docker-compose.yml@@ -0,0 +1,16 @@+###################################################+# This creates and stands up the development+# docker container. Depends on the Dockerfile and+# docker-start.sh files.+###################################################++services:+ actual-development:+ build: .+ image: actual-development+ ports:+ - '3001:3001'+ volumes:+ - '.:/app'+ restart: no+diff --git a/docker-start.sh b/docker-start.shnew file mode 100644index 0000000000..a8f991a20a--- /dev/null+++ b/docker-start.sh@@ -0,0 +1,13 @@+#####################################################+# This startup script is used by the docker container+# to check if the node_modules folder is empty and+# if so, run yarn to install the dependencies.+#####################################################++#!/bin/sh++if [ ! -d "node_modules" ] || [ "$(ls -A node_modules)" = "" ]; then+ yarn+fi++yarn start:browserdiff --git a/upcoming-release-notes/1023.md b/upcoming-release-notes/1023.mdnew file mode 100644index 0000000000..3d9a37ca31--- /dev/null+++ b/upcoming-release-notes/1023.md@@ -0,0 +1,6 @@+---+category: Features+authors: [jonezy35]+---++Created development docker container