Update dockerbuild.release.yml

Update dockerbuild.prod.yml
v0.5.0 (#532 )
2026-02-24 16:53:12 -05:00 · 2021-06-16 22:27:25 -08:00 · 2021-06-16 22:27:09 -08:00 · 2021-06-16 21:35:06 -08:00 · 2021-06-13 10:36:38 -08:00 · 2021-04-21 20:08:14 -08:00
675 changed files with 43447 additions and 17144 deletions
--- a/.flake8
+++ b/.flake8
@@ -0,0 +1,6 @@
+[flake8]
+ignore = [
+    E501 # Line Length - See Black Config in pyproject.toml
+    E402 # Import Not at Top of File
+]
+exclude = _all_models.py
--- a/.github/workflows/dockerbuild.dev-docs.yml
+++ b/.github/workflows/dockerbuild.dev-docs.yml
@@ -0,0 +1,30 @@
+name: Docker Build Dev Docs
+
+on:
+  push:
+    branches:
+      - dev
+
+jobs:
+  push_to_registry:
+    name: Push Docker image to GitHub Packages
+    runs-on: ubuntu-latest
+    permissions:
+      packages: write
+      contents: read
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Log in to GitHub Docker Registry
+        uses: docker/login-action@v1
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Build container image
+        uses: docker/build-push-action@v2
+        with:
+          context: ./docs
+          push: true
+          tags: |
+            ghcr.io/${{ github.repository }}/dev-docs:latest
--- a/.github/workflows/dockerbuild.dev.yml
+++ b/.github/workflows/dockerbuild.dev.yml
@@ -44,6 +44,6 @@ jobs:
      #
      - name: build the image
        run: |
-          docker build --push \
+          docker build --push --no-cache \
            --tag hkotel/mealie:dev \
-            --platform linux/amd64,linux/arm/v7,linux/arm64 .
+            --platform linux/amd64,linux/arm64 .
--- a/.github/workflows/dockerbuild.prod.yml
+++ b/.github/workflows/dockerbuild.prod.yml
@@ -1,9 +1,8 @@
 name: Docker Build Production

 on:
-  push:
-    branches:
-      - master
+  release:
+    types: [published]

 jobs:
  build:
@@ -46,4 +45,4 @@ jobs:
        run: |
          docker build --push \
            --tag hkotel/mealie:latest \
-            --platform linux/amd64,linux/arm/v7,linux/arm64 .
+            --platform linux/amd64,linux/arm64 .
--- a/.github/workflows/dockerbuild.release.yml
+++ b/.github/workflows/dockerbuild.release.yml
@@ -53,4 +53,4 @@ jobs:
        run: |
          docker build --push \
            --tag hkotel/mealie:${{ steps.mealie_version.outputs.tag }} \
-            --platform linux/amd64,linux/arm/v7,linux/arm64 .
+            --platform linux/amd64,linux/arm64 .
--- a/.github/workflows/test-all.yml
+++ b/.github/workflows/test-all.yml
@@ -8,10 +8,23 @@ on:
    branches:
      - master
      - dev
+    types: [synchronize, opened, reopened, ready_for_review]

 jobs:
  tests:
+    env:
+      PRODUCTION: false
    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres
+        env:
+          POSTGRES_USER: mealie
+          POSTGRES_PASSWORD: mealie
+          POSTGRES_DB: mealie
+        options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5
+        ports:
+          - 5432:5432
    steps:
      #----------------------------------------------
      #       check-out repo and set-up python
@@ -30,25 +43,35 @@ jobs:
        with:
          virtualenvs-create: true
          virtualenvs-in-project: true
-      # #----------------------------------------------
-      # #       load cached venv if cache exists
-      # #----------------------------------------------
-      # - name: Load cached venv
-      #   id: cached-poetry-dependencies
-      #   uses: actions/cache@v2
-      #   with:
-      #     path: .venv
-      #     key: venv-${{ runner.os }}-${{ hashFiles('**/poetry.lock') }}
+      #----------------------------------------------
+      #       load cached venv if cache exists
+      #----------------------------------------------
+      - name: Load cached venv
+        id: cached-poetry-dependencies
+        uses: actions/cache@v2
+        with:
+          path: .venv
+          key: venv-${{ runner.os }}-${{ hashFiles('**/poetry.lock') }}
      #----------------------------------------------
      # install dependencies if cache does not exist
      #----------------------------------------------
      - name: Install dependencies
-        run: poetry install
+        run: |
+          poetry install
+          poetry add "psycopg2-binary==2.8.6"
        if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
      #----------------------------------------------
      #              run test suite
      #----------------------------------------------
-      - name: Run tests
+      - name: Run Test Suite
        run: |
-          source .venv/bin/activate
-          pytest mealie/tests/
+          make test-all
+      #----------------------------------------------
+      #              run test suite
+      #----------------------------------------------
+      - name: Run Test Suite Postgres
+        env:
+          DB_ENGINE: postgres
+          POSTGRES_SERVER: localhost
+        run: |
+          make test-all
--- a/.gitignore
+++ b/.gitignore
@@ -1,27 +1,20 @@
 # Byte-compiled / optimized / DLL files
 .env
-__pycache__/
+*__pycache__/
 *.py[cod]
 *$py.class
+
 # frontend/.env.development
 docs/site/
-mealie/temp/*
-mealie/temp/api.html
-.temp/
+*temp/*
+.secret
+frontend/dist/

-
-app_data/backups/*
-app_data/debug/*
-app_data/img/*
-app_data/migration/*
-
-#Exception to keep folders
-!mealie/dist/.gitkeep
-!app_data/backups/.gitkeep
-!app_data/backups/dev_sample_data*
-!app_data/debug/.gitkeep
-!app_data/migration/.gitkeep
-!app_data/img/.gitkeep
+dev/data/backups/*
+dev/data/debug/*
+dev/data/img/*
+dev/data/migration/*
+dev/data/users/*

 .DS_Store
 node_modules
@@ -90,6 +83,7 @@ coverage.xml
 *.cover
 .hypothesis/
 .pytest_cache/
+test.db

 # Translations
 *.mo
@@ -145,11 +139,13 @@ ENV/
 # mypy
 .mypy_cache/

-# IDE settings
-# .vscode/
-
 # Node Modules
 node_modules/
-mealie/data/debug/last_recipe.json
+*.db
 *.sqlite
-app_data/db/test.db
+scratch.py
+dev/data/backups/dev_sample_data*.zip
+!dev/data/backups/test*.zip
+dev/data/recipes/*
+dev/scripts/output/app_routes.py
+dev/scripts/output/javascriptAPI/*
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -1,22 +1,19 @@
 {
  "python.formatting.provider": "black",
  "python.pythonPath": ".venv/bin/python3.9",
-  "python.linting.pylintEnabled": true,
+  "python.linting.pylintEnabled": false,
  "python.linting.enabled": true,
-  "python.autoComplete.extraPaths": ["mealie", "mealie/mealie"],
-  "python.analysis.extraPaths": ["mealie", "mealie/mealie"],
-
  "python.testing.unittestEnabled": false,
  "python.testing.nosetestsEnabled": false,
  "python.testing.pytestEnabled": true,
  "python.testing.autoTestDiscoverOnSaveEnabled": false,
-  "cSpell.enableFiletypes": ["!javascript", "!python"],
-  "python.testing.pytestArgs": ["mealie"],
-  "i18n-ally.localesPaths": "frontend/src/locales",
+  "python.testing.pytestArgs": ["tests"],
+  "cSpell.enableFiletypes": ["!javascript", "!python", "!yaml"],
+  "i18n-ally.localesPaths": "frontend/src/locales/messages",
+  "i18n-ally.sourceLanguage": "en-US",
  "i18n-ally.enabledFrameworks": ["vue"],
  "i18n-ally.keystyle": "nested",
-  "cSpell.words": [
-    "performant"
-  ],
-  "search.mode": "reuseEditor"
+  "cSpell.words": ["compression", "hkotel", "performant", "postgres", "webp"],
+  "search.mode": "reuseEditor",
+  "python.linting.flake8Enabled": true
 }
--- a/.vscode/tasks.json
+++ b/.vscode/tasks.json
@@ -3,7 +3,7 @@
  "tasks": [
    {
      "label": "DEV: Build and Start Docker Compose",
-      "command": "./dev/scripts/docker-compose.dev.sh",
+      "command": "make docker-dev",
      "type": "shell",
      "args": [],
      "problemMatcher": ["$tsc"],
@@ -14,7 +14,7 @@
    },
    {
      "label": "Production: Build and Start Docker Compose",
-      "command": "./dev/scripts/docker-compose.sh",
+      "command": "make docker-prod",
      "type": "shell",
      "args": [],
      "problemMatcher": ["$tsc"],
@@ -24,31 +24,43 @@
      "group": "test"
    },
    {
-      "label": "Dev: Start local Backend",
-      "command": "../${config:python.pythonPath}",
-      "args": ["app.py"],
-      "options": {
-        "cwd": "${workspaceFolder}/mealie/"
-      },
+      "label": "Dev: Start Backend",
+      "command": "make backend",
      "type": "shell",
-      "problemMatcher": [],
      "presentation": {
        "reveal": "always",
        "group": "groupA"
-      }
+      },
+      "problemMatcher": []
    },
    {
-      "label": "Dev: Start local Frontend",
-      "command": "npm run serve",
+      "label": "Dev: Start Frontend",
+      "command": "make frontend",
      "type": "shell",
-      "options": {
-        "cwd": "${workspaceFolder}/frontend/"
-      },
-      "problemMatcher": [],
      "presentation": {
        "reveal": "always",
        "group": "groupA"
-      }
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "Dev: Start Docs Server",
+      "command": "make docs",
+      "type": "shell",
+      "presentation": {
+        "reveal": "always",
+        "group": "groupA"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "Run python tests",
+      "command": "make test",
+      "type": "shell",
+      "presentation": {
+        "reveal": "always"
+      },
+      "problemMatcher": []
    }
  ]
 }
--- a/22
+++ b/22
@@ -1,21 +1,35 @@
 {
 	auto_https off
+  admin off
 }

 :80 {
  @proxied path /api/* /docs /openapi.json

-  root * /app/dist
-  encode gzip
-  uri strip_suffix /
+  @static {
+    file
+    path *.ico *.css *.js *.gif *.jpg *.jpeg *.png *.svg *.woff *.woff2 *.webp
+  }
  
+  encode gzip zstd
+  
+  
+  # Handles Recipe Images / Assets
+  handle_path /api/media/recipes/* {
+    header @static Cache-Control max-age=31536000
+    root * /app/data/recipes/
+    file_server
+  }
+
  handle @proxied {
+    uri strip_suffix /
    reverse_proxy http://127.0.0.1:9000 
  }

  handle {
+    header @static Cache-Control max-age=31536000
+    root * /app/dist
    try_files {path}.html {path} /
    file_server 
  }
-
 }
--- a/65
+++ b/65
@@ -1,3 +1,4 @@
+# build
 FROM node:lts-alpine as build-stage
 WORKDIR /app
 COPY ./frontend/package*.json ./
@@ -5,36 +6,54 @@ RUN npm install
 COPY ./frontend/ .
 RUN npm run build

-FROM python:3.9-alpine

-RUN apk add --no-cache  libxml2-dev libxslt-dev libxml2 caddy
-ENV ENV prod
-EXPOSE 80
-WORKDIR /app
+FROM python:3.9-slim-buster

-COPY ./pyproject.toml /app/
+ENV PRODUCTION true
+ENV POETRY_VERSION 1.1.6

-RUN apk add --update --no-cache --virtual .build-deps \
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc g++ \
    curl \
-    g++ \
-    python3-dev \
-    musl-dev \
-    gcc \
-    build-base && \
-    curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | POETRY_HOME=/opt/poetry python && \
-    cd /usr/local/bin && \
-    ln -s /opt/poetry/bin/poetry && \
-    poetry config virtualenvs.create false && \
-    cd /app/ && poetry install --no-root --no-dev && \
-    apk --purge del .build-deps
+    gnupg gnupg2 gnupg1  \
+    apt-transport-https \
+    debian-archive-keyring \
+    debian-keyring \
+    libpq-dev \
+    libwebp-dev \
+    && curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | apt-key add - \
+    && curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | tee -a /etc/apt/sources.list.d/caddy-stable.list \
+    && apt-get update && apt-get install -y --no-install-recommends \
+    caddy \
+    && apt autoremove \
+    && rm -rf /var/lib/apt/lists/* \
+    && apt-get remove -y curl apt-transport-https debian-keyring g++ gnupg gnupg2 gnupg1 


-COPY ./mealie /app
+RUN pip install --no-cache-dir "poetry==$POETRY_VERSION"
+
+# project dependencies
+WORKDIR /app
+COPY pyproject.toml poetry.lock /app/
+RUN poetry config virtualenvs.create false
+RUN poetry install -E pgsql --no-dev --no-interaction --no-ansi
+
+COPY ./mealie /app/mealie
+RUN poetry config virtualenvs.create false \
+    && poetry install -E pgsql --no-dev
+
+#! Future
+# COPY ./alembic /app
+# COPY alembic.ini /app
 COPY ./Caddyfile /app
-COPY ./app_data/templates /app/data/templates
-RUN rm -rf /app/tests /app/.temp
+COPY ./dev/data/templates /app/data/templates
+
+# frontend build
 COPY --from=build-stage /app/dist /app/dist

 VOLUME [ "/app/data/" ]
-RUN chmod +x /app/run.sh
-CMD /app/run.sh
+
+EXPOSE 80
+
+CMD /app/mealie/run.sh
--- a/Dockerfile.dev
+++ b/Dockerfile.dev
@@ -1,21 +1,33 @@
-FROM python:3
+FROM python:3.9-slim-buster

-RUN apt-get update -y && \
-    apt-get install -y python-pip python-dev

-RUN curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | POETRY_HOME=/opt/poetry python && \
-    cd /usr/local/bin && \
-    ln -s /opt/poetry/bin/poetry && \
-    poetry config virtualenvs.create false
+ENV PRODUCTION false
+ENV POETRY_VERSION 1.1.6

-COPY ./pyproject.toml ./poetry.lock* /app/
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc g++ \
+    curl \
+    gnupg gnupg2 gnupg1  \
+    apt-transport-https \
+    debian-archive-keyring \
+    debian-keyring \
+    libwebp-dev \
+    && curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | apt-key add - \
+    && curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | tee -a /etc/apt/sources.list.d/caddy-stable.list \
+    && apt-get update && apt-get install -y --no-install-recommends \
+    && apt autoremove \
+    && rm -rf /var/lib/apt/lists/* \
+    && apt-get remove -y curl apt-transport-https debian-keyring g++ gnupg gnupg2 gnupg1 

-WORKDIR /app
+RUN pip install --no-cache-dir "poetry==$POETRY_VERSION" 

-RUN poetry install --no-root
+WORKDIR /app/

-COPY ./mealie /app
+# Copy poetry.lock* in case it doesn't exist in the repo
+COPY ./pyproject.toml /app/
+COPY ./mealie /app/mealie
+RUN poetry config virtualenvs.create false \
+    && poetry install

-ENTRYPOINT [ "python" ]
-
-CMD [ "app.py" ]
+RUN chmod +x /app/mealie/run.sh
+CMD ["/app/mealie/run.sh", "reload"]
--- a/README.md
+++ b/README.md
@@ -4,6 +4,11 @@
 [![Issues][issues-shield]][issues-url]
 [![MIT License][license-shield]][license-url]
 [![Docker Pulls][docker-pull]][docker-pull]
+[![CodeFactor](https://www.codefactor.io/repository/github/hay-kot/mealie/badge)](https://www.codefactor.io/repository/github/hay-kot/mealie)
+[![Docker Build Production](https://github.com/hay-kot/mealie/actions/workflows/dockerbuild.release.yml/badge.svg)](https://github.com/hay-kot/mealie/actions/workflows/dockerbuild.release.yml)
+[![Project Tests Production](https://github.com/hay-kot/mealie/actions/workflows/pytest.yml/badge.svg)](https://github.com/hay-kot/mealie/actions/workflows/pytest.yml)
+[![Docker Build Dev](https://github.com/hay-kot/mealie/actions/workflows/dockerbuild.dev.yml/badge.svg?branch=dev)](https://github.com/hay-kot/mealie/actions/workflows/dockerbuild.dev.yml)
+[![Project Tests Dev](https://github.com/hay-kot/mealie/actions/workflows/pytest.yml/badge.svg?branch=dev)](https://github.com/hay-kot/mealie/actions/workflows/pytest.yml)

 <!-- PROJECT LOGO -->
 <br />
@@ -23,11 +28,11 @@
  <a href="https://github.com/hay-kot/mealie">
  </a>
    <br />
-    <a href="https://github.com/hay-kot/mealie"><s>View Demo</s></a>
+    <a href="https://mealie-demo.hay-kot.dev/">View Demo</a>
    ·
    <a href="https://github.com/hay-kot/mealie/issues">Report Bug</a>    
    ·
-    <a href="https://hay-kot.github.io/mealie/api/docs/">API</a>
+    <a href="https://hay-kot.github.io/mealie/api/redoc/">API</a>
    ·
    <a href="https://github.com/hay-kot/mealie/issues">
    Request Feature
@@ -39,47 +44,59 @@



-<!-- ABOUT THE PROJECT -->
-## About The Project
-

 [![Product Name Screen Shot][product-screenshot]](https://example.com)

-**Mealie** is a self hosted recipe manager and meal planner with a RestAPI backend and a reactive frontend application built in Vue for a pleasant user experience for the whole family. Easily add recipes into your database by providing the url and mealie will automatically import the relevant data or add a family recipe with the UI editor.  
+# About The Project

-Mealie also provides a secure API for interactions from 3rd party applications. **Why does my recipe manager need an API?** An API allows integration into applications like [Home Assistant]() that can act as notification engines to provide custom notifications based of Meal Plan data to remind you to defrost the chicken, marinade the steak, or start the CrockPot. See the section on [Meal Plan hooks](#hooks) for more information. Additionally, you can access any available API from the backend server. To explore the API spin up your server and navigate to http://yourserver.com/docs for interactive API documentation. 
+Mealie is a self hosted recipe manager and meal planner with a RestAPI backend and a reactive frontend application built in Vue for a pleasant user experience for the whole family. Easily add recipes into your database by providing the url and Mealie will automatically import the relevant data or add a family recipe with the UI editor. Mealie also provides an API for interactions from 3rd party applications. 
+
+[Remember to join the Discord](https://discord.gg/QuStdQGSGK)! 



-### Main Features
-#### Recipes
-  - Automatic web scrapping for common recipe platforms
-  - Interactive API Documentation thanks to [FastAPI](https://fastapi.tiangolo.com/) and [Swagger](https://petstore.swagger.io/)
-  - UI Recipe Editor
-  - JSON Recipe Editor in browser
-  - Custom tags and categories
-  - Rate recipes
-  - Add notes to recipes
-#### Meal Planner
-  - Random Meal plan generation based off categories
-  - Expose notes in the API to allow external applications to access relevant information for meal plans
-  - Shopping Lists
-#### Database Import / Export
-  - Easily Import / Export your recipes from the UI
-  - Export recipes in into custom files using Jinja2 templates
+## Key Features
+- 🔍 Fuzzy search
+- 🏷️ Tag recipes with categories or tags for flexible sorting
+- 🕸 Import recipes from around the web by URL
+- 💪 Powerful bulk Category/Tag assignment
+- 📱 Beautiful Mobile Views
+- 📆 Create Meal Plans
+- 🛒 Generate shopping lists
+- 🐳 Easy setup with Docker
+- 🎨 Customize your interface with color themes 
+- 💾 Export all your data in any format with Jinja2 Templates
+- 🔒 Keep your data safe with automated backup and easy restore options
+- 🌍 localized in many languages
+- ➕ Plus tons more!
+    - Flexible API
+        - Custom key/value pairs for recipes
+        - Webhook support
+        - Interactive API Documentation thanks to [FastAPI](https://fastapi.tiangolo.com/) and [Swagger](https://petstore.swagger.io/)
+    - Raw JSON Recipe Editor
+    - Migration from other platforms
+        - Chowdown
+        - Nextcloud Cookbook
+    - Random meal plan generation

-### Built With
+## FAQ

-* [Vue.js](https://vuejs.org/)
-* [Vuetify](https://vuetifyjs.com/en/)
-* [FastAPI](https://fastapi.tiangolo.com/)
-* [Docker](https://www.docker.com/)
+### Why An API?
+An API allows integration into applications like [Home Assistant](https://www.home-assistant.io/) that can act as notification engines to provide custom notifications based of Meal Plan data to remind you to defrost the chicken, marinade the steak, or start the CrockPot. Additionally, you can access nearly any backend service via the API giving you total control to extend the application. To explore the API spin up your server and navigate to http://yourserver.com/docs for interactive API documentation. 
+
+### Why a Database?
+Some users of static-site generator applications like ChowDown have expressed concerns about their data being stuck in a database. Considering this is a new project it is a valid concern to be worried about your data. Mealie specifically addresses this concern by provided automatic daily backups that export your data in json, plain-text markdown files, and/or custom Jinja2 templates. **This puts you in controls of how your data is represented** when exported from Mealie, which means you can easily migrate to any other service provided Mealie doesn't work for you. 
+
+As to why we need a database?
+
+- **Developer Experience:** Without a database a lot of the work to maintain your data is taken on by the developer instead of a battle tested platform for storing data. 
+- **Multi User Support:** With a solid database as backend storage for your data Mealie can better support multi-user sites and avoid read/write access errors when multiple actions are taken at the same time. 


 <!-- CONTRIBUTING -->
 ## Contributing

-Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**. Especially test. Literally any tests. See the [Contributors Guide](https://hay-kot.github.io/mealie/contributors/developers-guide/code-contributions/) for help getting started.
+Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**. Especially test. Literally any tests. See the [Contributors Guide](https://hay-kot.github.io/mealie/contributors/non-coders/) for help getting started.

 If you are not a coder, you can still contribute financially. financial contributions help me prioritize working on this project over others and helps me know that there is a real demand for project development. 

@@ -87,7 +104,6 @@ If you are not a coder, you can still contribute financially. financial contribu

 <!-- LICENSE -->
 ## License
-
 Distributed under the MIT License. See `LICENSE` for more information.


@@ -97,16 +113,6 @@ Project Link: [https://github.com/hay-kot/mealie](https://github.com/hay-kot/mea



-<!-- ACKNOWLEDGEMENTS -->
-## Acknowledgements
-
-* [Talk Python Training for helping me learn python](https://training.talkpython.fm/)
-* [Academind for helping me learn Javascript and Vue.js](https://academind.com/)
-
-
-
-
-
 <!-- MARKDOWN LINKS & IMAGES -->
 <!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
 [contributors-shield]: https://img.shields.io/github/contributors/hay-kot/mealie.svg?style=flat-square
@@ -122,4 +128,4 @@ Project Link: [https://github.com/hay-kot/mealie](https://github.com/hay-kot/mea
 [license-url]: https://github.com/hay-kot/mealie/blob/master/LICENSE.txt
 [linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=flat-square&logo=linkedin&colorB=555
 [linkedin-url]: https://linkedin.com/in/hay-kot
-[product-screenshot]: docs/docs/img/home_screenshot.png
+[product-screenshot]: docs/docs/assets/img/home_screenshot.png
--- a/app_data/backups/dev_sample_data_2021-Feb-13.zip
+++ b/app_data/backups/dev_sample_data_2021-Feb-13.zip
--- a/crowdin.yml
+++ b/crowdin.yml
@@ -0,0 +1,6 @@
+preserve_hierarchy: false
+files:
+  - source: /frontend/src/locales/messages/en-US.json
+    translation: /frontend/src/locales/messages/%locale%.json
+  - source: /frontend/src/locales/dateTimeFormats/en-US.json
+    translation: /frontend/src/locales/dateTimeFormats/%locale%.json
--- a/dev/data/backups/.gitkeep
+++ b/dev/data/backups/.gitkeep
--- a/dev/data/backups/test_backup_2021-Apr-27.zip
+++ b/dev/data/backups/test_backup_2021-Apr-27.zip
--- a/dev/data/debug/.gitkeep
+++ b/dev/data/debug/.gitkeep
--- a/dev/data/migration/.gitkeep
+++ b/dev/data/migration/.gitkeep
--- a/dev/data/templates/recipes.md
+++ b/dev/data/templates/recipes.md
@@ -1,19 +1,17 @@


-![Recipe Image](../images/{{ recipe.image }})
+![Recipe Image](../../images/{{ recipe.slug }}/original.jpg)

 # {{ recipe.name }}
 {{ recipe.description }}

 ## Ingredients
-{% for ingredient in recipe.recipeIngredient %}
- [ ] {{ ingredient }}
-{% endfor %}
+{% for ingredient in recipe.recipeIngredient %} 
+- [ ] {{ ingredient }} {% endfor %}

 ## Instructions
-{% for step in recipe.recipeInstructions %}
- [ ] {{ step.text }}
-{% endfor %}
+{% for step in recipe.recipeInstructions %} 
+- [ ] {{ step.text }} {% endfor %}

 {% for note in recipe.notes %}
 **{{ note.title }}:** {{ note.text }}
--- a/dev/dev-notes.md
+++ b/dev/dev-notes.md
@@ -1,48 +0,0 @@
-# Getting A Developer Instance Started
-For the best experience developing I recommend using docker. I've used both WSL2 and Ubuntu to develop mealie and have had no issues with cross compatibility with docker. 2 Scripts are available along ith docker-compose files to make development instances easier. After cloning the repo you can set the scripts in /dev/scripts/ as executable and then use VSCode tasks to execute the scripts or execute them from the CLI. 
-
-`docker-compose.dev.sh` Will spin up a development stack with hot-reloading enabled. 
-`docker-compose.sh` Will spin up a production version of the stack.  
-
-After the stack is running navigate to the [admin page localhost:9090/settings/site](http://localhost:9090/settings/site). On the Backups and Exports section import the backup labeled dev_sample_data_{DATE}.zip. This will give you some recipe data to work with. 
-
-Once you're up and running you should be able to make changes and see them reflected on the frontend/backend. If you're not sure what to work on you can check:
-
- The Todo's below.
- The [Development Road Map](https://hay-kot.github.io/mealie/2.0%20-%20roadmap/)
- The [Current Open Issues](https://github.com/hay-kot/mealie/issues)
-
-Don't forget to [join the Discord](https://discord.gg/R6QDyJgbD2)! 
-
-# Todo's
-
-Test
- [ ] Image Upload Test
- [ ] Rename and Upload Image Test
- [x] Chowdown Migration End Point Test
-
-Frontend
- [ ] No Meal Today Page instead of Null 
- [ ] Recipe Print Page 
- [ ] Recipe Editor Data Validation Client Side
- [ ] Organize Home Page my Category, ideally user selectable.
- [ ] Advanced Search Page, draft started
-  - [ ] Filter by Category
-  - [ ] Filter by Tags
- [ ] Search Bar Results Redesign
-
-Backend
- [ ] Database Import
-  - [x] Recipes
-  - [x] Images
-  - [ ] Meal Plans
-  - [x] Settings
-  - [x] Themes
- [ ] Remove Print / Debug Code
- [ ] Support how to sections and how to steps
- [ ] Recipe request by category/tags
-
-SQL
- [ ] Setup Database Migrations
-
-# Draft Changelog
--- a/dev/non-working-links.txt
+++ b/dev/non-working-links.txt
@@ -1 +0,0 @@
-http://www.cookingforkeeps.com/2013/02/05/blue-cheese-stuffed-turkey-meatballs-with-raspberry-balsamic-glaze-2/
--- a/dev/scratch/build.py
+++ b/dev/scratch/build.py
@@ -1,32 +0,0 @@
-import requests
-import json
-
-POST_URL = "http://localhost:9921/api/recipe/create-url"
-URL_LIST = [
-    "https://www.bonappetit.com/recipe/hallacas"
-    "https://www.bonappetit.com/recipe/oat-and-pecan-brittle-cookies",
-    "https://www.bonappetit.com/recipe/tequila-beer-and-citrus-cocktail",
-    "https://www.bonappetit.com/recipe/corn-and-crab-beignets-with-yaji-aioli",
-    "https://www.bonappetit.com/recipe/nan-e-berenji",
-    "https://www.bonappetit.com/recipe/ginger-citrus-cookies",
-    "https://www.bonappetit.com/recipe/chocolate-pizzettes-cookies",
-    "https://www.bonappetit.com/recipe/swedish-glogg",
-    "https://www.bonappetit.com/recipe/roasted-beets-with-dukkah-and-sage",
-    "https://www.bonappetit.com/recipe/collard-greens-salad-with-pickled-fennel-and-coconut"
-    "https://www.bonappetit.com/recipe/sparkling-wine-cocktail",
-    "https://www.bonappetit.com/recipe/pretzel-and-potato-chip-moon-pies",
-    "https://www.bonappetit.com/recipe/coffee-hazlenut-biscotti",
-    "https://www.bonappetit.com/recipe/curry-cauliflower-rice",
-    "https://www.bonappetit.com/recipe/life-of-the-party-layer-cake",
-    "https://www.bonappetit.com/recipe/marranitos-enfiestados",
-]
-
-
-if __name__ == "__main__":
-    for url in URL_LIST:
-        data = {"url": url}
-        data = json.dumps(data)
-        try:
-            response = requests.post(POST_URL, data)
-        except:
-            continue
--- a/dev/scratch/write_settings.py
+++ b/dev/scratch/write_settings.py
@@ -1,39 +0,0 @@
-import json
-
-import requests
-
-POST_URL = "http://localhost:9921/api/site-settings/themes/create/"
-GET_URL = "http://localhost:9921/api/site-settings/themes/"
-
-SITE_SETTINGS = [
-    {
-        "name": "default",
-        "colors": {
-            "primary": "#E58325",
-            "accent": "#00457A",
-            "secondary": "#973542",
-            "success": "#5AB1BB",
-            "info": "#FFFD99",
-            "warning": "#FF4081",
-            "error": "#EF5350",
-        },
-    },
-    {
-        "name": "purple",
-        "colors": {
-            "accent": "#4527A0",
-            "primary": "#FF4081",
-            "secondary": "#26C6DA",
-            "success": "#4CAF50",
-            "info": "#2196F3",
-            "warning": "#FB8C00",
-            "error": "#FF5252",
-        },
-    },
-]
-
-if __name__ == "__main__":
-    for theme in SITE_SETTINGS:
-        data = json.dumps(theme)
-        response = requests.post(POST_URL, data)
-        response = requests.get(GET_URL)
--- a/dev/scripts/api_docs_gen.py
+++ b/dev/scripts/api_docs_gen.py
@@ -0,0 +1,44 @@
+import json
+
+from mealie.app import app
+from mealie.core.config import DATA_DIR
+
+"""Script to export the ReDoc documentation page into a standalone HTML file."""
+
+HTML_TEMPLATE = """<!-- Custom HTML site displayed as the Home chapter -->
+{% extends "main.html" %}
+{% block tabs %}
+{{ super() }}
+
+<style>
+    body {
+        margin: 0;
+        padding: 0;
+    }
+</style>
+
+
+<div id="redoc-container"></div>
+<script src="https://cdn.jsdelivr.net/npm/redoc/bundles/redoc.standalone.js"> </script>
+<script>
+    var spec = MY_SPECIFIC_TEXT;
+    Redoc.init(spec, {}, document.getElementById("redoc-container"));
+</script>
+
+
+{% endblock %}
+{% block content %}{% endblock %}
+{% block footer %}{% endblock %}
+"""
+
+HTML_PATH = DATA_DIR.parent.parent.joinpath("docs/docs/overrides/api.html")
+
+
+def generate_api_docs(my_app):
+    with open(HTML_PATH, "w") as fd:
+        text = HTML_TEMPLATE.replace("MY_SPECIFIC_TEXT", json.dumps(my_app.openapi()))
+        fd.write(text)
+
+
+if __name__ == "__main__":
+    generate_api_docs(app)
--- a/dev/scripts/app_routes_gen.py
+++ b/dev/scripts/app_routes_gen.py
@@ -0,0 +1,141 @@
+import re
+from enum import Enum
+from itertools import groupby
+from pathlib import Path
+
+import slugify
+from fastapi import FastAPI
+from humps import camelize
+from jinja2 import Template
+from mealie.app import app
+from pydantic import BaseModel
+
+CWD = Path(__file__).parent
+OUT_DIR = CWD / "output"
+OUT_FILE = OUT_DIR / "app_routes.py"
+
+JS_DIR = OUT_DIR / "javascriptAPI"
+JS_OUT_FILE = JS_DIR / "apiRoutes.js"
+TEMPLATES_DIR = CWD / "templates"
+
+PYTEST_TEMPLATE = TEMPLATES_DIR / "pytest_routes.j2"
+JS_REQUESTS = TEMPLATES_DIR / "js_requests.j2"
+JS_ROUTES = TEMPLATES_DIR / "js_routes.j2"
+JS_INDEX = TEMPLATES_DIR / "js_index.j2"
+
+JS_DIR.mkdir(exist_ok=True, parents=True)
+
+
+class RouteObject:
+    def __init__(self, route_string) -> None:
+        self.prefix = "/" + route_string.split("/")[1]
+        self.route = "/" + route_string.split("/", 2)[2]
+        self.js_route = self.route.replace("{", "${")
+        self.parts = route_string.split("/")[1:]
+        self.var = re.findall(r"\{(.*?)\}", route_string)
+        self.is_function = "{" in self.route
+        self.router_slug = slugify.slugify("_".join(self.parts[1:]), separator="_")
+        self.router_camel = camelize(self.router_slug)
+
+    def __repr__(self) -> str:
+        return f"""Route: {self.route}
+Parts: {self.parts}
+Function: {self.is_function}
+Var: {self.var}
+Slug: {self.router_slug}
+"""
+
+
+class RequestType(str, Enum):
+    get = "get"
+    put = "put"
+    post = "post"
+    patch = "patch"
+    delete = "delete"
+
+
+class HTTPRequest(BaseModel):
+    request_type: RequestType
+    description: str = ""
+    summary: str
+    tags: list[str]
+
+    @property
+    def summary_camel(self):
+        return camelize(self.summary)
+
+    @property
+    def js_docs(self):
+        return self.description.replace("\n", "  \n  * ")
+
+
+class PathObject(BaseModel):
+    route_object: RouteObject
+    http_verbs: list[HTTPRequest]
+
+    class Config:
+        arbitrary_types_allowed = True
+
+
+def get_path_objects(app: FastAPI):
+    paths = []
+
+    for key, value in app.openapi().items():
+        if key == "paths":
+            for key, value in value.items():
+
+                paths.append(
+                    PathObject(
+                        route_object=RouteObject(key),
+                        http_verbs=[HTTPRequest(request_type=k, **v) for k, v in value.items()],
+                    )
+                )
+
+    return paths
+
+
+def read_template(file: Path):
+    with open(file, "r") as f:
+        return f.read()
+
+
+def generate_template(app):
+    paths = get_path_objects(app)
+
+    static_paths = [x.route_object for x in paths if not x.route_object.is_function]
+    function_paths = [x.route_object for x in paths if x.route_object.is_function]
+
+    static_paths.sort(key=lambda x: x.router_slug)
+    function_paths.sort(key=lambda x: x.router_slug)
+
+    template = Template(read_template(PYTEST_TEMPLATE))
+    content = template.render(paths={"prefix": "/api", "static_paths": static_paths, "function_paths": function_paths})
+    with open(OUT_FILE, "w") as f:
+        f.write(content)
+
+    template = Template(read_template(JS_ROUTES))
+    content = template.render(
+        paths={"prefix": "/api", "static_paths": static_paths, "function_paths": function_paths, "all_paths": paths}
+    )
+    with open(JS_OUT_FILE, "w") as f:
+        f.write(content)
+
+    all_tags = []
+    for k, g in groupby(paths, lambda x: x.http_verbs[0].tags[0]):
+        template = Template(read_template(JS_REQUESTS))
+        content = template.render(paths={"all_paths": list(g), "export_name": camelize(k)})
+
+        all_tags.append(camelize(k))
+
+        with open(JS_DIR.joinpath(camelize(k) + ".js"), "w") as f:
+            f.write(content)
+
+    template = Template(read_template(JS_INDEX))
+    content = template.render(files={"files": all_tags})
+
+    with open(JS_DIR.joinpath("index.js"), "w") as f:
+        f.write(content)
+
+
+if __name__ == "__main__":
+    generate_template(app)
--- a/dev/scripts/docker-compose.dev.sh
+++ b/dev/scripts/docker-compose.dev.sh
@@ -1 +0,0 @@
-docker-compose -f docker-compose.dev.yml -p dev-mealie up --build
--- a/dev/scripts/docker-compose.sh
+++ b/dev/scripts/docker-compose.sh
@@ -1 +0,0 @@
-docker-compose -p mealie up --build
--- a/dev/scripts/output/app_routes.py
+++ b/dev/scripts/output/app_routes.py
@@ -0,0 +1,151 @@
+# This Content is Auto Generated for Pytest
+
+
+class AppRoutes:
+    def __init__(self) -> None:
+        self.prefix = '/api'
+
+        self.about_events = "/api/about/events"
+        self.about_events_notifications = "/api/about/events/notifications"
+        self.about_events_notifications_test = "/api/about/events/notifications/test"
+        self.auth_refresh = "/api/auth/refresh"
+        self.auth_token = "/api/auth/token"
+        self.auth_token_long = "/api/auth/token/long"
+        self.backups_available = "/api/backups/available"
+        self.backups_export_database = "/api/backups/export/database"
+        self.backups_upload = "/api/backups/upload"
+        self.categories = "/api/categories"
+        self.categories_empty = "/api/categories/empty"
+        self.debug = "/api/debug"
+        self.debug_last_recipe_json = "/api/debug/last-recipe-json"
+        self.debug_log = "/api/debug/log"
+        self.debug_statistics = "/api/debug/statistics"
+        self.debug_version = "/api/debug/version"
+        self.groups = "/api/groups"
+        self.groups_self = "/api/groups/self"
+        self.meal_plans_all = "/api/meal-plans/all"
+        self.meal_plans_create = "/api/meal-plans/create"
+        self.meal_plans_this_week = "/api/meal-plans/this-week"
+        self.meal_plans_today = "/api/meal-plans/today"
+        self.meal_plans_today_image = "/api/meal-plans/today/image"
+        self.migrations = "/api/migrations"
+        self.recipes_category = "/api/recipes/category"
+        self.recipes_create = "/api/recipes/create"
+        self.recipes_create_url = "/api/recipes/create-url"
+        self.recipes_summary = "/api/recipes/summary"
+        self.recipes_summary_uncategorized = "/api/recipes/summary/uncategorized"
+        self.recipes_summary_untagged = "/api/recipes/summary/untagged"
+        self.recipes_tag = "/api/recipes/tag"
+        self.recipes_test_scrape_url = "/api/recipes/test-scrape-url"
+        self.shopping_lists = "/api/shopping-lists"
+        self.site_settings = "/api/site-settings"
+        self.site_settings_custom_pages = "/api/site-settings/custom-pages"
+        self.site_settings_webhooks_test = "/api/site-settings/webhooks/test"
+        self.tags = "/api/tags"
+        self.tags_empty = "/api/tags/empty"
+        self.themes = "/api/themes"
+        self.themes_create = "/api/themes/create"
+        self.users = "/api/users"
+        self.users_api_tokens = "/api/users/api-tokens"
+        self.users_self = "/api/users/self"
+        self.users_sign_ups = "/api/users/sign-ups"
+        self.utils_download = "/api/utils/download"
+
+    def about_events_id(self, id):
+        return f"{self.prefix}/about/events/{id}"
+
+    def about_events_notifications_id(self, id):
+        return f"{self.prefix}/about/events/notifications/{id}"
+
+    def backups_file_name_delete(self, file_name):
+        return f"{self.prefix}/backups/{file_name}/delete"
+
+    def backups_file_name_download(self, file_name):
+        return f"{self.prefix}/backups/{file_name}/download"
+
+    def backups_file_name_import(self, file_name):
+        return f"{self.prefix}/backups/{file_name}/import"
+
+    def categories_category(self, category):
+        return f"{self.prefix}/categories/{category}"
+
+    def debug_log_num(self, num):
+        return f"{self.prefix}/debug/log/{num}"
+
+    def groups_id(self, id):
+        return f"{self.prefix}/groups/{id}"
+
+    def meal_plans_id(self, id):
+        return f"{self.prefix}/meal-plans/{id}"
+
+    def meal_plans_id_shopping_list(self, id):
+        return f"{self.prefix}/meal-plans/{id}/shopping-list"
+
+    def meal_plans_plan_id(self, plan_id):
+        return f"{self.prefix}/meal-plans/{plan_id}"
+
+    def media_recipes_recipe_slug_assets_file_name(self, recipe_slug, file_name):
+        return f"{self.prefix}/media/recipes/{recipe_slug}/assets/{file_name}"
+
+    def media_recipes_recipe_slug_images_file_name(self, recipe_slug, file_name):
+        return f"{self.prefix}/media/recipes/{recipe_slug}/images/{file_name}"
+
+    def migrations_import_type_file_name_delete(self, import_type, file_name):
+        return f"{self.prefix}/migrations/{import_type}/{file_name}/delete"
+
+    def migrations_import_type_file_name_import(self, import_type, file_name):
+        return f"{self.prefix}/migrations/{import_type}/{file_name}/import"
+
+    def migrations_import_type_upload(self, import_type):
+        return f"{self.prefix}/migrations/{import_type}/upload"
+
+    def recipes_recipe_slug(self, recipe_slug):
+        return f"{self.prefix}/recipes/{recipe_slug}"
+
+    def recipes_recipe_slug_assets(self, recipe_slug):
+        return f"{self.prefix}/recipes/{recipe_slug}/assets"
+
+    def recipes_recipe_slug_image(self, recipe_slug):
+        return f"{self.prefix}/recipes/{recipe_slug}/image"
+
+    def recipes_slug_comments(self, slug):
+        return f"{self.prefix}/recipes/{slug}/comments"
+
+    def recipes_slug_comments_id(self, slug, id):
+        return f"{self.prefix}/recipes/{slug}/comments/{id}"
+
+    def shopping_lists_id(self, id):
+        return f"{self.prefix}/shopping-lists/{id}"
+
+    def site_settings_custom_pages_id(self, id):
+        return f"{self.prefix}/site-settings/custom-pages/{id}"
+
+    def tags_tag(self, tag):
+        return f"{self.prefix}/tags/{tag}"
+
+    def themes_id(self, id):
+        return f"{self.prefix}/themes/{id}"
+
+    def users_api_tokens_token_id(self, token_id):
+        return f"{self.prefix}/users/api-tokens/{token_id}"
+
+    def users_id(self, id):
+        return f"{self.prefix}/users/{id}"
+
+    def users_id_favorites(self, id):
+        return f"{self.prefix}/users/{id}/favorites"
+
+    def users_id_favorites_slug(self, id, slug):
+        return f"{self.prefix}/users/{id}/favorites/{slug}"
+
+    def users_id_image(self, id):
+        return f"{self.prefix}/users/{id}/image"
+
+    def users_id_password(self, id):
+        return f"{self.prefix}/users/{id}/password"
+
+    def users_id_reset_password(self, id):
+        return f"{self.prefix}/users/{id}/reset-password"
+
+    def users_sign_ups_token(self, token):
+        return f"{self.prefix}/users/sign-ups/{token}"
--- a/dev/scripts/publish-release-branch.sh
+++ b/dev/scripts/publish-release-branch.sh
@@ -0,0 +1,11 @@
+git checkout dev
+git merge --strategy=ours master    # keep the content of this branch, but record a merge
+git checkout master
+git merge dev             # fast-forward master up to the merge
+
+
+## TODOs
+
+# Create New Branch v0.x.x
+# Push Branch Version to Github
+# Create Pull Request
--- a/dev/scripts/scrape_recipe.py
+++ b/dev/scripts/scrape_recipe.py
@@ -1,27 +0,0 @@
-"""
-Helper script to download raw recipe data from a URL and dump it to disk.
-The resulting files can be used as test input data.
-"""
-
-import sys, json, pprint
-import requests
-import extruct
-from scrape_schema_recipe import scrape_url
-from w3lib.html import get_base_url
-
-for url in sys.argv[1:]:
-    try:
-        data = scrape_url(url)[0]
-        slug = list(filter(None, url.split("/")))[-1]
-        filename = f"{slug}.json"
-        with open(filename, "w") as f:
-            json.dump(data, f, indent=4, default=str)
-        print(f"Saved {filename}")
-    except Exception as e:
-        print(f"Error for {url}: {e}")
-        print("Trying extruct instead")
-        pp = pprint.PrettyPrinter(indent=2)
-        r = requests.get(url)
-        base_url = get_base_url(r.text, r.url)
-        data = extruct.extract(r.text, base_url=base_url)
-        pp.pprint(data)
--- a/dev/scripts/templates/js_index.j2
+++ b/dev/scripts/templates/js_index.j2
@@ -0,0 +1,7 @@
+{% for api in files.files  %}
+import { {{ api }}API } from "./{{api}}.js" {% endfor %}
+
+export const api = {
+{% for api in files.files  %}
+    {{api}}: {{api}}API, {% endfor %}
+}
--- a/dev/scripts/templates/js_requests.j2
+++ b/dev/scripts/templates/js_requests.j2
@@ -0,0 +1,19 @@
+// This Content is Auto Generated
+import { API_ROUTES } from "./apiRoutes"
+
+export const {{paths.export_name}}API = { {% for path in paths.all_paths  %} {% for verb in path.http_verbs  %} {% if path.route_object.is_function %}
+  /** {{ verb.js_docs }} {% for v in path.route_object.var %}
+   * @param {{ v }} {% endfor %}
+   */
+  {{ verb.summary_camel }}({{path.route_object.var|join(", ")}}) {
+    const response = await apiReq.{{ verb.request_type.value }}(API_ROUTES.{{ path.route_object.router_camel }}({{path.route_object.var|join(", ")}}))
+    return response.data
+  }, {% else %}
+  /** {{ verb.js_docs }} {% for v in path.route_object.var %}
+   * @param {{ v }} {% endfor %}
+   */
+  {{ verb.summary_camel }}() {
+    const response = await apiReq.{{ verb.request_type.value }}(API_ROUTES.{{ path.route_object.router_camel }})
+    return response.data
+  },{% endif %} {% endfor %} {% endfor %}
+}
--- a/dev/scripts/templates/js_routes.j2
+++ b/dev/scripts/templates/js_routes.j2
@@ -0,0 +1,7 @@
+// This Content is Auto Generated
+const prefix = '{{paths.prefix}}'
+export const API_ROUTES = { {% for path in paths.static_paths %}
+  {{ path.router_camel }}: `${prefix}{{ path.route }}`,{% endfor %}
+{% for path in paths.function_paths  %}
+  {{path.router_camel}}: ({{path.var|join(", ")}}) => `${prefix}{{ path.js_route }}`,{% endfor %}
+}
--- a/dev/scripts/templates/pytest_routes.j2
+++ b/dev/scripts/templates/pytest_routes.j2
@@ -0,0 +1,12 @@
+# This Content is Auto Generated for Pytest
+
+
+class AppRoutes:
+    def __init__(self) -> None:
+        self.prefix = '{{paths.prefix}}'
+{% for path in paths.static_paths %}
+        self.{{ path.router_slug }} = "{{path.prefix}}{{ path.route }}"{% endfor %}
+{% for path in paths.function_paths  %}
+    def {{path.router_slug}}(self, {{path.var|join(", ")}}):
+        return f"{self.prefix}{{ path.route }}"
+{% endfor %}
--- a/docker-compose.dev.yml
+++ b/docker-compose.dev.yml
@@ -3,6 +3,7 @@ version: "3.1"
 services:
  # Vue Frontend
  mealie-frontend:
+    container_name: mealie-frontend
    image: mealie-frontend:dev
    build:
      context: ./frontend
@@ -18,6 +19,7 @@ services:

  # Fast API
  mealie-api:
+    container_name: mealie-api
    image: mealie-api:dev
    build:
      context: ./
@@ -26,17 +28,17 @@ services:
    ports:
      - 9921:9000
    environment:
-      db_type: sqlite
      TZ: America/Anchorage # Specify Correct Timezone for Date/Time to line up correctly.
    volumes:
-      - ./app_data:/app_data
-      - ./mealie:/app
+      - ./dev/data:/app/dev/data
+      - ./mealie:/app/mealie

+  # Mkdocs
  mealie-docs:
+    container_name: mealie-docs
    image: squidfunk/mkdocs-material
    restart: always
    ports:
-      - 9923:8000
+      - 9922:8000
    volumes:
      - ./docs:/docs
-
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -6,7 +6,21 @@ services:
      dockerfile: Dockerfile
    container_name: mealie
    restart: always
+    depends_on:
+      - "postgres"
    ports:
      - 9090:80
    environment:
-      db_type: sqlite
+      DB_ENGINE: postgres # Optional: 'sqlite', 'postgres'
+      POSTGRES_USER: mealie
+      POSTGRES_PASSWORD: mealie
+      POSTGRES_SERVER: postgres
+      POSTGRES_PORT: 5432
+      POSTGRES_DB: mealie
+  postgres:
+    container_name: postgres
+    image: postgres
+    restart: always
+    environment:
+      POSTGRES_PASSWORD: mealie
+      POSTGRES_USER: mealie
--- a/docs/Caddyfile
+++ b/docs/Caddyfile
@@ -0,0 +1,15 @@
+{
+  auto_https off
+}
+
+:80 {
+  root * /srv
+  encode gzip
+  uri strip_suffix /
+
+  handle {
+    try_files {path} {path}/ /index.html
+    file_server 
+  }
+
+}
--- a/docs/Dockerfile
+++ b/docs/Dockerfile
@@ -0,0 +1,10 @@
+FROM python:3.8-slim as build-stage
+WORKDIR /app
+RUN pip install --no-cache-dir mkdocs mkdocs-material
+COPY . .
+RUN mkdocs build
+
+FROM caddy:alpine
+WORKDIR /app
+COPY ./Caddyfile /etc/caddy/Caddyfile
+COPY --from=build-stage /app/site /srv
--- a/docs/docker-compose.yml
+++ b/docs/docker-compose.yml
@@ -0,0 +1,11 @@
+version: "3"
+services:
+  wiki:
+    container_name: mealie-docs
+    image: mealie-docs
+    ports:
+      - 8888:80
+    build:
+      context: .
+      dockerfile: Dockerfile
+    restart: always
--- a/docs/docs/api/api-usage.md
+++ b/docs/docs/api/api-usage.md
@@ -1,14 +0,0 @@
-# Usage
-
-## Key Components
-### Recipe Extras
-Recipes extras are a key feature of the Mealie API. They allow you to create custom json key/value pairs within a recipe to reference from 3rd part applications. You can use these keys to contain information to trigger automation or custom messages to relay to your desired device. 
-
-For example you could add `{"message": "Remember to thaw the chicken"}` to a recipe and use the webhooks built into mealie to send that message payload to a destination to be processed.
-
-![api-extras-gif](../gifs/api-extras.gif)
-
-
-## Examples
-
-Have Ideas? Submit a PR!
--- a/docs/docs/api/docs/index.html
+++ b/docs/docs/api/docs/index.html
--- a/docs/docs/api/redoc.md
+++ b/docs/docs/api/redoc.md
@@ -0,0 +1,4 @@
+---
+title: API
+template: api.html
+---
--- a/docs/docs/assets/gifs/URL-import.gif
+++ b/docs/docs/assets/gifs/URL-import.gif
--- a/docs/docs/assets/gifs/api-extras.gif
+++ b/docs/docs/assets/gifs/api-extras.gif
--- a/docs/docs/assets/gifs/backup-demo-v1.gif
+++ b/docs/docs/assets/gifs/backup-demo-v1.gif
--- a/docs/docs/assets/gifs/bulk-add-demo.gif
+++ b/docs/docs/assets/gifs/bulk-add-demo.gif
--- a/docs/docs/assets/gifs/create-custom-page-demo.gif
+++ b/docs/docs/assets/gifs/create-custom-page-demo.gif
--- a/docs/docs/assets/gifs/homepage-settings-v1.gif
+++ b/docs/docs/assets/gifs/homepage-settings-v1.gif
--- a/docs/docs/assets/gifs/meal-planner-demoV3.gif
+++ b/docs/docs/assets/gifs/meal-planner-demoV3.gif
--- a/docs/docs/assets/gifs/theme-demo-v3.gif
+++ b/docs/docs/assets/gifs/theme-demo-v3.gif
--- a/docs/docs/assets/img/Toolbox-Categories.webp
+++ b/docs/docs/assets/img/Toolbox-Categories.webp
--- a/docs/docs/assets/img/Toolbox-Organize.webp
+++ b/docs/docs/assets/img/Toolbox-Organize.webp
--- a/docs/docs/assets/img/add-notification.webp
+++ b/docs/docs/assets/img/add-notification.webp
--- a/docs/docs/assets/img/add-user.webp
+++ b/docs/docs/assets/img/add-user.webp
--- a/docs/docs/assets/img/admin-backup.webp
+++ b/docs/docs/assets/img/admin-backup.webp
--- a/docs/docs/assets/img/api-key-image-v1.webp
+++ b/docs/docs/assets/img/api-key-image-v1.webp
--- a/docs/docs/assets/img/custom-page.webp
+++ b/docs/docs/assets/img/custom-page.webp
--- a/docs/docs/assets/img/dashboard.webp
+++ b/docs/docs/assets/img/dashboard.webp
--- a/docs/docs/assets/img/discord-notification-example.webp
+++ b/docs/docs/assets/img/discord-notification-example.webp
--- a/docs/docs/assets/img/edit-recipe.webp
+++ b/docs/docs/assets/img/edit-recipe.webp
--- a/docs/docs/assets/img/favicon.png
+++ b/docs/docs/assets/img/favicon.png
--- a/docs/docs/assets/img/gotify-notification-example.webp
+++ b/docs/docs/assets/img/gotify-notification-example.webp
--- a/docs/docs/assets/img/group-manager.png
+++ b/docs/docs/assets/img/group-manager.png
--- a/docs/docs/assets/img/home-assistant-card.png
+++ b/docs/docs/assets/img/home-assistant-card.png
--- a/docs/docs/assets/img/home_screenshot.png
+++ b/docs/docs/assets/img/home_screenshot.png
--- a/docs/docs/assets/img/ios-shortcut-image.jpg
+++ b/docs/docs/assets/img/ios-shortcut-image.jpg
--- a/docs/docs/assets/img/iphone-image.png
+++ b/docs/docs/assets/img/iphone-image.png
--- a/docs/docs/assets/img/mealie-diagram.webp
+++ b/docs/docs/assets/img/mealie-diagram.webp
--- a/docs/docs/assets/img/sign-up-links.webp
+++ b/docs/docs/assets/img/sign-up-links.webp
--- a/docs/docs/assets/img/site-settings.webp
+++ b/docs/docs/assets/img/site-settings.webp
--- a/docs/docs/assets/js/analytics.js
+++ b/docs/docs/assets/js/analytics.js
--- a/docs/docs/assets/stylesheets/custom.css
+++ b/docs/docs/assets/stylesheets/custom.css
@@ -0,0 +1,47 @@
+[data-md-color-scheme="mealie"] {
+  --md-primary-fg-color: #e58325;
+  --md-primary-fg-color--light: #e58325;
+  --md-accent-fg-color: #e58325;
+  --md-custom-h2-color: #333;
+  --md-accent-fg-color--light: #e58325;
+  --md-default-accent-bg-color: #f7fafc;
+}
+
+[data-md-color-scheme="slate"] {
+  --md-primary-fg-color: #e58325;
+  --md-primary-fg-color--dark: #e58325;
+  --md-accent-fg-color: #e58325;
+  --md-accent-fg-color--dark: #e58325;
+  --md-custom-h2-color: rgb(167, 167, 167);
+  --md-default-bg-color: #1a1b1b;
+  --md-default-accent-bg-color: #1f1e1e;
+}
+
+/* frontpage elements */
+.tx-hero h1 {
+  font-size: 2.41rem !important;
+}
+a.md-button.md-button--primary {
+  background-color: var(--md-accent-fg-color);
+  border-color: var(--md-accent-fg-color);
+  color: #ffffff;
+}
+a.md-button.md-button--primary:hover {
+  color: #000000;
+}
+a.md-button.md-button:hover {
+  color: #ffffff;
+}
+
+/* Site width etc.*/
+.md-grid {
+  max-width: 64rem !important;
+}
+
+.md-typeset table:not([class]) th {
+  background-color: #e58325;
+}
+
+th {
+  font-weight: bold;
+}
--- a/docs/docs/changelog.md
+++ b/docs/docs/changelog.md
@@ -1,192 +0,0 @@
-# Release Notes
-
-## v0.3.0
-
-### Bug Fixes
-  - Fixed open search on `/` when in input. - Closes #174
-  - Error when importing recipe: KeyError: '@type' - Closes #145
-  - Fixed Import Issue - bhg.com - Closes #138
-  - Scraper not working with recipe containing HowToSection - Closes #73
-
-### Features and Improvements
-  - Improved Nextcloud Imports
-  - Improved Recipe Parser!
-  - Open search with `/` hotkey! 
-  - Database and App version are now split
-  - Unified and improved snackbar notifications
-  - New Category/Tag endpoints to filter all recipes by Category or Tag
-  - Category sidebar now has show/hide behavior on mobile
-  - Settings menu on mobile is improved
-  - **Meal Planner**
-    - You can now restrict recipe categories used for random meal-plan creation in the settings menu
-    - Recipe picker dialog will now display recipes when the search bar is empty
-    - Minor UI improvements
-    - **Shopping lists!** Shopping list can now be generated from a meal plan. Currently ingredients are split by recipes or there is a beta feature that attempts to sort them by similarity.
-  - **Recipe Viewer**
-    - Categories, Tags, and Notes will now be displayed below the steps on smaller screens
-  - **Recipe Editor**
-    - Text areas now auto grow to fit content
-    - Description, Steps, and Notes support Markdown! This includes inline html in Markdown. 
-  - **Imports**
-    - A revamped dialog has been created to provide more information on restoring backups. Exceptions on the backend are now sent to the frontend and are easily viewable to see what went wrong when you restored a backup. This functionality will be ported over to the migrations in a future release. 
-
-## v0.2.1 - Hot Fixes!
-
-### Features and Improvements
-  - Fixes upload image error when no photo was scrapped
-  - Fixes no last_recipe.json not updating
-  - Added markdown rendering for notes
-  - New notifications
-  - Minor UI improvements
-  - Recipe editor refactor
-  - Settings/Theme models refactor
-
-### Development / Misc
-  - Added async file response for images, downloading files.
-  - Breakup recipe view component
-
-## v0.2.0 - Now with Test!
-This is, what I think, is a big release! Tons of new features and some great quality of life improvements with some additional features. You may find that I made promises to include some fixes/features in v0.2.0. The short of is I greatly underestimated the work needed to refactor the database to a usable state and integrate categories in a way that is useful for users. This shouldn't be taken as a sign that I'm dropping those feature requests or ignoring them. I felt it was better to push a release in the current state rather than drag on development to try and fulfil all of the promises I made. 
-
-!!! warning "Upgrade Process"
-    Database Breaks! I have not yet implemented a database migration service. As such, upgrades cannot be done by simply pulling the image. You must first export your recipes, update your deployment, and then import your recipes. This pattern is likely to be how upgrades take place prior to v1.0. After v1.0 migrations will be done automatically.
-
-### Bug Fixes
-  - Remove ability to save recipe with no name
-  - Fixed data validation error on missing parameters
-  - Fixed failed database initialization at startup - Closes #98
-  - Fixed misaligned text on various cards
-  - Fixed bug that blocked opening links in new tabs - Closes #122
-  - Fixed router link bugs - Closes #122
-  - Fixed navigation on keyboard selection - Closes #139
-
-### Features and Improvements
-  - 🐳 Dockerfile now 1/5 of the size!
-  - 🌎 UI Language Selection + Additional Supported Language
-  - **Home Page**
-    - By default your homepage will display only the recently added recipes. You can configured sections to show on the home-screen based of categories on the settings page. 
-    - A new sidebar is now shown on the main page that lists all the categories in the database. Clicking on them navigates into a page that shows only recipes. 
-    - Basic Sort functionality has been added. More options are on the way! 
-  - **Meal Planner**
-    - Improved Search (Fuzzy Search)
-    - New Scheduled card support 
-  - **Recipe Editor**
-    - Ingredients are now sortable via drag-and-drop
-    - Known categories now show up in the dropdown - Closes 83
-    - Initial code for data validation to prevent errors
-  - **Migrations**
-    - Card based redesign
-    - Upload from the UI
-    - Unified Chowdown / Nextcloud import process. (Removed Git as a dependency)
-  - **API**
-    - Category and Tag endpoints added
-    - Major Endpoint refactor
-    - Improved API documentation
-    - Link to your Local API is now on your `/settings/site`. You can use it to explore your API. 
-
-  - **Style**
-    - Continued work on button/style unification
-    - Adding icons to buttons
-    - New Color Theme Picker UI
-
-### Development
-  - Fixed Vetur config file. Autocomplete in VSCode works!
-  - File/Folder restructuring 
-  - Added Prettier config
-  - Fixed incorrect layout code
-  - FastAPI Route tests for major operations - WIP (shallow testing)
-
-### Breaking Changes 
-
-!!! error "Breaking Changes"
-    - API endpoints have been refactored to adhear to a more consistent standard. This is a WIP and more changes are likely to occur. 
-    - Officially Dropped MongoDB Support
-    - Database Breaks! We have not yet implemented a database migration service. As such, upgrades cannot be done by simply pulling the image. You must first export your recipes, update your deployment, and then import your recipes. This pattern is likely to be how upgrades take place prior to v1.0. After v1.0 migrations will be done automatically. 
-
-## v0.1.0 - Initial Beta
-### Bug Fixes
-  - Fixed Can't delete recipe after changing name - Closes Closes #67
-  - Fixed No image when added by URL, and can't add an image - Closes Closes #66
-  - Fixed Images saved with no way to delete when add recipe via URL fails - Closes Closes #43
-
-### Features
-  - Additional Language Support
-  - Improved deployment documentation
-  - Additional database! SQlite is now supported! - Closes #48
-  - All site data is now backed up.
-  - Support for Prep Time, Total Time, and Cook Time field - Closes #63
-  - New backup import process with support for themes and site settings
-  - **BETA** ARM support! - Closes #69
-
-### Code / Developer Improvements
-  - Unified Database Access Layers
-  - Poetry / pyproject.toml support over requirements.txt
-  - Local development without database is now possible!
-  - Local mkdocs server added to docker-compose.dev.yml
-  - Major code refactoring to support new database layer
-  - Global variable refactor
-
-### Breaking Changes
-
- Internal docker port is now 80 instead of 9000. You MUST remap the internal port to connect to the UI. 
-
-!!! error "Breaking Changes"
-    As I've adopted the SQL database model I find that using 2 different types of databases will inevitably hinder development. As such after release v0.1.0 support for mongoDB will no longer be available. Prior to upgrading to v0.2.0 you will need to export your site and import after updating. This should be a painless process and require minimal intervention on the users part. Moving forward we will do our best to minimize changes that require user intervention like this and make updates a smooth process. 
-
-
-## v0.0.2 - Pre-release Second Patch
-A quality update with major props to [zackbcom](https://github.com/zackbcom) for working hard on making the theming just that much better!
-
-### Bug Fixes
-  - Fixed empty backup failure without markdown template
-  - Fixed opacity issues with marked steps - [mtoohey31](https://github.com/mtoohey31)
-  - Fixed hot-reloading development environment - [grssmnn](https://github.com/grssmnn)
-  - Fixed recipe not saving without image - Closes #7 + Closes #54
-  - Fixed parsing error on image property null - Closes #43
-
-### General Improvements
-  - Added Confirmation component to deleting recipes - [zackbcom](https://github.com/zackbcom)
-  - Updated Theme backend - [zackbcom](https://github.com/zackbcom)
-  - Added Persistent storage to vuex - [zackbcom](https://github.com/zackbcom)
-  - General Color/Theme Improvements
-      - More consistent UI
-      - More minimalist coloring
-  - Added API key extras to Recipe Data - [See Documentation](/api/api-usage/)
-      - Users can now add custom json key/value pairs to all recipes via the editor for access in 3rd part applications. For example users can add a "message" field in the extras that can be accessed on API calls to play a message over google home. 
-  - Improved image rendering (nearly x2 speed)
-  - Improved documentation + API Documentation
-  - Improved recipe parsing - Closes #51
-  - User feedback on backup importing
-
-## v0.0.1 - Pre-release Patch
-### General
-  - Updated Favicon
-  - Renamed Frontend Window
-  - Added Debug folder to dump scraper data prior to processing. 
-
-### Recipes
-  - Added user feedback on bad URL
-  - Better backend data validation for updating recipes, avoid small syntax errors corrupting database entry. [Closes #8](https://github.com/hay-kot/mealie/issues/8)
-  - Fixed spacing Closes while editing new recipes in JSON
-
-## v0.0.0 - Initial Pre-release
-The initial pre-release. It should be semi-functional but does not include a lot of user feedback You may notice errors that have no user feedback and have no idea what went wrong. 
-
-### Recipes
-  - Automatic web scrapping for common recipe platforms
-  - Interactive API Documentation thanks to [FastAPI](https://fastapi.tiangolo.com/) and [Swagger](https://petstore.swagger.io/)
-  - UI Recipe Editor
-  - JSON Recipe Editor in browser
-  - Custom tags and categories
-  - Rate recipes
-  - Add notes to recipes
-  - Migration From Other Platforms
-    - Chowdown
-### Meal Planner
-  - Random Meal plan generation based off categories
-  - Expose notes in the API to allow external applications to access relevant information for meal plans
-  
-### Database Import / Export
-  - Easily Import / Export your recipes from the UI
-  - Export recipes in markdown format for universal access
-    - Use the default or a custom jinja2 template
--- a/docs/docs/changelog/.template.md
+++ b/docs/docs/changelog/.template.md
@@ -0,0 +1,30 @@
+# vx.x.x COOL TITLE GOES HERE
+
+**App Version: vx.x.x**
+
+**Database Version: vx.x.x**
+
+## Breaking Changes
+
+!!! error "Breaking Changes"
+
+    #### Database
+
+    #### ENV Variables
+
+
+## Bug Fixes
+- Fixed ...
+
+## Features and Improvements
+
+### General
+- New Thing 1
+
+
+### UI Improvements
+- 
+
+
+### Behind the Scenes
+- Refactoring...
--- a/docs/docs/changelog/v0.1.0.md
+++ b/docs/docs/changelog/v0.1.0.md
@@ -0,0 +1,88 @@
+# v0.1.0 - Initial Beta
+
+### Bug Fixes
+  - Fixed Can't delete recipe after changing name - Closes Closes #67
+  - Fixed No image when added by URL, and can't add an image - Closes Closes #66
+  - Fixed Images saved with no way to delete when add recipe via URL fails - Closes Closes #43
+
+### Features
+  - Additional Language Support
+  - Improved deployment documentation
+  - Additional database! SQlite is now supported! - Closes #48
+  - All site data is now backed up.
+  - Support for Prep Time, Total Time, and Cook Time field - Closes #63
+  - New backup import process with support for themes and site settings
+  - **BETA** ARM support! - Closes #69
+
+### Code / Developer Improvements
+  - Unified Database Access Layers
+  - Poetry / pyproject.toml support over requirements.txt
+  - Local development without database is now possible!
+  - Local mkdocs server added to docker-compose.dev.yml
+  - Major code refactoring to support new database layer
+  - Global variable refactor
+
+### Breaking Changes
+
+- Internal docker port is now 80 instead of 9000. You MUST remap the internal port to connect to the UI. 
+
+!!! error "Breaking Changes"
+    As I've adopted the SQL database model I find that using 2 different types of databases will inevitably hinder development. As such after release v0.1.0 support for mongoDB will no longer be available. Prior to upgrading to v0.2.0 you will need to export your site and import after updating. This should be a painless process and require minimal intervention on the users part. Moving forward we will do our best to minimize changes that require user intervention like this and make updates a smooth process. 
+
+
+## v0.0.2 - Pre-release Second Patch
+A quality update with major props to [zackbcom](https://github.com/zackbcom) for working hard on making the theming just that much better!
+
+### Bug Fixes
+  - Fixed empty backup failure without markdown template
+  - Fixed opacity issues with marked steps - [mtoohey31](https://github.com/mtoohey31)
+  - Fixed hot-reloading development environment - [grssmnn](https://github.com/grssmnn)
+  - Fixed recipe not saving without image - Closes #7 + Closes #54
+  - Fixed parsing error on image property null - Closes #43
+
+### General Improvements
+  - Added Confirmation component to deleting recipes - [zackbcom](https://github.com/zackbcom)
+  - Updated Theme backend - [zackbcom](https://github.com/zackbcom)
+  - Added Persistent storage to vuex - [zackbcom](https://github.com/zackbcom)
+  - General Color/Theme Improvements
+      - More consistent UI
+      - More minimalist coloring
+  - Added API key extras to Recipe Data - [See Documentation](/api/api-usage/)
+      - Users can now add custom json key/value pairs to all recipes via the editor for access in 3rd part applications. For example users can add a "message" field in the extras that can be accessed on API calls to play a message over google home. 
+  - Improved image rendering (nearly x2 speed)
+  - Improved documentation + API Documentation
+  - Improved recipe parsing - Closes #51
+  - User feedback on backup importing
+
+## v0.0.1 - Pre-release Patch
+### General
+  - Updated Favicon
+  - Renamed Frontend Window
+  - Added Debug folder to dump scraper data prior to processing. 
+
+### Recipes
+  - Added user feedback on bad URL
+  - Better backend data validation for updating recipes, avoid small syntax errors corrupting database entry. [Closes #8](https://github.com/hay-kot/mealie/issues/8)
+  - Fixed spacing Closes while editing new recipes in JSON
+
+## v0.0.0 - Initial Pre-release
+The initial pre-release. It should be semi-functional but does not include a lot of user feedback You may notice errors that have no user feedback and have no idea what went wrong. 
+
+### Recipes
+  - Automatic web scrapping for common recipe platforms
+  - Interactive API Documentation thanks to [FastAPI](https://fastapi.tiangolo.com/) and [Swagger](https://petstore.swagger.io/)
+  - UI Recipe Editor
+  - JSON Recipe Editor in browser
+  - Custom tags and categories
+  - Rate recipes
+  - Add notes to recipes
+  - Migration From Other Platforms
+    - Chowdown
+### Meal Planner
+  - Random Meal plan generation based off categories
+  - Expose notes in the API to allow external applications to access relevant information for meal plans
+  
+### Database Import / Export
+  - Easily Import / Export your recipes from the UI
+  - Export recipes in markdown format for universal access
+    - Use the default or a custom jinja2 template
--- a/docs/docs/changelog/v0.2.0.md
+++ b/docs/docs/changelog/v0.2.0.md
@@ -0,0 +1,72 @@
+# v0.2.1 - Hot Fixes!
+
+### Features and Improvements
+  - Fixes upload image error when no photo was scrapped
+  - Fixes no last_recipe.json not updating
+  - Added markdown rendering for notes
+  - New notifications
+  - Minor UI improvements
+  - Recipe editor refactor
+  - Settings/Theme models refactor
+
+### Development / Misc
+  - Added async file response for images, downloading files.
+  - Breakup recipe view component
+
+# v0.2.0 - Now with Test!
+This is, what I think, is a big release! Tons of new features and some great quality of life improvements with some additional features. You may find that I made promises to include some fixes/features in v0.2.0. The short of is I greatly underestimated the work needed to refactor the database to a usable state and integrate categories in a way that is useful for users. This shouldn't be taken as a sign that I'm dropping those feature requests or ignoring them. I felt it was better to push a release in the current state rather than drag on development to try and fulfil all of the promises I made. 
+
+!!! warning "Upgrade Process"
+    Database Breaks! I have not yet implemented a database migration service. As such, upgrades cannot be done by simply pulling the image. You must first export your recipes, update your deployment, and then import your recipes. This pattern is likely to be how upgrades take place prior to v1.0. After v1.0 migrations will be done automatically.
+
+### Bug Fixes
+  - Remove ability to save recipe with no name
+  - Fixed data validation error on missing parameters
+  - Fixed failed database initialization at startup - Closes #98
+  - Fixed misaligned text on various cards
+  - Fixed bug that blocked opening links in new tabs - Closes #122
+  - Fixed router link bugs - Closes #122
+  - Fixed navigation on keyboard selection - Closes #139
+
+### Features and Improvements
+  - 🐳 Dockerfile now 1/5 of the size!
+  - 🌎 UI Language Selection + Additional Supported Language
+  - **Home Page**
+    - By default your homepage will display only the recently added recipes. You can configured sections to show on the home-screen based of categories on the settings page. 
+    - A new sidebar is now shown on the main page that lists all the categories in the database. Clicking on them navigates into a page that shows only recipes. 
+    - Basic Sort functionality has been added. More options are on the way! 
+  - **Meal Planner**
+    - Improved Search (Fuzzy Search)
+    - New Scheduled card support 
+  - **Recipe Editor**
+    - Ingredients are now sortable via drag-and-drop
+    - Known categories now show up in the dropdown - Closes 83
+    - Initial code for data validation to prevent errors
+  - **Migrations**
+    - Card based redesign
+    - Upload from the UI
+    - Unified Chowdown / Nextcloud import process. (Removed Git as a dependency)
+  - **API**
+    - Category and Tag endpoints added
+    - Major Endpoint refactor
+    - Improved API documentation
+    - Link to your Local API is now on your `/settings/site`. You can use it to explore your API. 
+
+  - **Style**
+    - Continued work on button/style unification
+    - Adding icons to buttons
+    - New Color Theme Picker UI
+
+### Development
+  - Fixed Vetur config file. Autocomplete in VSCode works!
+  - File/Folder restructuring 
+  - Added Prettier config
+  - Fixed incorrect layout code
+  - FastAPI Route tests for major operations - WIP (shallow testing)
+
+### Breaking Changes 
+
+!!! error "Breaking Changes"
+    - API endpoints have been refactored to adhear to a more consistent standard. This is a WIP and more changes are likely to occur. 
+    - Officially Dropped MongoDB Support
+    - Database Breaks! We have not yet implemented a database migration service. As such, upgrades cannot be done by simply pulling the image. You must first export your recipes, update your deployment, and then import your recipes. This pattern is likely to be how upgrades take place prior to v1.0. After v1.0 migrations will be done automatically. 
--- a/docs/docs/changelog/v0.3.0.md
+++ b/docs/docs/changelog/v0.3.0.md
@@ -0,0 +1,29 @@
+# v0.3.0
+
+### Bug Fixes
+  - Fixed open search on `/` when in input. - Closes #174
+  - Error when importing recipe: KeyError: '@type' - Closes #145
+  - Fixed Import Issue - bhg.com - Closes #138
+  - Scraper not working with recipe containing HowToSection - Closes #73
+
+### Features and Improvements
+  - Improved Nextcloud Imports
+  - Improved Recipe Parser!
+  - Open search with `/` hotkey! 
+  - Database and App version are now split
+  - Unified and improved snackbar notifications
+  - New Category/Tag endpoints to filter all recipes by Category or Tag
+  - Category sidebar now has show/hide behavior on mobile
+  - Settings menu on mobile is improved
+  - **Meal Planner**
+    - You can now restrict recipe categories used for random meal-plan creation in the settings menu
+    - Recipe picker dialog will now display recipes when the search bar is empty
+    - Minor UI improvements
+    - **Shopping lists!** Shopping list can now be generated from a meal plan. Currently ingredients are split by recipes or there is a beta feature that attempts to sort them by similarity.
+  - **Recipe Viewer**
+    - Categories, Tags, and Notes will now be displayed below the steps on smaller screens
+  - **Recipe Editor**
+    - Text areas now auto grow to fit content
+    - Description, Steps, and Notes support Markdown! This includes inline html in Markdown. 
+  - **Imports**
+    - A revamped dialog has been created to provide more information on restoring backups. Exceptions on the backend are now sent to the frontend and are easily viewable to see what went wrong when you restored a backup. This functionality will be ported over to the migrations in a future release. 
--- a/docs/docs/changelog/v0.4.0.md
+++ b/docs/docs/changelog/v0.4.0.md
@@ -0,0 +1,86 @@
+# v0.4.0 Whoa, What a Release!
+
+**App Version: v0.4.0**
+
+**Database Version: v0.4.0**
+
+## Breaking Changes
+
+!!! error "Breaking Changes"
+
+    #### Database
+    A new database will be created. You must export your data and then import it after upgrading.
+
+    #### Site Settings
+    With the addition of group settings and a re-write of the database layer of the application backend, there is no migration path for your current site settings. Webhooks Settings, Meal Plan Categories are now managed by groups. Site settings, mainly homepage settings, are now site specific and managed by administrators. When upgrading be sure to uncheck the settings when importing your old data. 
+
+    #### ENV Variables
+    Names have been changed to be more consistent with industry standards. See the [Installation Page](/mealie/getting-started/install/) for new parameters.  
+
+## Bug Fixes
+- Fixed Search Results Limited to 100 - #198
+- Fixed recipes from marmiton.org not fully scrapped  - #196
+- Fixed Unable to get a page to load - #194
+- Fixed Recipe's from Epicurious don't upload. - #193
+- Fixed Edited blank recipe in meal plan is not saved - #184
+- Fixed Create a new meal plan allows selection of an end date that is prior to the start date - #183
+- Fixed Original URL not saved to imported recipe in 0.3.0-dev - #183
+- Fixed "IndexError: list index out of range" when viewing shopping list for meal plan containing days without a recipe selected - #178
+
+## Features and Improvements
+
+### General
+  - Documentation Rewrite
+  - [New Demo Site!](https://mealie-demo.hay-kot.dev/)
+  - New Documentation
+    - Landing Page
+    - Custom Caddy Configuration
+    - User Management 
+    - Introduction
+  - Updated Documentation
+    - Everything!
+  - The API Reference is now better embedded inside of the docs
+  - New default external port in documentation (Port 9000 -> 9925). This is only the port exposed by the host to the docker image. It doesn't change any existing functionality. 
+
+### User Authentication 
+  - Authentication! Tons of stuff went into creating a flexible authentication platform for a lot of different use cases. Review the documentation for more information on how to use the authentication, and how everything works together. More complex management of recipes and user restrictions are in the works, but this is a great start! Some key features include
+    - Sign Up Links
+    - Admin and User Roles
+    - Password Change
+    - Group Management
+    - Create/Edit/Delete Restrictions
+
+### Custom Pages
+  - You can now create custom pages that are displayed on the homepage sidebar to organize categories of recipes into pages. For example, if you have several categories that encompass "Entrée" you can group all those categories together under the "Entrée" page. See [Building Pages](/mealie/site-administration/building-pages/) for more information.
+!!! tip 
+    Note that this replaces the behavior of automatically adding categories to the sidebar.
+
+### UI Improvements
+  - Completed Redesign of the Admin Panel
+    - Profile Pages
+    - Side Panel Menu
+  - Improved UI for Recipe Search
+  - Language selector is now displayed on all pages and does not require an account
+
+### Recipe Data
+  - Recipe Database Refactoring. Tons of new information is now stored for recipes in the database. Not all is accessible via the UI, but it's coming.
+    - Nutrition Information
+      - calories
+      - fatContent
+      - fiberContent
+      - proteinContent
+      - sodiumContent
+      - sugarContent
+    - recipeCuisine has been added
+    - "categories" has been migrated to "recipeCategory" to adhere closer to the standard schema
+    - "tool" - a list of tools used for the recipe
+
+### Behind the Scenes
+  - Removed CDN dependencies
+  - Database Model Refactoring
+  - Import/Export refactoring
+  - File/Folder Name Refactoring
+  - Development is now easier with a makefile
+  - Mealie is now a proper package using poetry 
+  - Test refactoring
+  - Test Coverage 83% up from 75%!
--- a/docs/docs/changelog/v0.4.1.md
+++ b/docs/docs/changelog/v0.4.1.md
@@ -0,0 +1,35 @@
+# v0.4.1
+
+**App Version: v0.4.1**
+
+**Database Version: v0.4.0**
+
+!!! error "Breaking Changes"
+
+    #### Recipe Images
+    While it *shouldn't* be a breaking change, I feel it is important to note that you may experience issues with the new image migration. Recipe images are now minified, this is done on start-up, import, migration, and when a new recipe is created. The initial boot or load may be a bit slow if you have lots of recipes but you likely won't notice. What you may notice is that if your recipe slug and the image name do not match, you will encounter issues with your images showing up. This can be resolved by finding the image directory and rename it to the appropriate slug. I did fix multiple edge cases, but it is likely more exists. As always make a backup before you update! 
+
+    On the plus side, this comes with a huge performance increase! 🎉
+
+- Add markdown support for ingredients - Resolves #32
+- Ingredients editor improvements
+- Fix Tags/Categories render problems on recipes
+- Tags redirect to new tag pages
+- Categories redirect to category pages
+- Fix Backup download blocked by authentication
+- Random meal-planner will no longer duplicate recipes unless no other options
+- New Quick Week button to generate next 5 day week of recipe slots.
+- Minor UI tweaks
+- Recipe Cards now display 2 recipe tags
+- Recipe images are now minified. This comes with a serious performance improvement. On initial startup you may experience some delays. Images are migrated to the new structure on startup, depending on the size of your database this can take some time. 
+    - Note that original images are still kept for large displays like on the individual recipe pages.
+    - A smaller image is used for recipe cards
+    - A 'tiny' image is used for search images. 
+- Advanced Search Page. You can now use the search page to filter recipes to include/exclude tags and categories as well as select And/Or matching criteria. 
+- Added link to advanced search on quick search
+- Better support for NextCloud imports
+    - Translate keywords to tags
+    - Fix rollback on failure
+- Recipe Tag/Category Input components have been unified and now share a single way to interact. To add a new category in the recipe editor you need to click to '+' icon next to the input and fill out the form. This is the same for adding a Tag. 
+
+
--- a/docs/docs/changelog/v0.4.2.md
+++ b/docs/docs/changelog/v0.4.2.md
@@ -0,0 +1,34 @@
+# v0.4.2
+
+**App Version: v0.4.2**
+
+**Database Version: v0.4.0**
+
+!!! error "Breaking Changes"
+    1. With a recent refactor some users been experiencing issues with an environmental variable not being set correct. If you are experiencing issues, please provide your comments [Here](https://github.com/hay-kot/mealie/issues/281).
+
+    2. If you are a developer, you may experience issues with development as a new environmental variable has been introduced. Setting `PRODUCTION=false` will allow you to develop as normal.
+
+## Bug Fixes
+- Fixed Initialization script (v0.4.1a Hot Fix) - Closes #274
+- Fixed nested list error on recipe scrape - Closes #306
+- Fixed ingredient checkboxes - Closes #304
+- Removed link on recent - Closes #297
+- Categories sidebar is auto generated if no pages are created - Closes #291
+- Fix tag issues on creating custom pages - Closes #290
+- Validate paths on export - Closes #275
+- Walk Nextcloud import directory - Closes #254
+
+## General Improvements
+- Improved Nextcloud Migration. Mealie will now walk the directories in a zip file looking for directories that match the pattern of a Nextcloud Recipe. Closes #254
+    - Rewrite Keywords to Tag Fields
+    - Rewrite url to orgURL
+- Improved Chowdown Migration
+- Migration report is now similar to the Backup report
+- Tags/Categories are now title cased on import "dinner" -> "Dinner"
+- Depreciate `ENV` variable to `PRODUCTION`
+- Set `PRODUCTION` env variable to default to true
+- Unify Logger across the backend
+- mealie.log and last_recipe.json are now downloadable from the frontend from the /admin/about
+- New download schema where you request a token and then use that token to hit a single endpoint to download a file. This is a notable change if you are using the API to download backups. 
+- Recipe images can now be added directly from a URL - [See #117 for details](https://github.com/hay-kot/mealie/issues/117)
--- a/docs/docs/changelog/v0.4.3.md
+++ b/docs/docs/changelog/v0.4.3.md
@@ -0,0 +1,14 @@
+# v0.4.3
+
+**App Version: v0.4.3**
+
+**Database Version: v0.4.0**
+
+## Bug Fixes
+- Fix Upload error for Migrations
+- Fixes #315 - Cannot select another language
+- Fixes #314 - case-sensitive emails
+- Fixes #312 - Profile Image Reload
+
+## Improvements
+- New TOKEN_TIME and DEFAULT_EMAIL env variables
--- a/docs/docs/changelog/v0.5.0.md
+++ b/docs/docs/changelog/v0.5.0.md
@@ -0,0 +1,129 @@
+# v0.5.0 Too Many Changes! 
+
+**App Version: v0.5.0**
+
+**Database Version: v0.5.0**
+
+## Breaking Changes
+
+!!! error "Breaking Changes"
+
+    #### Database
+    Database version has been bumped from v0.4.x -> v0.5.0. You will need to export and import your data. Moving forward, we will be using database migrations (BETA) to do this automatically. Note that you still must backup your data. If you don't, it's entirely possible something may go wrong and you could lose your data on upgrade. 
+
+    #### Image Directory
+    the /data/img directory has been depreciated. All images are now stored in the /recipes/{slug}/image directory. Images should be migrated automatically, but you may experience issues related to this change. 
+
+    #### API Usage
+    If you have been using the API directly, many of the routes and status codes have changed. You may experience issues with directly consuming the API.
+
+    #### Arm/v7 Support
+    Mealie will no longer build in CI/CD due to a issue with the rust compiler on 32 bit devices. You can reference [this issue on the matrix-org/synapse](https://github.com/matrix-org/synapse/issues/9403){:target="_blank"} Github page that are facing a similar issue. You may still be able to build the docker image you-self. 
+
+!!! warning "Potential Data Loss"
+    With this release comes a major rework of how files are stored on disk and where things belong. Migration of files should be done automatically. We have tested extensively with many different backups and user bases and have found that no one experienced data-loss. HOWEVER, with all the major changes that have occurred, it is vital that to prevent any data-loss you must create a backup and store that backup outside of your mealie instance. If you do not do this, you may lose your data. 
+
+## Bug Fixes
+- Fixed #25 - Allow changing rating without going into edit
+- Fixed #475 - trim whitespace on login
+- Fixes #435 - Better Email Regex
+- Fixed #428 - Meal Planner now works on iOS devices
+- Fixed #419 - Typos
+- Fixed #418 - You can now "export" shopping lists
+- Fixed #356 - Shopping List items are now grouped
+- Fixed #329 - Fixed profile image not loading
+- Fixed #461 - Proper JSON serialization on webhooks
+- Fixed #332 - Language settings are saved for one browser
+- Fixes #281 - Slow Handling of Large Sets of Recipes
+- Fixed #356 - Shopping lists generate duplicate items
+- Fixed #271 - Slow handling of larger data sets
+- Fixed #472, #469, #458, #456 - Improve Recipe Parser
+
+## Features and Improvements
+
+### Highlights
+- Recipe Parser
+  - Recipes can now be imported with a bookmarklet!
+  - Significant improvement in supported sites with the new [Recipe Scraper Library](https://github.com/hhursev/recipe-scrapers){:target="_blank"}
+  - UI Debugging now available at `/recipes/debugger`
+  - Better error messages on failure
+  - ⚠️ last_recipe.json is now depreciated
+- Beta Support for Postgres! 🎉 See the getting started page for details
+- Recipe Features
+    - New button bar for editors with improved accessibility and performance
+    - Step Sections now supported
+    - Recipe Assets
+    - Add Asset image to recipe step
+    - Additional View Settings. 
+    - Better print support
+- New Toolbox Page!
+    - Bulk assign categories and tags by keyword search
+    - Title case all Categories or Tags with 1 click
+    - Create/Rename/Delete Operations for Tags/Categories
+    - Remove Unused Categories or Tags with 1 click
+- Recipe Cards now have a menu button for quick actions!
+    - Edit
+    - Delete
+    - Integrated Share with supported OS/Browsers
+    - Print
+- New Profile Dashboard!
+    - Edit Your Profile
+    - Create/Edit Themes
+    - View other users in your Group
+    - See what's for dinner
+    - Manage Long Live API Tokens (New)
+- New Admin Dashboard! 🎉
+    - Now you can get some insight on your application with application statics and events.
+    - See uncategorized/untagged recipes and organize them!
+    - Backup/Restore right from your dashboard
+    - See server side events. Now you can know who deleted your favorite recipe! 
+- New Event Notifications through the Apprise Library
+    - Get notified when specific server side events occur
+
+### Meal Planner
+- Multiple Recipes per day
+- Supports meals without recipes (Enter title and description)
+- Generate share-link from created meal-planners
+- Shopping lists can be directly generated from the meal plan
+
+### General
+- User can now favorite recipes
+- New 'Dark' Color Theme Packaged with Mealie
+- Updated Recipe Card Sections Toolbar
+    - New Sort Options (They work this time!) 
+        - Alphabetical
+        - Rating
+        - Created Date
+        - Updated Date
+        - Shuffle (Random Sort)
+    - New 'Random' Recipe button on recipe sections. Random recipes are selected from the filtered results below. For example, on the "Cakes" category page, you will only get recipes in the "Cakes" category. 
+- Rating can be updated without entering the editor - Closes #25
+- Updated recipe editor styles and moved notes to below the steps. 
+- Redesigned search bar
+- 'Dinner this week' shows a warning when no meal is planned yet
+- 'Dinner today' shows a warning when no meal is planned yet
+- More localization
+- Start date for Week is now selectable
+- Languages are now managed through Crowdin
+- Application Bar was Rewritten
+    - Sidebar can now be toggled everywhere. 
+    - New and improved mobile friendly bottom bar
+    - Improved styling for search bar in desktop
+    - Improved search layout on mobile
+- Profile image now shown on all sidebars
+- Switched from Flash Messages to Snackbar (Removed dependency)
+
+### Performance
+- Images are now served up by the Caddy increase performance and offloading some loads from the API server
+- Requesting all recipes from the server has been rewritten to refresh less often and manage client side data better.
+- All images are now converted to .webp for better compression
+
+### Behind the Scenes
+- The database layer has been added for future recipe scaling. 
+- Black and Flake8 now run as CI/CD checks
+- New debian based docker image
+- Unified Sidebar Components
+- Refactor UI components to fit Vue best practices (WIP)
+- The API returns more consistent status codes
+- The API returns error code instead of error text when appropriate 
+    - ⚠️ May cause side-effects if you were directly consuming the API
--- a/docs/docs/contributors/developers-guide/code-contributions.md
+++ b/docs/docs/contributors/developers-guide/code-contributions.md
@@ -1,28 +1,26 @@
 # Contributing to Mealie

-!!! Warning
-    It should be known going into this that this is my first open source project, and my first public github repo I'm actively managing. If something does not make sense, or is not best practice. PLEASE feel free to reach out and let me know. I'm all about improving workflow and making it easier for contributors. 
-
-[Please Join the Discord](https://discord.gg/R6QDyJgbD2). We are building a community of developers working on the project.
+[Please Join the Discord](https://discord.gg/QuStdQGSGK){:target="_blank"}. We are building a community of developers working on the project.

 ## We Develop with Github
 We use github to host code, to track issues and feature requests, as well as accept pull requests.

-## We Use [Github Flow](https://guides.github.com/introduction/flow/index.html), So All Code Changes Happen Through Pull Requests
-Pull requests are the best way to propose changes to the codebase (we use [Github Flow](https://guides.github.com/introduction/flow/index.html)). We actively welcome your pull requests: 
+## We Use [Github Flow](https://guides.github.com/introduction/flow/index.html){:target="_blank"}, So All Code Changes Happen Through Pull Requests
+Pull requests are the best way to propose changes to the codebase (we use [Github Flow](https://guides.github.com/introduction/flow/index.html){:target="_blank"}). We actively welcome your pull requests: 

 1. Fork the repo and create your branch from `dev`.
-2. Read the page in in [dev/dev-notes.md](https://github.com/hay-kot/mealie/blob/master/dev/dev-notes.md) to get an idea on where the project is at.
+2. Checkout the Discord, the PRs page, or the Projects page to get an idea of what's already being worked on.
 3. If you're interested on working on major changes please get in touch on discord and coordinate with other developers. No sense in doubling up on work if someones already on it. 
-4. If you've changed APIs, update the documentation.
-5. Issue that pull request!
-6. If you make changes to the dev branch reflect those changes in the dev/dev-notes.md to keep track of changes. Don't forget to add your name/handle/identifier! 
+4. Once you've got an idea of what changes you want to make, create a draft PR as soon as you can to let us know what you're working on and how we can help!
+5. If you've changed APIs, update the documentation.
+6. Issue that pull request!
+7. If you make changes to the dev branch reflect those changes in the active changelog to keep track of changes. Don't forget to add your name/handle/identifier!

 ## Any contributions you make will be under the MIT Software License
-In short, when you submit code changes, your submissions are understood to be under the same [MIT License](http://choosealicense.com/licenses/mit/) that covers the project. Feel free to contact the maintainers if that's a concern.
+In short, when you submit code changes, your submissions are understood to be under the same [MIT License](http://choosealicense.com/licenses/mit/){:target="_blank"} that covers the project. Feel free to contact the maintainers if that's a concern.

-## Report bugs using Github's [issues](https://github.com/hay-kot/mealie/issues)
-We use GitHub issues to track public bugs. Report a bug by [opening a new issue](https://github.com/hay-kot/mealie/issues/new); it's that easy!
+## Report bugs using Github's [issues](https://github.com/hay-kot/mealie/issues){:target="_blank"}
+We use GitHub issues to track public bugs. Report a bug by [opening a new issue](https://github.com/hay-kot/mealie/issues/new){:target="_blank"}; it's that easy!

 ## Write bug reports with detail, background, and sample code
 **Great Bug Reports** tend to have:
@@ -30,7 +28,7 @@ We use GitHub issues to track public bugs. Report a bug by [opening a new issue]
 - A quick summary and/or background
 - Steps to reproduce
  - Be specific!
-  - Give sample code if you can. [This stackoverflow question](http://stackoverflow.com/q/12488905/180626) includes sample code that *anyone* with a base R setup can run to reproduce what I was seeing
+  - Give sample code if you can. [This stackoverflow question](http://stackoverflow.com/q/12488905/180626){:target="_blank"} includes sample code that *anyone* with a base R setup can run to reproduce what I was seeing
 - What you expected would happen
 - What actually happens
 - Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)
@@ -42,4 +40,4 @@ People *love* thorough bug reports. I'm not even kidding.
 By contributing, you agree that your contributions will be licensed under its MIT License.

 ## References
-This document was adapted from the open-source contribution guidelines for [Facebook's Draft](https://github.com/facebook/draft-js/blob/a9316a723f9e918afde44dea68b5f9f39b7d9b00/CONTRIBUTING.md)
+This document was adapted from the open-source contribution guidelines for [Facebook's Draft](https://github.com/facebook/draft-js/blob/a9316a723f9e918afde44dea68b5f9f39b7d9b00/CONTRIBUTING.md){:target="_blank"}
--- a/docs/docs/contributors/developers-guide/general-guidelines.md
+++ b/docs/docs/contributors/developers-guide/general-guidelines.md
@@ -1,3 +1,7 @@
 # Guidelines

-TODO
+## Python
+
+## Vue
+
+[See The Style Guide](../developers-guide/style-guide.md)
--- a/docs/docs/contributors/developers-guide/starting-dev-server.md
+++ b/docs/docs/contributors/developers-guide/starting-dev-server.md
@@ -1,40 +1,51 @@
 # Development: Getting Started

-After reading through the [Code Contributions Guide](https://hay-kot.github.io/mealie/contributors/developers-guide/code-contributions/) and forking the repo you can start working. This project is developed with :whale: docker and as such you will be greatly aided by using docker for development. It's not necessary but it is helpful.
+After reading through the [Code Contributions Guide](../developers-guide/code-contributions.md) and forking the repo you can start working. This project is developed with :whale: docker and as such you will be greatly aided by using docker for development. It's not necessary but it is helpful.

 ## With Docker
-`cd` into frontend directory and run `npm install` to install the node modules. 
+Prerequisites

-There are 2 scripts to help set up the docker containers in dev/scripts/. 
-
-`docker-compose.dev.sh` - Will spin up a docker development server
-`docker-compose.sh` - Will spin up a docker production server
-
-There are VSCode tasks created in the .vscode folder. You can use these to quickly execute the scripts above using the command palette.
+- Docker
+- docker-compose

+You can easily start the development stack by running `make docker-dev` in the root of the project directory. This will run and build the docker-compose.dev.yml file.

 ## Without Docker
 Prerequisites

- Python 3.8+
+- Python 3.9+
 - Poetry
 - Nodejs
 - npm

-change directories into the mealie directory and run poetry install. cd into the frontend directory and run npm install. After installing dependencies, you can use vscode tasks to run the front and backend server. Use the command pallette to access the tasks. 
+Once the prerequisites are installed you can cd into the project base directory and run `make setup` to install the python and node dependencies. Once that is complete you can run `make backend` and `make frontend` to start the backend and frontend servers. 

-Alternatively you can run `npm run serve` in the frontend directory and `python app.py` in the mealie directory to get everything up and running for development. 
+## Make File Reference 

-## Trouble Shooting
+Run `make help` for reference

-!!! Error "Symptom: Vue Development Server Wont Start"
-    **Error:** `TypeError: Cannot read property 'upgrade' of undefined`
+```
+clean-purge          ⚠️ Removes All Developer Data for a fresh server start
+clean                🧹 Remove all build, test, coverage and Python artifacts
+clean-pyc            🧹 Remove Python file artifacts
+clean-test           🧹 Remove test and coverage artifacts
+test-all             🧪 Check Lint Format and Testing
+test                 🧪 Run tests quickly with the default Python
+lint                 🧺 Check style with flake8
+coverage             ☂️ Check code coverage quickly with the default Python
+setup                🏗 Setup Development Instance
+backend              🎬 Start Mealie Backend Development Server
+frontend             🎬 Start Mealie Frontend Development Server
+frontend-build       🏗 Build Frontend in frontend/dist
+docs                 📄 Start Mkdocs Development Server
+docker-dev           🐳 Build and Start Docker Development Stack
+docker-prod          🐳 Build and Start Docker Production Stack
+code-gen             🤖 Run Code-Gen Scripts

-    **Solution:** You may be missing the `/frontend/.env.development.` The contents should be `VUE_APP_API_BASE_URL=http://127.0.0.1:9921`. This is a reference to proxy the the API requests from Vue to 127.0.0.1 at port 9921 where FastAPI should be running.
+```

-!!! Error "Symptom: FastAPI Development Server Wont Start"
-    **Error:** `RuntimeError: Directory '/app/dist' does not exist`
+## Before you Commit! 

-    **Solution:** Create an empty /mealie/dist directory. This directory is served as static content by FastAPI. It is provided during the build process and may be missing in development. 
+Before you commit any changes on the backend/python side you'll want to run `make format` to format all the code with black. `make lint` to check with flake8, and `make test` to run pytests. You can also use `make test-all` to run both `lint` and `test`. 

-Run into another issue? [Ask for help on discord](https://discord.gg/R6QDyJgbD2)
+Run into another issue? [Ask for help on discord](https://discord.gg/QuStdQGSGK){:target="_blank"}
--- a/docs/docs/contributors/developers-guide/style-guide.md
+++ b/docs/docs/contributors/developers-guide/style-guide.md
@@ -0,0 +1,33 @@
+# Style Guide
+
+!!! note
+    Unifying styles across the application is an ongoing process, we are working on making the site more consistent.
+
+## Button Guidelines
+
+1. Buttons should follow the general color/icon scheme as outlined. 
+2. All buttons should have an icon on the left side of the button and text on the right. 
+3. Primary action buttons should be the default Vuetify styling. 
+4. Primary action buttons should be right aligned
+5. Secondary buttons should be `text` or `outlined`. Text is preferred
+6. Other buttons should generally be "info" or "primary" color and can take any style type depending on context
+
+### Button Colors and Icons
+
+| Type        | Color               | Icon                                               |
+| ----------- | :------------------ | :------------------------------------------------- |
+| Default     | `info` or `primary` | None                                               |
+| Create/New  | `success`           | `mdi-plus` or `$globals.icons.create`              |
+| Update/Save | `success`           | `mdi-save-content` or `$globals.icons.save`        |
+| Edit        | `info`              | `mdi-square-edit-outline` or `$globals.icons.edit` |
+
+### Example
+```html
+<v-btn color="primary">
+  <v-icon left> mdi-plus </v-icon>
+  Primary Button
+</v-btn>
+
+```
+
+
--- a/docs/docs/contributors/non-coders.md
+++ b/docs/docs/contributors/non-coders.md
@@ -7,9 +7,9 @@ We love your input! We want to make contributing to this project as easy and tra
 - Submitting a fix
 - Proposing new features
 - Becoming a maintainer
- [Help translate to a new language or improve current translations](../translating)
+- Help translate to a new language or improve current translations

-[Remember to join the Discord and stay in touch with other developers working on the project](https://discord.gg/R6QDyJgbD2)! 
+[Remember to join the Discord and stay in touch with other developers working on the project](https://discord.gg/QuStdQGSGK){:target="_blank"}! 

 Additionally, you can buy me a coffee and support the project. When I get financial support it helps me know that there's real interest in the project and that it's worth the time to keep developing. 

--- a/docs/docs/contributors/translating.md
+++ b/docs/docs/contributors/translating.md
@@ -1,15 +1,21 @@
-# Contributing with translations
+# Contributing with Translations
+Translations can be a great way **for non-coders** to contribute to project.
+We use **[Crowdin](https://crowdin.com/project/mealie){:target="_blank"}** to allow several contributors to work on translating Mealie. 
+You can simply help by voting for your preferred translations, or even by completely translating Mealie into a new language.

-Having Mealie in different language could help the adaption of Mealie. Translations can be a great way for non-coders to contribute to Mealie.
+Translations are regularly pulled from Crowdin and included in each new release.

-## Is Mealie missing in your language?
-If your language is missing, you can add it, by beginning to translate. We use a Vue-i18n in json files. Copy frontend/src/locales/en.json to get started.
+Please use Crowdin as much as possible if you have any question/issue regarding a particular string. You can take a look at [Crowdin Knowledge base](https://support.crowdin.com/for-volunteer-translators/){:target="_blank"} if you want to know more about how to use this tool.

-## Improving translations
-If your language is missing the translation for some strings, you can help out by adding a translation for that string. If you find a string you think could be improved, please feel free to do so. 
+## My language is missing in Mealie
+Once your language is translated on Crowdin, we need to manually add it in Mealie. If you believe your language is ready for use, please create an issue on GitHub. 

-## Tooling
-Currently we use Vue-i18n for translations. Translations are stored in json format located in [frontend/src/locales](https://github.com/hay-kot/mealie/tree/master/frontend/src/locales).
-If you have experience with a good Translation Management System, please feel free to chime in on the [Discord](https://discord.gg/R6QDyJgbD2), as such a system could be helpful as the projects grow.
-Until then, [i18n Ally for VScode](https://marketplace.visualstudio.com/items?itemName=antfu.i18n-ally) is recommended to aid in translating. It also has a nice feature, which shows translations in-place when editing code.
-i18n Ally will also show which languages is missing translations.
+## I can't find a particular text in Crowdin
+There can be several reasons:
+- The text you're looking for is outdated: someone has already changed it or it will be removed/changed in the next release.
+- It is possible some texts are not translatable (yet) for technical reasons. If you spot one, please reach out to us on [Discord](https://discord.gg/QuStdQGSGK){:target="_blank"} or raise an issue on GitHub.
+
+## Technical information
+We use vue-i18n package for internationalization. Translations are stored in json format located in [frontend/src/locales/messages](https://github.com/hay-kot/mealie/tree/master/frontend/src/locales/messages){:target="_blank"}.
+
+[i18n Ally for VScode](https://marketplace.visualstudio.com/items?itemName=lokalise.i18n-ally){:target="_blank"} is helpful for generating new strings to translate. It also has a nice feature, which shows translations in-place when editing code.
--- a/docs/docs/documentation/admin/backups-and-exports.md
+++ b/docs/docs/documentation/admin/backups-and-exports.md
@@ -2,13 +2,64 @@

 All recipe data can be imported and exported as necessary from the UI. Under the admin page you'll find the section for using Backups and Exports. 

-To create an export simple add the tag and the markdown template and click Backup Recipes and your backup will be created on the server. The backup is a standard zipfile containing all the images, json files, and rendered markdown files for each recipe. Markdown files are rendered from jinja2 templates. Adding your own markdown file into the templates folder will automatically show up as an option to select when creating a backup. To view the available variables, open a recipe in the json editor.
+!!! danger
+    As this is still a **BETA** It is recommended that you backup your data often and store in more than one place. Ad-hear to backup best practices with the [3-2-1 Backup Rule](https://en.wikipedia.org/wiki/Backup){:target="_blank"}. Prior to upgrading you **should** perform a backup to limit any data loss.

-To import a backup it must be in your backups folder. If it is in the backup folder it will automatically show up as an source to restore from. Selected the desired backup and import the backup file. 
+!!! tip "Mealie data that is saved on backups"
+    - [x] Recipe Data
+    - [ ] Meal Plan
+    - [x] Site Settings
+    - [x] Custom Pages
+    - [x] User Data
+    - [x] Group Data

-![](../gifs/backup-demo-v1.gif)
+To create an export simply add the tag and the markdown template and click "Create" and your backup will be created on the server. The backup is a standard zipfile containing all the images, json files, and rendered jinaj2 templates for each recipe. To view the available variables, open a recipe in the json editor.

-## Custom Templating
+To import a backup it must be in your backups folder. If it is in the backup folder it will automatically show up as a source to restore from. Selected the desired backup and import the backup file. Backups can be uploaded from the UI as well as added on the file system
+
+## Demo
+
+![](../../assets/gifs/backup-demo-v1.gif)
+
+## API Examples
+You can use the API to create and retrieve backups remotely from any server that can access the Mealie instance. This is useful for easily managing off-site backups via cron-job or other scheduled tasks. You can find interactive documentation for your API at https://your-mealie-instance.com/docs
+
+### curl Example
+Create a backup with curl
+```bash
+curl -X 'POST' \
+  'http://localhost:9000/api/backups/export/database' \
+  -H 'accept: application/json' \
+  -H 'Content-Type: application/json' \
+  -d '{
+  "tag": "July 23rd 2021",
+  "options": {
+    "recipes": true,
+    "settings": true,
+    "themes": true
+  },
+  "templates": [
+    "recipes.md"
+  ]
+}'
+```
+
+### wget Example
+First request a file token with curl:
+```bash
+curl -X 'GET' \
+  'http://localhost:9000/api/backups/{file_name}/download' \
+  -H 'accept: application/json' \
+  -H 'Content-Type: application/json'
+```
+
+Then download the file with wget:
+```bash
+wget http://localhost:9000/api/utils/download?token={fileToken}
+```
+
+
+## Jinja2 Templating
 On export you can select a template to use to render files using the jinja2 syntax. This can be done to export recipes in other formats besides regular .json.Look at this example for rendering a markdown recipe using the jinja2 syntax. 

 ### Input
--- a/docs/docs/documentation/admin/building-pages.md
+++ b/docs/docs/documentation/admin/building-pages.md
@@ -0,0 +1,13 @@
+# Building Pages
+
+!!! warning
+    The page building is still experimental and may change. You can provide feedback on any changes you'd like to see on [github](https://github.com/hay-kot/mealie/discussions/229){:target="_blank"}
+
+Custom pages can be created to organize multiple categories into a single page. Links to your custom pages are displayed on the home page sidebar and accessible by all users, however only Administrators can create or update pages.
+![custom page](../../assets/img/custom-page.webp)
+
+To create a new page. Navigate to the settings page at `/admin/settings` and scroll down to the custom pages section. Here you can create, view, and edit your custom pages. To reorder how they are displayed on the sidebar you can drag and drop the pages into the preferred order.
+![create custom page](../../assets/gifs/create-custom-page-demo.gif)
+
+!!! tip
+    To save the order of pages you must click the save button displayed on the bottom of the Custom Page section. This is not necessary for updating individual page data. 
--- a/docs/docs/documentation/admin/dashboard.md
+++ b/docs/docs/documentation/admin/dashboard.md
@@ -0,0 +1,16 @@
+#Dashboard
+
+The dashboard gives you a quick overview of how your Mealie is doing. There is a 'Recipes' card, an overview of the users and groups, an 'Events' card and a 'Backups' card.
+
+![dashboard](../../assets/img/dashboard.webp)
+
+
+## Recipes
+'Recipes' shows how many recipes you have in your catalogue but also checks if you have any untagged or uncategorized ones. If you click on one of these, you are redirected to the Toolbox where you can further organize these recipes.
+
+## Users
+This gives an overview of the total number of users for your Mealie instance. The 'manage users' and 'manage groups' button will redirect you to the [user-management page](../admin/user-management.md).
+
+## Backups
+Here you can choose to import an older backup from a previous instance. You could also create a custom backup with your own tag where you can choose for a full backup or only some parts like recipes, users,...
+If you click 'create', an automatic backup is generated.
--- a/docs/docs/documentation/admin/migration-imports.md
+++ b/docs/docs/documentation/admin/migration-imports.md
@@ -1,7 +1,8 @@
 # Migration

 ## Chowdown
-To migrate recipes from a Chowdown 
+To migrate recipes from a Chowdown
+ 
  1. Download the code repository as a .zip file
  2. Upload the .zip file in the Chowdown section in Mealie
  3. Select import on the newly available migration. 
--- a/docs/docs/documentation/admin/site-settings.md
+++ b/docs/docs/documentation/admin/site-settings.md
@@ -0,0 +1,19 @@
+# Site Settings 
+Your sites settings panel can only be accessed by administrators. This where you can customize your site for all users.
+
+## Home Page Settings
+| Option                | Description                                                                                                   |
+| --------------------- | ------------------------------------------------------------------------------------------------------------- |
+| Show Recent           | To display the recent recipes section on the home page                                                        |
+| Card Per Section      | The amount of cards displayed in each section on the home page                                                |
+| Home Page Sections    | Category sections to include on the home page                                                                 |
+| Language              | The default site language                                                                                     |
+| First day of the week | The default start day of the week used in Meal Plans                                                          |
+| Custom Pages          | Create a [custom page](../admin/building-pages.md) which appears in the sidebar with the categories you chose |
+
+![Site Settings Image](../../assets/img/site-settings.webp)
+
+
+
+
+
--- a/docs/docs/documentation/admin/user-management.md
+++ b/docs/docs/documentation/admin/user-management.md
@@ -0,0 +1,86 @@
+# User Managemenet
+
+As of version v0.4.0 users have limited functionality, but they will offer more permissions and structure as time goes on. To understand the different systems, see each section below. Note, that by default all users will be assigned the default group. If you're only managing one household you won't need to do anything to set up a new group.
+
+!!! summary "Users and Groups"
+    === ":fontawesome-solid-user-cog: Admins"
+
+        Mealie admins are super users that have access to all user data (excluding passwords). All admins can perform administrative tasks like adding users, resetting user passwords, backing up the database, migrating data, and managing site settings. 
+
+        **Admins Can**
+        
+        - All User Actions
+        - Adjust Site Settings
+        - Create and Update Users
+        - Create and Update Groups
+        - Generate User Sign-up Links
+        - Migrate Data from other Services
+        - Backup Site Data
+
+    === ":fontawesome-solid-user: Users"
+
+        A single user created by an Admin that has basic privileges to edit their profile, create and edit recipes.
+
+        **Users Can**
+
+        - Manage Their Profile
+        - Create, Edit, and Update Recipes
+        - Create, Edit, and Update Mealplans *(By Group)*
+        - Set Mealplan Categories
+        - Create and Schedule Webhooks *(By Group)*
+
+    === ":fontawesome-solid-users: Groups"
+
+        User groups are a collection of users that are associated together. Typically used for separate households sharing a single instance.
+        
+        **Groups Share**
+
+        - Mealplans
+        - Mealplan Settings
+        - Webhooks 
+
+!!! warning
+    As of v0.4.0 any authenticated user is able to perform any action on the backend server through the API. To limit a standard users scope, the pages on the frontend are limited. Proper support for permission structures on the backend API will come in a later version. 
+
+
+## Startup
+On the first startup you'll need to login to Mealie using the default username and password `changeme@email.com` and `MyPassword` or the default set through the env variable. On first login you'll be required to reset your password. After resetting your password you should also change your email address as appropriate. This will be used for logins on all future requests. 
+
+!!! tip 
+    Your default password environmental variable will be the default password for all new users that are created. This is stored in plain text and should not be used **any where** else.
+    
+
+## Creating and Editing Users
+There are two ways to create users in Mealie. 
+
+### Manually Creating a User
+In the Manage Users section you are able to create a user by providing the necessary information in the pop-up dialog. 
+
+![Create User Image](../../assets/img/add-user.webp){: align=right style="height:50%;width:50%"}
+
+- User Name
+- Email
+- User Group
+- If they are an Admin
+
+
+When creating users manually, their password will be set from the default assigned by the ENV variable.
+
+### Sign Up Links
+You can generate sign-up links in the Manage Users section. Select the "create link" button and provide the name of the link and if the user will be an administrator. Once a link is created it will populate in the table where you'll be able to see all active links, delete a link, and copy the link as needed. 
+
+![Sign Up Links Image](../../assets/img/sign-up-links.webp)
+
+!!! tip 
+    When a link is used it is automatically removed from the database.
+
+## Creating Groups
+You can easily create and manage groups via the frontend in the admin panel under "Manage Users". Navigate to the groups tab and you'll find a "create group" button as well as a list of all groups in your database. To create a group, select the "create group" button and provide a name for the new group. Once created you can now assign users to the new group.
+
+![Group Management Panel](../../assets/img/group-manager.png)
+
+!!! tip
+    User Groups can only be deleted if no users are apart of the group. If you want to delete a group, you must assign the users to another group before removing. 
+
+## Password Reset
+If a user forgets their password an administrator is able to reset their password through the user management page. In the user table, select edit. In the popup windows click the "Reset Password" to reset a user's password to the default. This is either 'MyPassword' or set through an environment variable. See the [Installation Page](../getting-started/install.md) for more details on environmental variables 
--- a/docs/docs/documentation/community-guide/.header.md
+++ b/docs/docs/documentation/community-guide/.header.md
@@ -0,0 +1,2 @@
+!!! info
+	This guide was submitted by a community member. Find something wrong? Submit a PR to get it fixed!
--- a/docs/docs/documentation/community-guide/bulk-url-import.md
+++ b/docs/docs/documentation/community-guide/bulk-url-import.md
@@ -0,0 +1,93 @@
+!!! info
+	This guide was submitted by a community member. Find something wrong? Submit a PR to get it fixed!
+
+
+Recipes can be imported in bulk from a file containing a list of URLs. This can be done using the following bash or python scripts with the `list` file containing one URL per line.
+
+#### Bash
+```bash
+#!/bin/bash
+
+function authentification () {
+  auth=$(curl -X 'POST' \
+    "$3/api/auth/token" \
+    -H 'accept: application/json' \
+    -H 'Content-Type: application/x-www-form-urlencoded' \
+    -d 'grant_type=&username='$1'&password='$2'&scope=&client_id=&client_secret=')
+
+    echo $auth |  sed -e 's/.*token":"\(.*\)",.*/\1/'
+}
+
+function import_from_file () {
+  while IFS= read -r line
+  do
+    echo $line
+    curl -X 'POST' \
+      "$3/api/recipes/create-url" \
+      -H "Authorization: Bearer $2" \
+      -H 'accept: application/json' \
+      -H 'Content-Type: application/json' \
+      -d '{"url": "'$line'" }'
+    echo
+  done < "$1"
+}
+
+input="list"
+mail="changeme@email.com"
+password="MyPassword"
+mealie_url=http://localhost:9000
+
+
+token=$(authentification $mail $password $mealie_url)
+import_from_file $input $token $mealie_url
+
+```
+
+#### Python
+```python
+import requests
+import re
+
+def authentification(mail, password, mealie_url):
+  headers = {
+    'accept': 'application/json',
+    'Content-Type': 'application/x-www-form-urlencoded',
+  }
+  data = {
+    'grant_type': '',
+    'username': mail,
+    'password': password,
+    'scope': '',
+    'client_id': '',
+    'client_secret': ''
+  }
+  auth = requests.post(mealie_url + "/api/auth/token", headers=headers, data=data)
+  token = re.sub(r'.*token":"(.*)",.*', r'\1', auth.text)
+  return token
+
+def import_from_file(input_file, token, mealie_url):
+  with open(input_file) as fp:
+    for l in fp:
+      line = re.sub(r'(.*)\n', r'\1', l)
+      print(line)
+      headers = {
+        'Authorization': "Bearer " + token,
+        'accept': 'application/json',
+        'Content-Type': 'application/json'
+      }
+      data = {
+        'url': line
+      }
+      response = requests.post(mealie_url + "/api/recipes/create-url", headers=headers, json=data)
+      print(response.text)
+
+input_file="list"
+mail="changeme@email.com"
+password="MyPassword"
+mealie_url="http://localhost:9000"
+
+
+token = authentification(mail, password, mealie_url)
+import_from_file(input_file, token, mealie_url)
+```
+
--- a/docs/docs/documentation/community-guide/home-assistant.md
+++ b/docs/docs/documentation/community-guide/home-assistant.md
@@ -0,0 +1,34 @@
+!!! info
+	This guide was submitted by a community member. Find something wrong? Submit a PR to get it fixed!
+
+
+In a lot of ways, Home Assistant is why this project exists! Since it Mealie has a robust API it makes it a great fit for interacting with Home Assistant and pulling information into your dashboard.
+
+### Get Todays Meal in Lovelace
+Starting in v0.4.1 you are now able to use the uri `/api/meal-plans/today/image?group_name=Home` to directly access the image to todays meal. This makes it incredible easy to include the image into your Home Assistant Dashboard using the picture entity. 
+
+Here's an example where `sensor.mealie_todays_meal` is pulling in the meal-plan name and I'm using the url to get the image.
+
+![api-extras-gif](../../assets/img/home-assistant-card.png)
+
+```yaml
+type: picture-entity
+entity: sensor.mealie_todays_meal
+name: Dinner Tonight
+show_state: true
+show_name: true
+image: 'http://localhost:9000/api/meal-plans/today/image?group_name=Home'
+style:
+.: |
+    ha-card {
+    max-height: 300px !important;
+    overflow: hidden;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    }
+```
+
+
+!!! tip
+    Due to how Home Assistant works with images, I had to include the additional styling to get the images to not appear distorted. This includes and [additional installation](https://github.com/thomasloven/lovelace-card-mod){:target="_blank"} from HACS. 
--- a/docs/docs/documentation/community-guide/ios.md
+++ b/docs/docs/documentation/community-guide/ios.md
@@ -0,0 +1,40 @@
+# Using iOS Shortcuts with Mealie
+
+!!! info
+	This guide was submitted by a community member. Find something wrong? Submit a PR to get it fixed!
+
+
+![](../../assets/img/iphone-image.png){: align=right style="height:400px;width:400px"}
+
+
+User  [brasilikum](https://github.com/brasilikum){:target="_blank"} opened an issue on the main repo about how they had created an [iOS shortcut](https://github.com/hay-kot/mealie/issues/103){:target="_blank"} for interested users. This is a useful utility for iOS users who browse for recipes in their web browser from their devices.
+
+Don't know what an iOS shortcut is? Neither did I! Experienced iOS users may already be familiar with this utility but for the uninitiated, here is the official Apple explanation:
+
+
+> A shortcut is a quick way to get one or more tasks done with your apps. The Shortcuts app lets you create your own shortcuts with multiple steps. For example, build a “Surf Time” shortcut that grabs the surf report, gives an ETA to the beach, and launches your surf music playlist.
+
+
+Basically it is a visual scripting language that lets a user build an automation in a guided fashion. The automation can be [shared with anyone](https://www.icloud.com/shortcuts/6ae356d5fc644cfa8983a3c90f242fbb){:target="_blank"} but if it is a user creation, you'll have to jump through a few hoops to make an untrusted automation work on your device. In brasilikum's shortcut, you need to make changes for it to work. Recent updates to the project have changed some of the syntax and folder structure since its original creation.
+
+
+![screenshot](../../assets/img/ios-shortcut-image.jpg){: align=right style="height:500;width:400px"}
+
+
+
+!!! tip
+    You may need to change the url depending on which version you're using. Recipe is now plural and there is no trailing "/" at the end of the string.
+    
+    ```
+    api/recipe/create-url/
+    ```
+
+    to
+
+    ```
+    api/recipes/create-url
+    ```
+
+    
+
+Having made those changes, you should now be able to share a website to the shortcut and have mealie grab all the necessary information!
--- a/docs/docs/documentation/community-guide/swag.md
+++ b/docs/docs/documentation/community-guide/swag.md
@@ -0,0 +1,92 @@
+# Using SWAG as Reverse Proxy
+
+!!! info
+	This guide was submitted by a community member. Find something wrong? Submit a PR to get it fixed!
+
+
+
+To make the setup of a Reverse Proxy much easier, Linuxserver.io developed [SWAG](https://github.com/linuxserver/docker-swag){:target="_blank"}  
+SWAG - Secure Web Application Gateway (formerly known as letsencrypt, no relation to Let's Encrypt™) sets up an Nginx web server and reverse proxy with PHP support and a built-in certbot client that automates free SSL server certificate generation and renewal processes (Let's Encrypt and ZeroSSL). It also contains fail2ban for intrusion prevention.
+
+## Step 1: Get a domain
+
+The first step is to grab a dynamic DNS if you don't have your own subdomain already. You can get this from for example [DuckDNS](https://www.duckdns.org){:target="_blank"}.
+
+## Step 2: Set-up SWAG
+
+Then you will need to set up SWAG, the variables of the docker-compose are explained on the Github page of [SWAG](https://github.com/linuxserver/docker-swag){:target="_blank"}.
+This is an example of how to set it up using duckdns and docker-compose.
+
+!!! example "docker-compose.yml"
+```yaml
+version: "2.1"
+services:
+swag:
+image: ghcr.io/linuxserver/swag
+container_name: swag
+cap_add:
+- NET_ADMIN
+environment:
+- PUID=1000
+- PGID=1000
+- TZ=Europe/Brussels
+- URL=<mydomain.duckdns>
+- SUBDOMAINS=wildcard
+- VALIDATION=duckdns
+- CERTPROVIDER= #optional
+- DNSPLUGIN= #optional
+- DUCKDNSTOKEN=<duckdnstoken>
+- EMAIL=<e-mail> #optional
+- ONLY_SUBDOMAINS=false #optional
+- EXTRA_DOMAINS=<extradomains> #optional
+- STAGING=false #optional
+volumes:
+- /etc/config/swag:/config
+ports:
+- 443:443
+restart: unless-stopped
+
+```
+
+Don't forget to change the <code>mydomain.duckns</code> into your personal domain and the <code>duckdnstoken</code> into your token and remove the brackets.
+
+## Step 3: Change the config files
+
+Navigate to the config folder of SWAG and head to <code>proxy-confs</code>. If you used the example above, you should navigate to: <code>/etc/config/swag/nginx/proxy-confs/</code>.
+There are a lot of preconfigured files to use for different apps such as radarr,sonarr,overseerr,...
+
+To use the bundled configuration file, simply rename <code>mealie.subdomain.conf.sample</code> in the proxy-confs folder to <code>mealie.subdomain.conf</code>.
+Alternatively, you can create a new file <code>mealie.subdomain.conf</code> in proxy-confs with the following configuration:
+
+!!! example "mealie.subdomain.conf"
+```yaml
+    server {
+    listen 443 ssl http2;
+    listen [::]:443 ssl http2;
+
+    	server_name mealie.*;
+
+    	include /config/nginx/ssl.conf;
+
+    	client_max_body_size 0;
+
+    	location / {
+        	include /config/nginx/proxy.conf;
+        	include /config/nginx/resolver.conf;
+        	set $upstream_app mealie;
+        	set $upstream_port 80;
+        	set $upstream_proto http;
+        	proxy_pass $upstream_proto://$upstream_app:$upstream_port;
+    		}
+
+	}	
+```
+
+## Step 4: Port-forward port 443
+
+Since SWAG allows you to set up a secure connection, you will need to open port 443 on your router for encrypted traffic. This is way more secure than port 80 for http.
+
+## Step 5: Restart SWAG
+
+When you change anything in the config of Nginx, you will need to restart the container using <code>docker restart swag</code>.
+If everything went well, you can now access mealie on the subdomain you configured: mealie.mydomain.duckdns.org
--- a/Show More
+++ b/Show More
				`@@ -1 +0,0 @@`
				`http://www.cookingforkeeps.com/2013/02/05/blue-cheese-stuffed-turkey-meatballs-with-raspberry-balsamic-glaze-2/`
				`@@ -1 +0,0 @@`
				`docker-compose -f docker-compose.dev.yml -p dev-mealie up --build`