chore: 0.20.4 release preperations

Follow-up for a62b57ac62

.dockerignore

@@ -0,0 +1,9 @@
+files/
+dist/
+logs/
+
+Dockerfile
+docker-manifest.tmpl
+docker-manifest-unstable.tmpl
+*.db
+*.zip

.editorconfig

@@ -10,7 +10,7 @@ charset = utf-8
 trim_trailing_whitespace = false
 insert_final_newline = false
 
-[*.vue]
+[*.go]
 indent_style = tab
 
 [*.{yaml,yml}]
@@ -19,11 +19,4 @@ indent_size = 2
 
 [*.json]
 indent_style = space
-indent_size = 2
-
-[*.{scss,css}]
-indent_style = space
-indent_size = 2
-
-[.nvmrc]
-insert_final_newline = false
+indent_size = 4

.env.local.example

@@ -1,13 +0,0 @@
-# (1) Duplicate this file and remove the '.example' suffix.
-# Naming this file '.env.local' is a Vite convention to prevent accidentally
-# submitting to git.
-# For more info see: https://vitejs.dev/guide/env-and-mode.html#env-files
-
-# (2) Comment in and adjust the values as needed.
-
-# VITE_IS_ONLINE=true
-# VITE_WORKBOX_DEBUG=false
-# SENTRY_AUTH_TOKEN=YOUR_TOKEN
-# SENTRY_ORG=vikunja
-# SENTRY_PROJECT=frontend-oss
-# VIKUNJA_FRONTEND_BASE=/custom-subpath

.envrc

@@ -1 +0,0 @@
-use flake

.eslintrc.cjs

@@ -1,58 +0,0 @@
-/* eslint-env node */
-require("@rushstack/eslint-patch/modern-module-resolution")
-
-module.exports = {
-	'root': true,
-	'env': {
-		'browser': true,
-		'es2022': true,
-		'node': true,
-		'vue/setup-compiler-macros': true,
-	},
-	'extends': [
-		'eslint:recommended',
-		'plugin:vue/vue3-essential',
-		'@vue/eslint-config-typescript/recommended',
-	],
-	'rules': {
-		'vue/html-quotes': [
-			'error',
-			'double',
-		],
-		'quotes': [
-			'error',
-			'single',
-		],
-		'comma-dangle': [
-			'error',
-			'always-multiline',
-		],
-		'semi': [
-			'error',
-			'never',
-		],
-
-		// see https://segmentfault.com/q/1010000040813116/a-1020000041134455 (original in chinese)
-		'no-unused-vars': 'off',
-		'@typescript-eslint/no-unused-vars': ['error', { vars: 'all', args: 'after-used', ignoreRestSiblings: true }],
-
-		'vue/multi-word-component-names': 0,
-		// disabled until we have support for reactivityTransform
-		// See https://github.com/vuejs/eslint-plugin-vue/issues/1948
-		// see also setting in `vite.config`
-		'vue/no-setup-props-destructure': 0,
-	},
-	'parser': 'vue-eslint-parser',
-	'parserOptions': {
-		'parser': '@typescript-eslint/parser',
-		'ecmaVersion': 2022,
-		'sourceType': 'module',
-	},
-	'ignorePatterns': [
-		'*.test.*',
-		'cypress/*',
-	],
-	'globals': {
-		'defineProps': 'readonly',
-	},
-}

.gitea/issue_template.md

@@ -1,44 +0,0 @@
-<!--
-
-Please fill out this issue template to report a bug.
-If you want to propose a new feature, please open a discussion thread in the forum: https://community.vikunja.io
-
--->
-
-**Version information:**
-
-Frontend Version:
-API Version: 
-Browser and OS Version:
-
-**Steps to reproduce:**
-
-<!--
-Add clear steps to reproduce the bug. Provide screenshots where applicable.
--->
-
-1. 
-2.
-...
-
-**Expected behavior:**
-
-<!--
-Describe what happened.
--->
-
-
-
-**Actual behavior:**
-
-<!--
-Describe what happened instead.
--->
-
-
-
-**Checklist:**
-
-* [ ] I have provided all required information
-* [ ] I am using the latest release or the latest unstable build
-* [ ] I was able to reproduce the bug on [try](https://try.vikunja.io)

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -1,7 +1,6 @@
 name: Bug Report
 description: Found something you weren't expecting? Report it here!
-labels:
-  - kind/bug
+labels: kind/bug
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/config.yml

@@ -1,8 +1,8 @@
 blank_issues_enabled: false
 contact_links:
-  - name: API issues
-    url: https://code.vikunja.io/api/issues
-    about: This is the frontend repo. Please open api-related bug reports and discussions in the api 0repo. Not sure if your issue is frontend or api? Ask in Matrix or the forum first.
+  - name: Frontend issues
+    url: https://code.vikunja.io/frontend/issues
+    about: This is the API repo. Please open frontend-related bug reports and discussions in the frontend repo. Not sure if you issue is frontend or api? Ask in Matrix or the forum first.
   - name: Forum
     url: https://community.vikunja.io/
     about: Feature Requests, Questions, configuration or deployment problems should be discussed in the forum.

.gitignore

@@ -1,41 +1,29 @@
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-lerna-debug.log*
-stats.html
-
-node_modules
-.DS_Store
-/dist*
-coverage
-*.zip
-.direnv/
-
-# Test files
-cypress/screenshots
-cypress/videos
-
-# local env files
-.env.local
-.env.*.local
-
-# Editor directories and files
-.vscode
-.idea
-*.suo
-*.ntvs*
-*.njsproj
-*.sln
-*.sw*
-!rollup.sw.js
-
-
-# Local Netlify folder
-.netlify
-
-# histoire
-.histoire
+.idea/
+.idea/*/*
+.idea/httpRequests
+config.yml
+config.yaml
+!docs/config.yml
+!.github/ISSUE_TEMPLATE/config.yml
+!.gitea/ISSUE_TEMPLATE/config.yml
+docs/themes/
+*.db
+Run
+dist/
+cover.*
+/vikunja
+Test_*
+bin/
+secrets
+*.deb
+debian/
+logs/
+docs/public/
+docs/resources/
+pkg/static/templates_vfsdata.go
+files/
+!pkg/files/
+vikunja-dump*
+vendor/
+os-packages/
+mage_output_file.go

.golangci.yml

@@ -0,0 +1,93 @@
+run:
+  timeout: 15m
+  tests: true
+
+linters:
+  enable:
+    - megacheck
+    - govet
+    - goconst
+    - gocritic
+    - gocyclo
+    - goerr113
+    - goheader
+    - gofmt
+    - goimports
+    - revive
+    - misspell
+  disable:
+    - scopelint # Obsolete, using exportloopref instead
+    - durationcheck
+  presets:
+    - bugs
+    - unused
+  fast: false
+
+linters-settings:
+  nestif:
+    min-complexity: 6
+  goheader:
+    template-path: code-header-template.txt
+
+issues:
+  exclude-rules:
+    # Exclude some linters from running on tests files.
+    - path: _test\.go
+      linters:
+        - gocyclo
+        - deadcode
+        - errorlint
+    - path: pkg/integrations/*
+      linters:
+        - gocyclo
+        - deadcode
+        - varcheck
+        - unparam
+        - bodyclose
+    - path: pkg/integrations/*
+      text: "unlambda"
+      linters:
+        - gocritic
+    - path: pkg/modules/background/unsplash/unsplash\.go
+      linters:
+        - bodyclose
+    - path: pkg/migration/*
+      linters:
+        - exhaustive
+        - goconst
+        - goerr113
+    - path: pkg/models/task_collection_filter\.go
+      linters:
+        - exhaustive
+    - path: pkg/utils/random_string\.go
+      text: "G404:" # We don't care about cryptographically secure randomness when we're using that utility function.
+      linters:
+        - gosec
+    - path: pkg/modules/dump/*
+      linters:
+        - goerr113
+    - path: pkg/
+      text: "err113: do not define dynamic errors, use wrapped static errors instead:"
+      linters:
+        - goerr113
+    - text: "commentFormatting: put a space between `//` and comment text"
+      linters:
+        - gocritic
+    - path: pkg/modules/migration
+      linters:
+        - gocyclo
+    - path: pkg/routes/api/v1/docs.go
+      linters:
+        - goheader
+    - text: "Missed string"
+      linters:
+        - goheader
+    - path: pkg/.*/error.go
+      linters:
+        - errorlint
+    - path: pkg/models/favorites\.go
+      linters:
+        - nilerr
+    - path: pkg/models/events\.go
+      linters:
+        - musttag

.npmrc

@@ -1,2 +0,0 @@
-auto-install-peers=true
-fetch-timeout=100000

.nvmrc

@@ -1 +0,0 @@
-18.15.0

.vscode.example/extensions.json

@@ -1,13 +0,0 @@
-{
-  "recommendations": [
-    "codezombiech.gitignore",
-    "dbaeumer.vscode-eslint",
-    "editorconfig.editorconfig",
-    "vue.volar",
-    "vue.vscode-typescript-vue-plugin",
-    "lokalise.i18n-ally",
-    "mgmcdermott.vscode-language-babel",
-    "mikestead.dotenv",
-    "Syler.sass-indented"
-  ]
-}

.vscode.example/settings.json

@@ -1,34 +0,0 @@
-{
-  "eslint.packageManager": "pnpm",
-  "editor.formatOnSave": false,
-  "editor.codeActionsOnSave": {
-    "source.fixAll": true
-  },
-  "eslint.format.enable": true,
-	"[javascript]": {
-		"editor.defaultFormatter": "dbaeumer.vscode-eslint"
-	},
-	"[typescript]": {
-		"editor.defaultFormatter": "dbaeumer.vscode-eslint"
-	},
-
-  // https://eslint.vuejs.org/user-guide/#editor-integrations
-  "eslint.validate": [
-    "javascript",
-    "javascriptreact",
-    "vue"
-  ],
-
-  "volar.completion.preferredTagNameCase": "pascal",
-
-  // disable vetur in case it is installed
-  "vetur.validation.template": false,
-
-  // i18n ally
-  "i18n-ally.localesPaths": [
-    "src/i18n/lang"
-  ],
-  "i18n-ally.sortKeys": true,
-  "i18n-ally.keepFulfilled": true,
-  "i18n-ally.keystyle": "nested"
-}

.vscode/launch.json

@@ -0,0 +1,17 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Launch",
+            "type": "go",
+            "request": "launch",
+            "mode": "auto",
+            "program": "${workspaceRoot}",
+            "env": {},
+            "args": []
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "go.testEnvVars": {
+        "VIKUNJA_SERVICE_ROOTPATH": "${workspaceRoot}"
+    }
+}

Dockerfile

@@ -3,66 +3,40 @@
 #  │─││ │││  │ │
 #  ┘─┘┘─┘┘┘─┘┘─┘
 
-FROM --platform=$BUILDPLATFORM node:18-alpine AS builder
+FROM --platform=$BUILDPLATFORM techknowlogick/xgo:go-1.20.0 AS builder
 
-WORKDIR /build
-
-ARG USE_RELEASE=false
-ARG RELEASE_VERSION=main
-ENV PNPM_CACHE_FOLDER .cache/pnpm/
-
-COPY package.json ./
-COPY pnpm-lock.yaml ./
-
-RUN if [ "$USE_RELEASE" != true ]; then \
-      # https://pnpm.io/installation#using-corepack
-      corepack enable && \
-      pnpm install; \
-    fi
+RUN go install github.com/magefile/mage@latest && \
+    mv /go/bin/mage /usr/local/go/bin
 
+WORKDIR /go/src/code.vikunja.io/api
 COPY . ./
 
-RUN if [ "$USE_RELEASE" != true ]; then \
-      apk add --no-cache --virtual .build-deps git jq && \
-      git describe --tags --always --abbrev=10 | sed 's/-/+/; s/^v//; s/-g/-/' | \
-      xargs -0 -I{} jq -Mcnr --arg version {} '{VERSION:$version}' | \
-      tee src/version.json && \
-      apk del .build-deps; \
-    fi
+ARG TARGETOS TARGETARCH TARGETVARIANT
 
-RUN if [ "$USE_RELEASE" = true ]; then \
-      wget "https://dl.vikunja.io/frontend/vikunja-frontend-${RELEASE_VERSION}.zip" -O frontend-release.zip && \
-      unzip frontend-release.zip -d dist/; \
-    else \
-      # we don't use corepack prepare here by intend since
-      # we have renovate to keep our dependencies up to date
-      # Build the frontend
-      pnpm run build; \
-  fi
+RUN mage build:clean && \
+    mage release:xgo "${TARGETOS}/${TARGETARCH}/${TARGETVARIANT}"
 
-#  ┌┐┐┌─┐o┌┐┐┐ │
-#  ││││ ┬││││┌┼┘
-#  ┘└┘┘─┘┘┘└┘┘ └
+#  ┬─┐┬ ┐┌┐┐┌┐┐┬─┐┬─┐
+#  │┬┘│ │││││││├─ │┬┘
+#  ┘└┘┘─┘┘└┘┘└┘┴─┘┘└┘
 
-FROM nginx:stable-alpine AS runner
-WORKDIR /usr/share/nginx/html
+# The actual image
+# Note: I wanted to use the scratch image here, but unfortunatly the go-sqlite bindings require cgo and
+# because of this, the container would not start when I compiled the image without cgo.
+FROM alpine:3.16 AS runner
 LABEL maintainer="maintainers@vikunja.io"
+WORKDIR /app/vikunja
+ENTRYPOINT [ "/sbin/tini", "-g", "--", "/entrypoint.sh" ]
+EXPOSE 3456
 
-ENV VIKUNJA_HTTP_PORT 80
-ENV VIKUNJA_HTTP2_PORT 81
-ENV VIKUNJA_LOG_FORMAT main
-ENV VIKUNJA_API_URL /api/v1
-ENV VIKUNJA_SENTRY_ENABLED false
-ENV VIKUNJA_SENTRY_DSN https://85694a2d757547cbbc90cd4b55c5a18d@o1047380.ingest.sentry.io/6024480
+ENV VIKUNJA_SERVICE_ROOTPATH=/app/vikunja/
+ENV PUID 1000
+ENV PGID 1000
 
-COPY docker/injector.sh /docker-entrypoint.d/50-injector.sh
-COPY docker/ipv6-disable.sh /docker-entrypoint.d/60-ipv6-disable.sh
-COPY docker/nginx.conf /etc/nginx/nginx.conf
-COPY docker/templates/. /etc/nginx/templates/
-# copy compiled files from stage 1
-COPY --from=builder /build/dist ./
-# manage permissions
-RUN chmod 0755 /docker-entrypoint.d/*.sh /etc/nginx/templates && \
-    chmod -R 0644 /etc/nginx/nginx.conf && \
-    chown -R nginx:nginx ./ /etc/nginx/conf.d /etc/nginx/templates && \
-    rm -f /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh
+RUN apk --update --no-cache add tzdata tini shadow && \
+    addgroup vikunja && \
+    adduser -s /bin/sh -D -G vikunja vikunja -h /app/vikunja -H
+COPY docker/entrypoint.sh /entrypoint.sh
+RUN chmod 0755 /entrypoint.sh && mkdir files
+
+COPY --from=builder /build/vikunja-* vikunja

README.md

@@ -1,53 +1,61 @@
-# Web frontend for Vikunja
+<img src="https://vikunja.io/images/vikunja-logo.svg" alt="" style="display: block;width: 50%;margin: 0 auto;" width="50%"/>
 
-> The todo app to organize your life.
-
-[![Build Status](https://drone.kolaente.de/api/badges/vikunja/frontend/status.svg)](https://drone.kolaente.de/vikunja/frontend)
+[![Build Status](https://drone.kolaente.de/api/badges/vikunja/api/status.svg)](https://drone.kolaente.de/vikunja/api)
 [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](LICENSE)
-[![Download](https://img.shields.io/badge/download-v0.20.5-brightgreen.svg)](https://dl.vikunja.io)
-[![Translation](https://badges.crowdin.net/vikunja/localized.svg)](https://crowdin.com/project/vikunja)
+[![Download](https://img.shields.io/badge/download-v0.20.4-brightgreen.svg)](https://dl.vikunja.io)
+[![Docker Pulls](https://img.shields.io/docker/pulls/vikunja/api.svg)](https://hub.docker.com/r/vikunja/api/)
+[![Swagger Docs](https://img.shields.io/badge/swagger-docs-brightgreen.svg)](https://try.vikunja.io/api/v1/docs)
+[![Go Report Card](https://goreportcard.com/badge/kolaente.dev/vikunja/api)](https://goreportcard.com/report/kolaente.dev/vikunja/api)
 
-This is the web frontend for Vikunja, written in Vue.js.
+# Vikunja API
 
-Take a look at [our roadmap](https://my.vikunja.cloud/share/UrdhKPqumxDXUbYpEGJLSIyNTwAnbBzVlwdDpRbv/auth) (hosted on Vikunja!) for a list of things we're currently working on!
+> The Todo-app to organize your life.
+
+# Table of contents
+
+* [Security Reports](#security-reports)
+* [Features](#features)
+* [Docs](#docs)
+* [Roadmap](#roadmap)
+* [Contributing](#contributing)
+* [License](#license)
 
 ## Security Reports
 
 If you find any security-related issues you don't want to disclose publicly, please use [the contact information on our website](https://vikunja.io/contact/#security).
 
-## Docker
+## Features
 
-There is a [docker image available](https://hub.docker.com/r/vikunja/api) with support for http/2 and aggressive caching enabled.
-In order to build it from sources run the command below. (Docker >= v19.03)
+* Create TODO lists with tasks
+  * Reminder for tasks
+* Namespaces: A "group" which bundles multiple lists
+* Share lists and namespaces with teams and users with granular permissions
+* Plenty of details for tasks
 
-```shell
-export DOCKER_BUILDKIT=1
-docker build -t vikunja/frontend .
-```
+See [the features page](https://vikunja.io/en/features/) on our website for a more exaustive list or 
+try it on [try.vikunja.io](https://try.vikunja.io)!
 
-Refer to Refer [to multi-platform documentation](https://docs.docker.com/build/building/multi-platform/) in order to build for the different platform.
+## Docs
 
-## Project setup
+* [Installing](https://vikunja.io/docs/installing/)
+* [Build from source](https://vikunja.io/docs/build-from-sources/)
+* [Development setup](https://vikunja.io/docs/development/)
+* [Magefile](https://vikunja.io/docs/magefile/)
+* [Testing](https://vikunja.io/docs/testing/)
 
-```shell
-pnpm install
-```
+All docs can be found on [the Vikunja home page](https://vikunja.io/docs/).
 
-### Compiles and hot-reloads for development
+### Roadmap
 
-```shell
-pnpm run serve
-```
+See [the roadmap](https://my.vikunja.cloud/share/QFyzYEmEYfSyQfTOmIRSwLUpkFjboaBqQCnaPmWd/auth) (hosted on Vikunja!) for more!
 
-### Compiles and minifies for production
+* [ ] [Mobile apps](https://code.vikunja.io/app) (separate repo) *In Progress*
+* [ ] [Webapp](https://code.vikunja.io/frontend) (separate repo) *In Progress*
 
-```shell
-pnpm run build
-```
+## Contributing
 
-### Lints and fixes files
+Fork -> Push -> Pull-Request. Also see the [dev docs](https://vikunja.io/docs/development/) for more info.
 
-```shell
-pnpm run lint
-```
+## License
 
+This project is licensed under the AGPLv3 License. See the [LICENSE](LICENSE) file for the full license text.

REST-Tests/attachment_from_scratch.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+curl -X POST http://localhost:3456/api/v1/register -H 'Content-Type: application/json' -d '{"username":"demo","password":"demo","email":"demo@vikunja.io"}'
+BEARER=`curl -X POST -H 'Content-Type: application/json' -d '{"username": "demo", "password":"demo"}' localhost:3456/api/v1/login | jq -r '.token'`
+
+echo "Bearer: $BEARER"
+
+curl -X POST localhost:3456/api/v1/tokenTest -H "Authorization: Bearer $BEARER"
+
+curl -X PUT localhost:3456/api/v1/namespaces/1/lists  -H 'Content-Type: application/json' -H "Authorization: Bearer $BEARER" -d '{"title":"lorem"}'
+curl -X PUT localhost:3456/api/v1/lists/1  -H 'Content-Type: application/json' -H "Authorization: Bearer $BEARER" -d '{"text":"lorem"}'
+curl -X PUT -H "Authorization: Bearer $BEARER" localhost:3456/api/v1/tasks/1/attachments -F 'files=@/home/konrad/Pictures/Wallpaper/greg-rakozy-_Q4mepyyjMw-unsplash.jpg'

REST-Tests/auth.http

@@ -0,0 +1,29 @@
+### Authorization by token, part 1. Retrieve and save token.
+POST http://localhost:8080/api/v1/login
+Content-Type: application/json
+
+{
+  "username": "user3",
+  "password": "1234"
+}
+
+> {% client.global.set("auth_token", response.body.token); %}
+
+### Register
+
+POST http://localhost:8080/api/v1/register
+Content-Type: application/json
+
+{
+  "username": "user",
+  "password": "1234",
+  "email": "5@knt.li"
+}
+
+###
+# Token test
+POST http://localhost:8080/api/v1/tokenTest
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+###

REST-Tests/labels.http

@@ -0,0 +1,70 @@
+# Get all labels
+GET http://localhost:8080/api/v1/labels
+Authorization: Bearer {{auth_token}}
+
+###
+# Add a new label
+PUT http://localhost:8080/api/v1/labels
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{
+  "title": "test5"
+}
+
+###
+# Delete a label
+DELETE http://localhost:8080/api/v1/labels/6
+Authorization: Bearer {{auth_token}}
+
+###
+# Update a label
+POST http://localhost:8080/api/v1/labels/1
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{
+  "title": "testschinkenbrot",
+  "description": "käsebrot"
+}
+
+###
+# Get one label
+GET http://localhost:8080/api/v1/labels/1
+Authorization: Bearer {{auth_token}}
+
+###
+# Get all labels on a task
+GET http://localhost:8080/api/v1/tasks/3565/labels
+Authorization: Bearer {{auth_token}}
+
+###
+# Add a new label to a task
+PUT http://localhost:8080/api/v1/tasks/35236365/labels
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{
+  "label_id": 1
+}
+
+###
+# Delete a label from a task
+DELETE http://localhost:8080/api/v1/tasks/3565/labels/1
+Authorization: Bearer {{auth_token}}
+
+###
+# Add a new label to a task
+POST http://localhost:8080/api/v1/tasks/3565/labels/bulk
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{
+  "labels": [
+    {"id": 1},
+    {"id": 2},
+    {"id": 3}
+  ]
+}
+
+###

REST-Tests/lists.http

@@ -0,0 +1,177 @@
+# Get all lists
+GET http://localhost:8080/api/v1/namespaces/35/lists
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Get one list
+GET http://localhost:8080/api/v1/lists/3
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Add a new list
+PUT http://localhost:8080/api/v1/namespaces/35/lists
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{
+  "title": "test"
+}
+
+###
+
+# Add a new item
+PUT http://localhost:8080/api/v1/lists/1
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{
+  "text": "Task",
+  "description": "Schinken"
+}
+
+###
+
+# Delete a task from a list
+DELETE http://localhost:8080/api/v1/lists/14
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Get all teams who have access to that list
+GET http://localhost:8080/api/v1/lists/28/teams
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Give a team access to that list
+PUT http://localhost:8080/api/v1/lists/1/teams
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{"team_id":2, "right": 1}
+
+###
+
+# Update a teams access to that list
+POST http://localhost:8080/api/v1/lists/1/teams/2
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{"right": 0}
+
+###
+
+# Delete a team from a list
+DELETE http://localhost:8080/api/v1/lists/10235/teams/1
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Delete a team from a list
+DELETE http://localhost:8080/api/v1/lists/10235/teams/1
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Get all users who have access to that list
+GET http://localhost:8080/api/v1/lists/28/users
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Give a user access to that list
+PUT http://localhost:8080/api/v1/lists/3/users
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{"userID":"user4", "right":1}
+
+###
+
+# Update a users access to that list
+POST http://localhost:8080/api/v1/lists/30/users/3
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{"right":2}
+
+###
+
+# Delete a user from a list
+DELETE http://localhost:8080/api/v1/lists/28/users/3
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Get all pending tasks
+GET http://localhost:8080/api/v1/tasks/all
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Get all pending tasks with priorities
+GET http://localhost:8080/api/v1/tasks/all?sort=priorityasc
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Get all pending tasks in a range
+GET http://localhost:8080/api/v1/tasks/all/dueadateasc/1546784000/1548784000
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Get all pending tasks in caldav
+GET http://localhost:8080/api/v1/tasks/caldav
+#Authorization: Bearer {{auth_token}}
+
+###
+
+# Update a task
+POST http://localhost:8080/api/v1/tasks/3565
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{
+  "priority": 0
+}
+
+###
+
+# Bulk update multiple tasks at once
+POST http://localhost:8080/api/v1/tasks/bulk
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{
+  "task_ids": [3518,3519,3521],
+  "text":"bulkupdated"
+}
+
+###
+# Get all assignees
+GET http://localhost:8080/api/v1/tasks/3565/assignees
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Add a bunch of assignees
+PUT http://localhost:8080/api/v1/tasks/3565/assignees/bulk
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{
+  "assignees": [
+    {"id": 17}
+  ]
+}
+
+###
+
+# Get all users who have access to a list
+GET http://localhost:8080/api/v1/lists/3/users
+Authorization: Bearer {{auth_token}}
+
+###

REST-Tests/namespaces.http

@@ -0,0 +1,71 @@
+# Get all namespaces
+GET http://localhost:8080/api/v1/namespaces
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Get one namespaces
+GET http://localhost:8080/api/v1/namespaces/-1
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Get all users who have access to that namespace
+GET http://localhost:8080/api/v1/namespaces/12/users
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Give a user access to that namespace
+PUT http://localhost:8080/api/v1/namespaces/1/users
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{"user_id":3, "right": 0}
+
+###
+
+# Update a users access to that namespace
+POST http://localhost:8080/api/v1/namespaces/1/users/3
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{"right": 2}
+
+###
+
+# Delete a user from a namespace
+DELETE http://localhost:8080/api/v1/namespaces/1/users/2
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Get all teams who have access to that namespace
+GET http://localhost:8080/api/v1/namespaces/1/teams
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Give a team access to that namespace
+PUT http://localhost:8080/api/v1/namespaces/1/teams
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{"team_id":3, "right": 0}
+
+###
+
+# Update a teams access to that namespace
+POST http://localhost:8080/api/v1/namespaces/1/teams/1
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{"right": 0}
+
+###
+
+# Delete a team from a namespace
+DELETE http://localhost:8080/api/v1/namespaces/1/teams/2
+Authorization: Bearer {{auth_token}}
+
+###

REST-Tests/teams.http

@@ -0,0 +1,29 @@
+# Get all teams
+GET http://localhost:8080/api/v1/teams
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Get one team
+GET http://localhost:8080/api/v1/teams/28
+Authorization: Bearer {{auth_token}}
+
+###
+
+# Add a new member to that team
+PUT http://localhost:8080/api/v1/teams/28/members
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{
+  "user_id": 2
+}
+
+###
+
+# Delete a member from a team
+DELETE http://localhost:8080/api/v1/teams/28/members/2
+Authorization: Bearer {{auth_token}}
+
+###
+

REST-Tests/users.http

@@ -0,0 +1,53 @@
+
+# Get all users
+GET http://localhost:8080/api/v1/user
+Authorization: Bearer {{auth_token}}
+
+######
+# Search for a user
+GET http://localhost:8080/api/v1/users?s=3
+Authorization: Bearer {{auth_token}}
+
+###
+
+## Update password
+
+POST http://localhost:8080/api/v1/user/password
+Authorization: Bearer {{auth_token}}
+Content-Type: application/json
+
+{
+  "old_password": "1234",
+  "new_password": "1234"
+}
+
+### Request a password to reset a password
+POST http://localhost:8080/api/v1/user/password/token
+Content-Type: application/json
+Accept: application/json
+
+{
+  "email": "k@knt.li"
+}
+
+### Request a token to reset a password
+POST http://localhost:8080/api/v1/user/password/reset
+Content-Type: application/json
+Accept: application/json
+
+{
+  "token": "eAsZzakgqARnjzXHqsHqZtSUKuiOhoJjHANhgTxUIDBSalhbtdpAdLeywGXzVDBuRQGNpHdMxoHXhLVSlzpJsFvuoJgMdkhRhkNhaQXfufuZCdtUlerZHSJQLgYMUryHIxIREcmZLtWoZVrYyARkCvkyFhcGtoCwQOEjAOEZMQQuxTVoGYfAqcfNggQnerUcXCiRIgRtkusXSnltomhaeyRwAbrckXFeXxUjslgplSGqSTOqJTYuhrSzAVTwNvuYyvuXLaZoNnJEyeVDWlRydnxfgUQjQZOKwCBRWVQPKpZhlslLUyUAMsRQkHITkruQCjDnOGCCRsSNplbNCEuDmMfpWYHSQAcQIDZtbQWkxzpfmHDMQvvKPPrxEnrTErlvTfKDKICFYPQxXNpNE",
+  "new_password": "1234"
+}
+
+### Confirm a users email address
+
+POST http://localhost:8080/api/v1/user/confirm
+Content-Type: application/json
+Accept: application/json
+
+{
+  "token": ""
+}
+
+###

build/after-install.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+
+systemctl enable vikunja.service
+
+# Fix the config to contain proper values
+NEW_SECRET=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)
+sed -i "s/<jwt-secret>/$NEW_SECRET/g" /etc/vikunja/config.yml
+sed -i "s/<rootpath>/\/opt\/vikunja\//g" /etc/vikunja/config.yml
+sed -i "s/Path: \"\.\/vikunja.db\"/Path: \"\\/opt\/vikunja\/vikunja.db\"/g" /etc/vikunja/config.yml

build/reprepro-dist-conf

@@ -0,0 +1,8 @@
+Origin: dl.vikunja.io
+Label: Vikunja
+Codename: buster
+Architectures: amd64
+Components: main
+Description: The debian repo for Vikunja builds.
+SignWith: yes
+Pull: buster

code-header-template.txt

@@ -0,0 +1,15 @@
+Vikunja is a to-do list application to facilitate your life.
+Copyright 2018-2021 Vikunja and contributors. All rights reserved.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public Licensee as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public Licensee for more details.
+
+You should have received a copy of the GNU Affero General Public Licensee
+along with this program.  If not, see <https://www.gnu.org/licenses/>.

config.yml.sample

@@ -0,0 +1,339 @@
+service:
+  # This token is used to verify issued JWT tokens.
+  # Default is a random token which will be generated at each startup of vikunja.
+  # (This means all already issued tokens will be invalid once you restart vikunja)
+  JWTSecret: "<jwt-secret>"
+  # The duration of the issed JWT tokens in seconds.
+  # The default is 259200 seconds (3 Days).
+  jwtttl: 259200
+  # The duration of the "remember me" time in seconds. When the login request is made with 
+  # the long param set, the token returned will be valid for this period.
+  # The default is 2592000 seconds (30 Days).
+  jwtttllong: 2592000
+  # The interface on which to run the webserver
+  interface: ":3456"
+  # Path to Unix socket. If set, it will be created and used instead of tcp
+  unixsocket:
+  # Permission bits for the Unix socket. Note that octal values must be prefixed by "0o", e.g. 0o660
+  unixsocketmode:
+  # The URL of the frontend, used to send password reset emails.
+  frontendurl: ""
+  # The base path on the file system where the binary and assets are.
+  # Vikunja will also look in this path for a config file, so you could provide only this variable to point to a folder
+  # with a config file which will then be used.
+  rootpath: <rootpath>
+  # Path on the file system to serve static files from. Set to the path of the frontend files to host frontend alongside the api.
+  staticpath: ""
+  # The max number of items which can be returned per page
+  maxitemsperpage: 50
+  # Enable the caldav endpoint, see the docs for more details
+  enablecaldav: true
+  # Set the motd message, available from the /info endpoint
+  motd: ""
+  # Enable sharing of lists via a link
+  enablelinksharing: true
+  # Whether to let new users registering themselves or not
+  enableregistration: true
+  # Whether to enable task attachments or not
+  enabletaskattachments: true
+  # The time zone all timestamps are in. Please note that time zones have to use [the official tz database names](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). UTC or GMT offsets won't work.
+  timezone: GMT
+  # Whether task comments should be enabled or not
+  enabletaskcomments: true
+  # Whether totp is enabled. In most cases you want to leave that enabled.
+  enabletotp: true
+  # If not empty, enables logging of crashes and unhandled errors in sentry.
+  sentrydsn: ''
+  # If not empty, this will enable `/test/{table}` endpoints which allow to put any content in the database.
+  # Used to reset the db before frontend tests. Because this is quite a dangerous feature allowing for lots of harm,
+  # each request made to this endpoint neefs to provide an `Authorization: <token>` header with the token from below. <br/>
+  # **You should never use this unless you know exactly what you're doing**
+  testingtoken: ''
+  # If enabled, vikunja will send an email to everyone who is either assigned to a task or created it when a task reminder
+  # is due.
+  enableemailreminders: true
+  # If true, will allow users to request the complete deletion of their account. When using external authentication methods 
+  # it may be required to coordinate with them in order to delete the account. This setting will not affect the cli commands
+  # for user deletion.
+  enableuserdeletion: true
+  # The maximum size clients will be able to request for user avatars.
+  # If clients request a size bigger than this, it will be changed on the fly.
+  maxavatarsize: 1024
+
+database:
+  # Database type to use. Supported types are mysql, postgres and sqlite.
+  type: "sqlite"
+  # Database user which is used to connect to the database.
+  user: "vikunja"
+  # Database password
+  password: ""
+  # Database host
+  host: "localhost"
+  # Database to use
+  database: "vikunja"
+  # When using sqlite, this is the path where to store the data
+  path: "./vikunja.db"
+  # Sets the max open connections to the database. Only used when using mysql and postgres.
+  maxopenconnections: 100
+  # Sets the maximum number of idle connections to the db.
+  maxidleconnections: 50
+  # The maximum lifetime of a single db connection in miliseconds.
+  maxconnectionlifetime: 10000
+  # Secure connection mode. Only used with postgres.
+  # (see https://pkg.go.dev/github.com/lib/pq?tab=doc#hdr-Connection_String_Parameters)
+  sslmode: disable
+  # The path to the client cert. Only used with postgres.
+  sslcert: ""
+  # The path to the client key. Only used with postgres.
+  sslkey: ""
+  # The path to the ca cert. Only used with postgres.
+  sslrootcert: ""
+  # Enable SSL/TLS for mysql connections. Options: false, true, skip-verify, preferred
+  tls: false
+
+cache:
+  # If cache is enabled or not
+  enabled: false
+  # Cache type. Possible values are "keyvalue", "memory" or "redis".
+  # When choosing "keyvalue" this setting follows the one configured in the "keyvalue" section.
+  # When choosing "redis" you will need to configure the redis connection seperately.
+  type: keyvalue
+  # When using memory this defines the maximum size an element can take
+  maxelementsize: 1000
+
+redis:
+  # Whether to enable redis or not
+  enabled: false
+  # The host of the redis server including its port.
+  host: 'localhost:6379'
+  # The password used to authenicate against the redis server
+  password: ''
+  # 0 means default database
+  db: 0
+
+cors:
+  # Whether to enable or disable cors headers.
+  # Note: If you want to put the frontend and the api on seperate domains or ports, you will need to enable this.
+  #       Otherwise the frontend won't be able to make requests to the api through the browser.
+  enable: true
+  # A list of origins which may access the api. These need to include the protocol (`http://` or `https://`) and port, if any.
+  origins:
+    - "*"
+  # How long (in seconds) the results of a preflight request can be cached.
+  maxage: 0
+
+mailer:
+  # Whether to enable the mailer or not. If it is disabled, all users are enabled right away and password reset is not possible.
+  enabled: false
+  # SMTP Host
+  host: ""
+  # SMTP Host port.
+  # **NOTE:** If you're unable to send mail and the only error you see in the logs is an `EOF`, try setting the port to `25`.
+  port: 587
+  # SMTP Auth Type. Can be either `plain`, `login` or `cram-md5`.
+  authtype: "plain"
+  # SMTP username
+  username: "user"
+  # SMTP password
+  password: ""
+  # Wether to skip verification of the tls certificate on the server
+  skiptlsverify: false
+  # The default from address when sending emails
+  fromemail: "mail@vikunja"
+  # The length of the mail queue.
+  queuelength: 100
+  # The timeout in seconds after which the current open connection to the mailserver will be closed.
+  queuetimeout: 30
+  # By default, vikunja will try to connect with starttls, use this option to force it to use ssl.
+  forcessl: false
+
+log:
+  # A folder where all the logfiles should go.
+  path: <rootpath>logs
+  # Whether to show any logging at all or none
+  enabled: true
+  # Where the normal log should go. Possible values are stdout, stderr, file or off to disable standard logging.
+  standard: "stdout"
+  # Change the log level. Possible values (case-insensitive) are CRITICAL, ERROR, WARNING, NOTICE, INFO, DEBUG.
+  level: "INFO"
+  # Whether or not to log database queries. Useful for debugging. Possible values are stdout, stderr, file or off to disable database logging.
+  database: "off"
+  # The log level for database log messages. Possible values (case-insensitive) are CRITICAL, ERROR, WARNING, NOTICE, INFO, DEBUG.
+  databaselevel: "WARNING"
+  # Whether to log http requests or not. Possible values are stdout, stderr, file or off to disable http logging.
+  http: "stdout"
+  # Echo has its own logging which usually is unnecessary, which is why it is disabled by default. Possible values are stdout, stderr, file or off to disable standard logging.
+  echo: "off"
+  # Whether or not to log events. Useful for debugging. Possible values are stdout, stderr, file or off to disable events logging.
+  events: "off"
+  # The log level for event log messages. Possible values (case-insensitive) are ERROR, INFO, DEBUG.
+  eventslevel: "info"
+
+ratelimit:
+  # whether or not to enable the rate limit
+  enabled: false
+  # The kind on which rates are based. Can be either "user" for a rate limit per user or "ip" for an ip-based rate limit.
+  kind: user
+  # The time period in seconds for the limit
+  period: 60
+  # The max number of requests a user is allowed to do in the configured time period
+  limit: 100
+  # The store where the limit counter for each user is stored.
+  # Possible values are "keyvalue", "memory" or "redis".
+  # When choosing "keyvalue" this setting follows the one configured in the "keyvalue" section.
+  store: keyvalue
+
+files:
+  # The path where files are stored
+  basepath: ./files # relative to the binary
+  # The maximum size of a file, as a human-readable string.
+  # Warning: The max size is limited 2^64-1 bytes due to the underlying datatype
+  maxsize: 20MB
+
+migration:
+  todoist:
+    # Wheter to enable the todoist migrator or not
+    enable: false
+    # The client id, required for making requests to the todoist api
+    # You need to register your vikunja instance at https://developer.todoist.com/appconsole.html to get this
+    clientid:
+    # The client secret, also required for making requests to the todoist api
+    clientsecret:
+    # The url where clients are redirected after they authorized Vikunja to access their todoist items.
+    # This needs to match the url you entered when registering your Vikunja instance at todoist.
+    # This is usually the frontend url where the frontend then makes a request to /migration/todoist/migrate
+    # with the code obtained from the todoist api.
+    # Note that the vikunja frontend expects this to be /migrate/todoist
+    redirecturl: <frontend url>/migrate/todoist
+  trello:
+    # Wheter to enable the trello migrator or not
+    enable: false
+    # The client id, required for making requests to the trello api
+    # You need to register your vikunja instance at https://trello.com/app-key (log in before you visit that link) to get this
+    key:
+    # The url where clients are redirected after they authorized Vikunja to access their trello cards.
+    # This needs to match the url you entered when registering your Vikunja instance at trello.
+    # This is usually the frontend url where the frontend then makes a request to /migration/trello/migrate
+    # with the code obtained from the trello api.
+    # Note that the vikunja frontend expects this to end on /migrate/trello.
+    redirecturl: <frontend url>/migrate/trello
+  microsofttodo:
+    # Wheter to enable the microsoft todo migrator or not
+    enable: false
+    # The client id, required for making requests to the microsoft graph api
+    # See https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app#register-an-application
+    # for information about how to register your vikuinja instance.
+    clientid:
+    # The client secret, also required for making requests to the microsoft graph api
+    clientsecret:
+    # The url where clients are redirected after they authorized Vikunja to access their microsoft todo tasks.
+    # This needs to match the url you entered when registering your Vikunja instance at microsoft.
+    # This is usually the frontend url where the frontend then makes a request to /migration/microsoft-todo/migrate
+    # with the code obtained from the microsoft graph api.
+    # Note that the vikunja frontend expects this to be /migrate/microsoft-todo
+    redirecturl: <frontend url>/migrate/microsoft-todo
+
+avatar:
+  # When using gravatar, this is the duration in seconds until a cached gravatar user avatar expires
+  gravatarexpiration: 3600
+
+backgrounds:
+  # Whether to enable backgrounds for lists at all.
+  enabled: true
+  providers:
+    upload:
+      # Whethere to enable uploaded list backgrounds
+      enabled: true
+    unsplash:
+      # Whether to enable setting backgrounds from unsplash as list backgrounds
+      enabled: false
+      # You need to create an application for your installation at https://unsplash.com/oauth/applications/new
+      # and set the access token below.
+      accesstoken:
+      # The unsplash application id is only used for pingback and required as per their api guidelines.
+      # You can find the Application ID in the dashboard for your API application. It should be a numeric ID.
+      # It will only show in the UI if your application has been approved for Enterprise usage, therefore if
+      # you’re in Demo mode, you can also find the ID in the URL at the end: https://unsplash.com/oauth/applications/:application_id
+      applicationid:
+
+# Legal urls
+# Will be shown in the frontend if configured here
+legal:
+  imprinturl:
+  privacyurl:
+
+# Key Value Storage settings
+# The Key Value Storage is used for different kinds of things like metrics and a few cache systems.
+keyvalue:
+  # The type of the storage backend. Can be either "memory" or "redis". If "redis" is chosen it needs to be configured seperately.
+  type: "memory"
+
+auth:
+  # Local authentication will let users log in and register (if enabled) through the db.
+  # This is the default auth mechanism and does not require any additional configuration.
+  local:
+    # Enable or disable local authentication
+    enabled: true
+  # OpenID configuration will allow users to authenticate through a third-party OpenID Connect compatible provider.<br/>
+  # The provider needs to support the `openid`, `profile` and `email` scopes.<br/>
+  # **Note:** Some openid providers (like gitlab) only make the email of the user available through openid claims if they have set it to be publicly visible.
+  # If the email is not public in those cases, authenticating will fail.
+  # **Note 2:** The frontend expects to be redirected after authentication by the third party
+  # to <frontend-url>/auth/openid/<auth key>. Please make sure to configure the redirect url with your third party
+  # auth service accordingy if you're using the default vikunja frontend.
+  # Take a look at the [default config file](https://kolaente.dev/vikunja/api/src/branch/main/config.yml.sample) for more information about how to configure openid authentication.
+  openid:
+    # Enable or disable OpenID Connect authentication
+    enabled: false
+    # The url to redirect clients to. Defaults to the configured frontend url. If you're using Vikunja with the official
+    # frontend, you don't need to change this value.
+    # **Note:** The redirect url must exactly match the configured redirect url with the third party provider.
+    # This includes all slashes at the end or protocols.
+    redirecturl: <frontend url>
+    # A list of enabled providers
+    providers:
+      # The name of the provider as it will appear in the frontend.
+      - name:
+        # The auth url to send users to if they want to authenticate using OpenID Connect.
+        authurl:
+        # The oidc logouturl that users will be redirected to on logout.
+        # Leave empty or delete key, if you do not want to be redirected.
+        logouturl:
+        # The client ID used to authenticate Vikunja at the OpenID Connect provider.
+        clientid:
+        # The client secret used to authenticate Vikunja at the OpenID Connect provider.
+        clientsecret:
+
+# Prometheus metrics endpoint
+metrics:
+  # If set to true, enables a /metrics endpoint for prometheus to collect metrics about Vikunja.
+  enabled: false
+  # If set to a non-empty value the /metrics endpoint will require this as a username via basic auth in combination with the password below.
+  username:
+  # If set to a non-empty value the /metrics endpoint will require this as a password via basic auth in combination with the username below.
+  password:
+
+# Provide default settings for new users. When a new user is created, these settings will automatically be set for the user. If you change them in the config file afterwards they will not be changed back for existing users.
+defaultsettings:
+  # The avatar source for the user. Can be `gravatar`, `initials`, `upload` or `marble`. If you set this to `upload` you'll also need to specify `defaultsettings.avatar_file_id`.
+  avatar_provider: initials
+  # The id of the file used as avatar.
+  avatar_file_id: 0
+  # If set to true users will get task reminders via email.
+  email_reminders_enabled: false
+  # If set to true will allow other users to find this user when searching for parts of their name.
+  discoverable_by_name: false
+  # If set to true will allow other users to find this user when searching for their exact email.
+  discoverable_by_email: false
+  # If set to true will send an email every day with all overdue tasks at a configured time.
+  overdue_tasks_reminders_enabled: true
+  # When to send the overdue task reminder email.
+  overdue_tasks_reminders_time: 9:00
+  # The id of the default list. Make sure users actually have access to this list when setting this value.
+  default_list_id: 0
+  # Start of the week for the user. `0` is sunday, `1` is monday and so on.
+  week_start: 0
+  # The language of the user interface. Must be an ISO 639-1 language code. Will default to the browser language the user uses when signing up.
+  language: <unset>
+  # The time zone of each individual user. This will affect when users get reminders and overdue task emails.
+  timezone: <time zone set at service.timezone>

cypress.config.ts

@@ -1,27 +0,0 @@
-import {defineConfig} from 'cypress'
-
-export default defineConfig({
-	env: {
-		API_URL: 'http://localhost:3456/api/v1',
-		TEST_SECRET: 'averyLongSecretToSe33dtheDB',
-	},
-	video: false,
-	retries: {
-		runMode: 2,
-	},
-	projectId: '181c7x',
-	e2e: {
-		specPattern: 'cypress/e2e/**/*.{cy,spec}.{js,jsx,ts,tsx}',
-		baseUrl: 'http://127.0.0.1:4173',
-		experimentalRunAllSpecs: true,
-		// testIsolation: false,
-	},
-	component: {
-		devServer: {
-			framework: 'vue',
-			bundler: 'vite',
-		},
-	},
-	viewportWidth: 1600,
-	viewportHeight: 900,
-})

cypress/README.md

@@ -1,48 +0,0 @@
-# Frontend Testing With Cypress
-
-## Setup
-
-* Enable the [seeder api endpoint](https://vikunja.io/docs/config-options/#testingtoken). You'll then need to add the testingtoken in `cypress.json` or set the `CYPRESS_TEST_SECRET` environment variable.
-* Basic configuration happens in the `cypress.json` file
-* Overridable with [env](https://docs.cypress.io/guides/guides/environment-variables.html#Option-3-CYPRESS)
-* Override base url with `CYPRESS_BASE_URL`
-
-## Fixtures
-
-We're using the [test endpoint](https://vikunja.io/docs/config-options/#testingtoken) of the vikunja api to
-seed the database with test data before running the tests.
-This ensures better reproducability of tests.
-
-## Running The Tests Locally
-
-### Using Docker
-
-The easiest way to run all frontend tests locally is by using the `docker-compose` file in this repository.
-It uses the same configuration as the CI.
-
-To use it, run
-
-```shell
-docker-compose up -d
-```
-
-Then, once all containers are started, run
-
-```shell
-docker-compose run cypress bash
-```
-
-to get a shell inside the cypress container.
-In that shell you can then execute the tests with
-
-```shell
-pnpm run test:e2e
-```
-
-### Using The Cypress Dashboard
-
-To open the Cypress Dashboard and run tests from there, run
-
-```shell
-pnpm run test:e2e:dev
-```

cypress/docker-compose.yml

@@ -1,20 +0,0 @@
-version: '3'
-
-services:
-  api:
-    image: vikunja/api:unstable
-    environment:
-      VIKUNJA_LOG_LEVEL: DEBUG
-      VIKUNJA_SERVICE_TESTINGTOKEN: averyLongSecretToSe33dtheDB
-    ports:
-      - 3456:3456
-  cypress:
-    image: cypress/browsers:node18.12.0-chrome107
-    volumes:
-    - ..:/project
-    - $HOME/.cache:/home/node/.cache/
-    user: node
-    working_dir: /project
-    environment:
-      CYPRESS_API_URL: http://api:3456/api/v1
-      CYPRESS_TEST_SECRET: averyLongSecretToSe33dtheDB

cypress/e2e/list/list-history.spec.ts

@@ -1,57 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-import {ListFactory} from '../../factories/list'
-import {prepareLists} from './prepareLists'
-
-describe('List History', () => {
-	createFakeUserAndLogin()
-	prepareLists()
-	
-	it('should show a list history on the home page', () => {
-		cy.intercept(Cypress.env('API_URL') + '/namespaces*').as('loadNamespaces')
-		cy.intercept(Cypress.env('API_URL') + '/lists/*').as('loadList')
-		
-		const lists = ListFactory.create(6)
-
-		cy.visit('/')
-		cy.wait('@loadNamespaces')
-		cy.get('body')
-			.should('not.contain', 'Last viewed')
-
-		cy.visit(`/lists/${lists[0].id}`)
-		cy.wait('@loadNamespaces')
-		cy.wait('@loadList')
-		cy.visit(`/lists/${lists[1].id}`)
-		cy.wait('@loadNamespaces')
-		cy.wait('@loadList')
-		cy.visit(`/lists/${lists[2].id}`)
-		cy.wait('@loadNamespaces')
-		cy.wait('@loadList')
-		cy.visit(`/lists/${lists[3].id}`)
-		cy.wait('@loadNamespaces')
-		cy.wait('@loadList')
-		cy.visit(`/lists/${lists[4].id}`)
-		cy.wait('@loadNamespaces')
-		cy.wait('@loadList')
-		cy.visit(`/lists/${lists[5].id}`)
-		cy.wait('@loadNamespaces')
-		cy.wait('@loadList')
-
-		// cy.visit('/')
-		// cy.wait('@loadNamespaces')
-		// Not using cy.visit here to work around the redirect issue fixed in #1337
-		cy.get('nav.menu.top-menu a')
-			.contains('Overview')
-			.click()
-		
-		cy.get('body')
-			.should('contain', 'Last viewed')
-		cy.get('[data-cy="listCardGrid"]')
-			.should('not.contain', lists[0].title)
-			.should('contain', lists[1].title)
-			.should('contain', lists[2].title)
-			.should('contain', lists[3].title)
-			.should('contain', lists[4].title)
-			.should('contain', lists[5].title)
-	})
-})

cypress/e2e/list/list-view-gantt.spec.ts

@@ -1,126 +0,0 @@
-import {formatISO, format} from 'date-fns'
-
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-import {TaskFactory} from '../../factories/task'
-import {prepareLists} from './prepareLists'
-
-describe('List View Gantt', () => {
-	createFakeUserAndLogin()
-	prepareLists()
-
-	it('Hides tasks with no dates', () => {
-		const tasks = TaskFactory.create(1)
-		cy.visit('/lists/1/gantt')
-
-		cy.get('.g-gantt-rows-container')
-			.should('not.contain', tasks[0].title)
-	})
-
-	it('Shows tasks from the current and next month', () => {
-		const now = Date.UTC(2022, 8, 25)
-		cy.clock(now, ['Date'])
-
-		const nextMonth = new Date(now)
-		nextMonth.setDate(1)
-		nextMonth.setMonth(9)
-
-		cy.visit('/lists/1/gantt')
-
-		cy.get('.g-timeunits-container')
-			.should('contain', format(now, 'MMMM'))
-			.should('contain', format(nextMonth, 'MMMM'))
-	})
-
-	it('Shows tasks with dates', () => {
-		const now = new Date()
-		const tasks = TaskFactory.create(1, {
-			start_date: now.toISOString(),
-			end_date: new Date(new Date(now).setDate(now.getDate() + 4)).toISOString(),
-		})
-		cy.visit('/lists/1/gantt')
-
-		cy.get('.g-gantt-rows-container')
-			.should('not.be.empty')
-			.should('contain', tasks[0].title)
-	})
-
-	it('Shows tasks with no dates after enabling them', () => {
-		const tasks = TaskFactory.create(1, {
-			start_date: null,
-			end_date: null,
-		})
-		cy.visit('/lists/1/gantt')
-
-		cy.get('.gantt-options .fancycheckbox')
-			.contains('Show tasks which don\'t have dates set')
-			.click()
-
-		cy.get('.g-gantt-rows-container')
-			.should('not.be.empty')
-			.should('contain', tasks[0].title)
-	})
-
-	it('Drags a task around', () => {
-		cy.intercept(Cypress.env('API_URL') + '/tasks/*').as('taskUpdate')
-
-		const now = new Date()
-		TaskFactory.create(1, {
-			start_date: now.toISOString(),
-			end_date: new Date(new Date(now).setDate(now.getDate() + 4)).toISOString(),
-		})
-		cy.visit('/lists/1/gantt')
-
-		cy.get('.g-gantt-rows-container .g-gantt-row .g-gantt-row-bars-container div .g-gantt-bar')
-			.first()
-			.trigger('mousedown', {which: 1})
-			.trigger('mousemove', {clientX: 500, clientY: 0})
-			.trigger('mouseup', {force: true})
-		cy.wait('@taskUpdate')
-	})
-
-	it('Should change the query parameters when selecting a date range', () => {
-		const now = Date.UTC(2022, 10, 9)
-		cy.clock(now, ['Date'])
-
-		cy.visit('/lists/1/gantt')
-
-		cy.get('.list-gantt .gantt-options .field .control input.input.form-control')
-			.click()
-		cy.get('.flatpickr-calendar .flatpickr-innerContainer .dayContainer .flatpickr-day')
-			.first()
-			.click()
-		cy.get('.flatpickr-calendar .flatpickr-innerContainer .dayContainer .flatpickr-day')
-			.last()
-			.click()
-
-		cy.url().should('contain', 'dateFrom=2022-09-25')
-		cy.url().should('contain', 'dateTo=2022-11-05')
-	})
-
-	it('Should change the date range based on date query parameters', () => {
-		cy.visit('/lists/1/gantt?dateFrom=2022-09-25&dateTo=2022-11-05')
-
-		cy.get('.g-timeunits-container')
-			.should('contain', 'September 2022')
-			.should('contain', 'October 2022')
-			.should('contain', 'November 2022')
-		cy.get('.list-gantt .gantt-options .field .control input.input.form-control')
-			.should('have.value', '25 Sep 2022 to 5 Nov 2022')
-	})
-
-	it('Should open a task when double clicked on it', () => {
-		const now = new Date()
-		const tasks = TaskFactory.create(1, {
-			start_date: formatISO(now),
-			end_date: formatISO(now.setDate(now.getDate() + 4)),
-		})
-		cy.visit('/lists/1/gantt')
-
-		cy.get('.gantt-container .g-gantt-chart .g-gantt-row-bars-container .g-gantt-bar')
-			.dblclick()
-
-		cy.url()
-			.should('contain', `/tasks/${tasks[0].id}`)
-	})
-})

cypress/e2e/list/list-view-kanban.spec.ts

@@ -1,241 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-import {BucketFactory} from '../../factories/bucket'
-import {ListFactory} from '../../factories/list'
-import {TaskFactory} from '../../factories/task'
-import {prepareLists} from './prepareLists'
-
-describe('List View Kanban', () => {
-	createFakeUserAndLogin()
-	prepareLists()
-	
-	let buckets
-	beforeEach(() => {
-		buckets = BucketFactory.create(2)
-	})
-
-	it('Shows all buckets with their tasks', () => {
-		const data = TaskFactory.create(10, {
-			list_id: 1,
-			bucket_id: 1,
-		})
-		cy.visit('/lists/1/kanban')
-
-		cy.get('.kanban .bucket .title')
-			.contains(buckets[0].title)
-			.should('exist')
-		cy.get('.kanban .bucket .title')
-			.contains(buckets[1].title)
-			.should('exist')
-		cy.get('.kanban .bucket')
-			.first()
-			.should('contain', data[0].title)
-	})
-
-	it('Can add a new task to a bucket', () => {
-		TaskFactory.create(2, {
-			list_id: 1,
-			bucket_id: 1,
-		})
-		cy.visit('/lists/1/kanban')
-
-		cy.get('.kanban .bucket')
-			.contains(buckets[0].title)
-			.get('.bucket-footer .button')
-			.contains('Add another task')
-			.click()
-		cy.get('.kanban .bucket')
-			.contains(buckets[0].title)
-			.get('.bucket-footer .field .control input.input')
-			.type('New Task{enter}')
-
-		cy.get('.kanban .bucket')
-			.first()
-			.should('contain', 'New Task')
-	})
-
-	it('Can create a new bucket', () => {
-		cy.visit('/lists/1/kanban')
-
-		cy.get('.kanban .bucket.new-bucket .button')
-			.click()
-		cy.get('.kanban .bucket.new-bucket input.input')
-			.type('New Bucket{enter}')
-
-		cy.wait(1000) // Wait for the request to finish
-		cy.get('.kanban .bucket .title')
-			.contains('New Bucket')
-			.should('exist')
-	})
-
-	it('Can set a bucket limit', () => {
-		cy.visit('/lists/1/kanban')
-
-		cy.get('.kanban .bucket .bucket-header .dropdown.options .dropdown-trigger')
-			.first()
-			.click()
-		cy.get('.kanban .bucket .bucket-header .dropdown.options .dropdown-menu .dropdown-item')
-			.contains('Limit: Not Set')
-			.click()
-		cy.get('.kanban .bucket .bucket-header .dropdown.options .dropdown-menu .dropdown-item .field input.input')
-			.first()
-			.type(3)
-		cy.get('[data-cy="setBucketLimit"]')
-			.first()
-			.click()
-
-		cy.get('.kanban .bucket .bucket-header span.limit')
-			.contains('0/3')
-			.should('exist')
-	})
-
-	it('Can rename a bucket', () => {
-		cy.visit('/lists/1/kanban')
-
-		cy.get('.kanban .bucket .bucket-header .title')
-			.first()
-			.type('{selectall}New Bucket Title{enter}')
-		cy.get('.kanban .bucket .bucket-header .title')
-			.first()
-			.should('contain', 'New Bucket Title')
-	})
-
-	it('Can delete a bucket', () => {
-		cy.visit('/lists/1/kanban')
-
-		cy.get('.kanban .bucket .bucket-header .dropdown.options .dropdown-trigger')
-			.first()
-			.click()
-		cy.get('.kanban .bucket .bucket-header .dropdown.options .dropdown-menu .dropdown-item')
-			.contains('Delete')
-			.click()
-		cy.get('.modal-mask .modal-container .modal-content .header')
-			.should('contain', 'Delete the bucket')
-		cy.get('.modal-mask .modal-container .modal-content .actions .button')
-			.contains('Do it!')
-			.click()
-
-		cy.get('.kanban .bucket .title')
-			.contains(buckets[0].title)
-			.should('not.exist')
-		cy.get('.kanban .bucket .title')
-			.contains(buckets[1].title)
-			.should('exist')
-	})
-
-	it('Can drag tasks around', () => {
-		const tasks = TaskFactory.create(2, {
-			list_id: 1,
-			bucket_id: 1,
-		})
-		cy.visit('/lists/1/kanban')
-
-		cy.get('.kanban .bucket .tasks .task')
-			.contains(tasks[0].title)
-			.first()
-			.drag('.kanban .bucket:nth-child(2) .tasks')
-		
-		cy.get('.kanban .bucket:nth-child(2) .tasks')
-			.should('contain', tasks[0].title)
-		cy.get('.kanban .bucket:nth-child(1) .tasks')
-			.should('not.contain', tasks[0].title)
-	})
-
-	it('Should navigate to the task when the task card is clicked', () => {
-		const tasks = TaskFactory.create(5, {
-			id: '{increment}',
-			list_id: 1,
-			bucket_id: 1,
-		})
-		cy.visit('/lists/1/kanban')
-
-		cy.get('.kanban .bucket .tasks .task')
-			.contains(tasks[0].title)
-			.should('be.visible')
-			.click()
-
-		cy.url()
-			.should('contain', `/tasks/${tasks[0].id}`, { timeout: 1000 })
-	})
-
-	it('Should remove a task from the kanban board when moving it to another list', () => {
-		const lists = ListFactory.create(2)
-		BucketFactory.create(2, {
-			list_id: '{increment}',
-		})
-		const tasks = TaskFactory.create(5, {
-			id: '{increment}',
-			list_id: 1,
-			bucket_id: 1,
-		})
-		const task = tasks[0]
-		cy.visit('/lists/1/kanban')
-
-		cy.get('.kanban .bucket .tasks .task')
-			.contains(task.title)
-			.should('be.visible')
-			.click()
-
-		cy.get('.task-view .action-buttons .button', { timeout: 3000 })
-			.contains('Move')
-			.click()
-		cy.get('.task-view .content.details .field .multiselect.control .input-wrapper input')
-			.type(`${lists[1].title}{enter}`)
-		// The requests happen with a 200ms timeout. Because of that, the results are not yet there when cypress
-		// presses enter and we can't simulate pressing on enter to select the item.
-		cy.get('.task-view .content.details .field .multiselect.control .search-results')
-			.children()
-			.first()
-			.click()
-
-		cy.get('.global-notification', { timeout: 1000 })
-			.should('contain', 'Success')
-		cy.go('back')
-		cy.get('.kanban .bucket')
-			.should('not.contain', task.title)
-	})
-	
-	it('Shows a button to filter the kanban board', () => {
-		const data = TaskFactory.create(10, {
-			list_id: 1,
-			bucket_id: 1,
-		})
-		cy.visit('/lists/1/kanban')
-		
-		cy.get('.list-kanban .filter-container .base-button')
-			.should('exist')
-	})
-	
-	it('Should remove a task from the board when deleting it', () => {
-		const lists = ListFactory.create(1)
-		const buckets = BucketFactory.create(2, {
-			list_id: lists[0].id,
-		})
-		const tasks = TaskFactory.create(5, {
-			list_id: 1,
-			bucket_id: buckets[0].id,
-		})
-		const task = tasks[0]
-		cy.visit('/lists/1/kanban')
-
-		cy.get('.kanban .bucket .tasks .task')
-			.contains(task.title)
-			.should('be.visible')
-			.click()
-		cy.get('.task-view .action-buttons .button')
-			.should('be.visible')
-			.contains('Delete')
-			.click()
-		cy.get('.modal-mask .modal-container .modal-content .header')
-			.should('contain', 'Delete this task')
-		cy.get('.modal-mask .modal-container .modal-content .actions .button')
-			.contains('Do it!')
-			.click()
-
-		cy.get('.global-notification')
-			.should('contain', 'Success')
-		
-		cy.get('.kanban .bucket .tasks')
-			.should('not.contain', task.title)
-	})
-})

cypress/e2e/list/list-view-list.spec.ts

@@ -1,110 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-import {UserListFactory} from '../../factories/users_list'
-import {TaskFactory} from '../../factories/task'
-import {UserFactory} from '../../factories/user'
-import {ListFactory} from '../../factories/list'
-import {prepareLists} from './prepareLists'
-
-describe('List View List', () => {
-	createFakeUserAndLogin()
-	prepareLists()
-
-	it('Should be an empty list', () => {
-		cy.visit('/lists/1')
-		cy.url()
-			.should('contain', '/lists/1/list')
-		cy.get('.list-title')
-			.should('contain', 'First List')
-		cy.get('.list-title-dropdown')
-			.should('exist')
-		cy.get('p')
-			.contains('This list is currently empty.')
-			.should('exist')
-	})
-	
-	it('Should create a new task', () => {
-		const newTaskTitle = 'New task'
-		
-		cy.visit('/lists/1')
-		cy.get('.task-add textarea')
-			.type(newTaskTitle+'{enter}')
-		cy.get('.tasks')
-			.should('contain.text', newTaskTitle)
-	})
-
-	it('Should navigate to the task when the title is clicked', () => {
-		const tasks = TaskFactory.create(5, {
-			id: '{increment}',
-			list_id: 1,
-		})
-		cy.visit('/lists/1/list')
-
-		cy.get('.tasks .task .tasktext')
-			.contains(tasks[0].title)
-			.first()
-			.click()
-
-		cy.url()
-			.should('contain', `/tasks/${tasks[0].id}`)
-	})
-
-	it('Should not see any elements for a list which is shared read only', () => {
-		UserFactory.create(2)
-		UserListFactory.create(1, {
-			list_id: 2,
-			user_id: 1,
-			right: 0,
-		})
-		const lists = ListFactory.create(2, {
-			owner_id: '{increment}',
-			namespace_id: '{increment}',
-		})
-		cy.visit(`/lists/${lists[1].id}/`)
-
-		cy.get('.list-title-wrapper .icon')
-			.should('not.exist')
-		cy.get('input.input[placeholder="Add a new task..."')
-			.should('not.exist')
-	})
-
-	it('Should only show the color of a list in the navigation and not in the list view', () => {
-		const lists = ListFactory.create(1, {
-			hex_color: '00db60',
-		})
-		TaskFactory.create(10, {
-			list_id: lists[0].id,
-		})
-		cy.visit(`/lists/${lists[0].id}/`)
-
-		cy.get('.menu-list li .list-menu-link .color-bubble')
-			.should('have.css', 'background-color', 'rgb(0, 219, 96)')
-		cy.get('.tasks .color-bubble')
-			.should('not.exist')
-	})
-
-	it('Should paginate for > 50 tasks', () => {
-		const tasks = TaskFactory.create(100, {
-			id: '{increment}',
-			title: i => `task${i}`,
-			list_id: 1,
-		})
-		cy.visit('/lists/1/list')
-
-		cy.get('.tasks')
-			.should('contain', tasks[1].title)
-		cy.get('.tasks')
-			.should('not.contain', tasks[99].title)
-
-		cy.get('.card-content .pagination .pagination-link')
-			.contains('2')
-			.click()
-
-		cy.url()
-			.should('contain', '?page=2')
-		cy.get('.tasks')
-			.should('contain', tasks[99].title)
-		cy.get('.tasks')
-			.should('not.contain', tasks[1].title)
-	})
-})

cypress/e2e/list/list-view-table.spec.ts

@@ -1,54 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-import {TaskFactory} from '../../factories/task'
-
-describe('List View Table', () => {
-	createFakeUserAndLogin()
-
-	it('Should show a table with tasks', () => {
-		const tasks = TaskFactory.create(1)
-		cy.visit('/lists/1/table')
-
-		cy.get('.list-table table.table')
-			.should('exist')
-		cy.get('.list-table table.table')
-			.should('contain', tasks[0].title)
-	})
-
-	it('Should have working column switches', () => {
-		TaskFactory.create(1)
-		cy.visit('/lists/1/table')
-
-		cy.get('.list-table .filter-container .items .button')
-			.contains('Columns')
-			.click()
-		cy.get('.list-table .filter-container .card.columns-filter .card-content .fancycheckbox .check')
-			.contains('Priority')
-			.click()
-		cy.get('.list-table .filter-container .card.columns-filter .card-content .fancycheckbox .check')
-			.contains('Done')
-			.click()
-
-		cy.get('.list-table table.table th')
-			.contains('Priority')
-			.should('exist')
-		cy.get('.list-table table.table th')
-			.contains('Done')
-			.should('not.exist')
-	})
-
-	it('Should navigate to the task when the title is clicked', () => {
-		const tasks = TaskFactory.create(5, {
-			id: '{increment}',
-			list_id: 1,
-		})
-		cy.visit('/lists/1/table')
-
-		cy.get('.list-table table.table')
-			.contains(tasks[0].title)
-			.click()
-
-		cy.url()
-			.should('contain', `/tasks/${tasks[0].id}`)
-	})
-})

cypress/e2e/list/list.spec.ts

@@ -1,122 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-import {TaskFactory} from '../../factories/task'
-import {prepareLists} from './prepareLists'
-
-describe('Lists', () => {
-	createFakeUserAndLogin()
-
-	let lists
-	prepareLists((newLists) => (lists = newLists))
-
-	it('Should create a new list', () => {
-		cy.visit('/')
-		cy.get('.namespace-title .dropdown-trigger')
-			.click()
-		cy.get('.namespace-title .dropdown .dropdown-item')
-			.contains('New list')
-			.click()
-		cy.url()
-			.should('contain', '/lists/new/1')
-		cy.get('.card-header-title')
-			.contains('New list')
-		cy.get('input.input')
-			.type('New List')
-		cy.get('.button')
-			.contains('Create')
-			.click()
-
-		cy.get('.global-notification', { timeout: 1000 }) // Waiting until the request to create the new list is done
-			.should('contain', 'Success')
-		cy.url()
-			.should('contain', '/lists/')
-		cy.get('.list-title')
-			.should('contain', 'New List')
-	})
-
-	it('Should redirect to a specific list view after visited', () => {
-		cy.visit('/lists/1/kanban')
-		cy.url()
-			.should('contain', '/lists/1/kanban')
-		cy.visit('/lists/1')
-		cy.url()
-			.should('contain', '/lists/1/kanban')
-	})
-
-	it('Should rename the list in all places', () => {
-		TaskFactory.create(5, {
-			id: '{increment}',
-			list_id: 1,
-		})
-		const newListName = 'New list name'
-
-		cy.visit('/lists/1')
-		cy.get('.list-title')
-			.should('contain', 'First List')
-
-		cy.get('.namespace-container .menu.namespaces-lists .menu-list li:first-child .dropdown .menu-list-dropdown-trigger')
-			.click()
-		cy.get('.namespace-container .menu.namespaces-lists .menu-list li:first-child .dropdown .dropdown-content')
-			.contains('Edit')
-			.click()
-		cy.get('#title')
-			.type(`{selectall}${newListName}`)
-		cy.get('footer.card-footer .button')
-			.contains('Save')
-			.click()
-
-		cy.get('.global-notification')
-			.should('contain', 'Success')
-		cy.get('.list-title')
-			.should('contain', newListName)
-			.should('not.contain', lists[0].title)
-		cy.get('.namespace-container .menu.namespaces-lists .menu-list li:first-child')
-			.should('contain', newListName)
-			.should('not.contain', lists[0].title)
-		cy.visit('/')
-		cy.get('.card-content')
-			.should('contain', newListName)
-			.should('not.contain', lists[0].title)
-	})
-
-	it('Should remove a list', () => {
-		cy.visit(`/lists/${lists[0].id}`)
-
-		cy.get('.namespace-container .menu.namespaces-lists .menu-list li:first-child .dropdown .menu-list-dropdown-trigger')
-			.click()
-		cy.get('.namespace-container .menu.namespaces-lists .menu-list li:first-child .dropdown .dropdown-content')
-			.contains('Delete')
-			.click()
-		cy.url()
-			.should('contain', '/settings/delete')
-		cy.get('[data-cy="modalPrimary"]')
-			.contains('Do it')
-			.click()
-
-		cy.get('.global-notification')
-			.should('contain', 'Success')
-		cy.get('.namespace-container .menu.namespaces-lists .menu-list')
-			.should('not.contain', lists[0].title)
-		cy.location('pathname')
-			.should('equal', '/')
-	})
-	
-	it('Should archive a list', () => {
-		cy.visit(`/lists/${lists[0].id}`)
-		
-		cy.get('.list-title-dropdown')
-			.click()
-		cy.get('.list-title-dropdown .dropdown-menu .dropdown-item')
-			.contains('Archive')
-			.click()
-		cy.get('.modal-content')
-			.should('contain.text', 'Archive this list')
-		cy.get('.modal-content [data-cy=modalPrimary]')
-			.click()
-		
-		cy.get('.namespace-container .menu.namespaces-lists .menu-list')
-			.should('not.contain', lists[0].title)
-		cy.get('main.app-content')
-			.should('contain.text', 'This list is archived. It is not possible to create new or edit tasks for it.')
-	})
-})

cypress/e2e/list/namespaces.spec.ts

@@ -1,145 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-import {ListFactory} from '../../factories/list'
-import {NamespaceFactory} from '../../factories/namespace'
-
-describe('Namepaces', () => {
-	createFakeUserAndLogin()
-
-	let namespaces
-
-	beforeEach(() => {
-		namespaces = NamespaceFactory.create(1)
-		ListFactory.create(1)
-	})
-
-	it('Should be all there', () => {
-		cy.visit('/namespaces')
-		cy.get('[data-cy="namespace-title"]')
-			.should('contain', namespaces[0].title)
-	})
-
-	it('Should create a new Namespace', () => {
-		const newNamespaceTitle = 'New Namespace'
-
-		cy.visit('/namespaces')
-		cy.get('[data-cy="new-namespace"]')
-			.should('contain', 'New namespace')
-			.click()
-
-		cy.url()
-			.should('contain', '/namespaces/new')
-		cy.get('.card-header-title')
-			.should('contain', 'New namespace')
-		cy.get('input.input')
-			.type(newNamespaceTitle)
-		cy.get('.button')
-			.contains('Create')
-			.click()
-
-		cy.get('.global-notification')
-			.should('contain', 'Success')
-		cy.get('.namespace-container')
-			.should('contain', newNamespaceTitle)
-		cy.url()
-			.should('contain', '/namespaces')
-	})
-
-	it('Should rename the namespace all places', () => {
-		const newNamespaces = NamespaceFactory.create(5)
-		const newNamespaceName = 'New namespace name'
-
-		cy.visit('/namespaces')
-
-		cy.get(`.namespace-container .menu.namespaces-lists .namespace-title:contains(${newNamespaces[0].title}) .dropdown .dropdown-trigger`)
-			.click()
-		cy.get('.namespace-container .menu.namespaces-lists .namespace-title .dropdown .dropdown-content')
-			.contains('Edit')
-			.click()
-		cy.url()
-			.should('contain', '/settings/edit')
-		cy.get('#namespacetext')
-			.invoke('val')
-			.should('equal', newNamespaces[0].title) // wait until the namespace data is loaded
-		cy.get('#namespacetext')
-			.type(`{selectall}${newNamespaceName}`)
-		cy.get('footer.card-footer .button')
-			.contains('Save')
-			.click()
-
-		cy.get('.global-notification', { timeout: 1000 })
-			.should('contain', 'Success')
-		cy.get('.namespace-container .menu.namespaces-lists')
-			.should('contain', newNamespaceName)
-			.should('not.contain', newNamespaces[0].title)
-		cy.get('[data-cy="namespaces-list"]')
-			.should('contain', newNamespaceName)
-			.should('not.contain', newNamespaces[0].title)
-	})
-
-	it('Should remove a namespace when deleting it', () => {
-		const newNamespaces = NamespaceFactory.create(5)
-
-		cy.visit('/')
-
-		cy.get(`.namespace-container .menu.namespaces-lists .namespace-title:contains(${newNamespaces[0].title}) .dropdown .dropdown-trigger`)
-			.click()
-		cy.get('.namespace-container .menu.namespaces-lists .namespace-title .dropdown .dropdown-content')
-			.contains('Delete')
-			.click()
-		cy.url()
-			.should('contain', '/settings/delete')
-		cy.get('[data-cy="modalPrimary"]')
-			.contains('Do it')
-			.click()
-
-		cy.get('.global-notification')
-			.should('contain', 'Success')
-		cy.get('.namespace-container .menu.namespaces-lists')
-			.should('not.contain', newNamespaces[0].title)
-	})
-
-	it('Should not show archived lists & namespaces if the filter is not checked', () => {
-		const n = NamespaceFactory.create(1, {
-			id: 2,
-			is_archived: true,
-		}, false)
-		ListFactory.create(1, {
-			id: 2,
-			namespace_id: n[0].id,
-		}, false)
-
-		ListFactory.create(1, {
-			id: 3,
-			is_archived: true,
-		}, false)
-
-		// Initial
-		cy.visit('/namespaces')
-		cy.get('.namespace')
-			.should('not.contain', 'Archived')
-
-		// Show archived
-		cy.get('[data-cy="show-archived-check"] label.check span')
-			.should('be.visible')
-			.click()
-		cy.get('[data-cy="show-archived-check"] input')
-			.should('be.checked')
-		cy.get('.namespace')
-			.should('contain', 'Archived')
-
-		// Don't show archived
-		cy.get('[data-cy="show-archived-check"] label.check span')
-			.should('be.visible')
-			.click()
-		cy.get('[data-cy="show-archived-check"] input')
-			.should('not.be.checked')
-
-		// Second time visiting after unchecking
-		cy.visit('/namespaces')
-		cy.get('[data-cy="show-archived-check"] input')
-			.should('not.be.checked')
-		cy.get('.namespace')
-			.should('not.contain', 'Archived')
-	})
-})

cypress/e2e/list/prepareLists.ts

@@ -1,19 +0,0 @@
-import {ListFactory} from '../../factories/list'
-import {NamespaceFactory} from '../../factories/namespace'
-import {TaskFactory} from '../../factories/task'
-
-export function createLists() {
-	NamespaceFactory.create(1)
-	const lists = ListFactory.create(1, {
-		title: 'First List'
-	})
-	TaskFactory.truncate()
-	return lists
-}
-
-export function prepareLists(setLists = (...args: any[]) => {}) {
-	beforeEach(() => {
-		const lists = createLists()
-		setLists(lists)
-	})
-}

cypress/e2e/misc/editor.spec.ts

@@ -1,39 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-import {TaskFactory} from '../../factories/task'
-import {ListFactory} from '../../factories/list'
-import {NamespaceFactory} from '../../factories/namespace'
-import {UserListFactory} from '../../factories/users_list'
-
-describe('Editor', () => {
-	createFakeUserAndLogin()
-	
-	beforeEach(() => {
-		NamespaceFactory.create(1)
-		ListFactory.create(1)
-		TaskFactory.truncate()
-		UserListFactory.truncate()
-	})
-
-	it('Has a preview with checkable checkboxes', () => {
-		const tasks = TaskFactory.create(1, {
-			description: `# Test Heading
-* Bullet 1
-* Bullet 2
-
-* [ ] Checklist
-* [x] Checklist checked
-`,
-		})
-
-		cy.visit(`/tasks/${tasks[0].id}`)
-		cy.get('input[type=checkbox][data-checkbox-num=0]')
-			.click()
-
-		cy.get('.task-view .details.content.description h3 span.is-small.has-text-success')
-			.contains('Saved!')
-			.should('exist')
-		cy.get('.preview.content')
-			.should('contain', 'Test Heading')
-	})
-})

cypress/e2e/misc/menu.spec.ts

@@ -1,35 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-describe('The Menu', () => {
-	createFakeUserAndLogin()
-
-	beforeEach(() => {
-		cy.visit('/')
-	})
-
-	it('Is visible by default on desktop', () => {
-		cy.get('.namespace-container')
-			.should('have.class', 'is-active')
-	})
-
-	it('Can be hidden on desktop', () => {
-		cy.get('button.menu-show-button:visible')
-			.click()
-		cy.get('.namespace-container')
-			.should('not.have.class', 'is-active')
-	})
-
-	it('Is hidden by default on mobile', () => {
-		cy.viewport('iphone-8')
-		cy.get('.namespace-container')
-			.should('not.have.class', 'is-active')
-	})
-
-	it('Is can be shown on mobile', () => {
-		cy.viewport('iphone-8')
-		cy.get('button.menu-show-button:visible')
-			.click()
-		cy.get('.namespace-container')
-			.should('have.class', 'is-active')
-	})
-})

cypress/e2e/sharing/linkShare.spec.ts

@@ -1,25 +0,0 @@
-import {LinkShareFactory} from '../../factories/link_sharing'
-import {ListFactory} from '../../factories/list'
-import {TaskFactory} from '../../factories/task'
-
-describe('Link shares', () => {
-	it('Can view a link share', () => {
-		const lists = ListFactory.create(1)
-		const tasks = TaskFactory.create(10, {
-			list_id: lists[0].id
-		})
-		const linkShares = LinkShareFactory.create(1, {
-			list_id: lists[0].id,
-			right: 0,
-		})
-
-		cy.visit(`/share/${linkShares[0].hash}/auth`)
-
-		cy.get('h1.title')
-			.should('contain', lists[0].title)
-		cy.get('input.input[placeholder="Add a new task..."')
-			.should('not.exist')
-		cy.get('.tasks')
-			.should('contain', tasks[0].title)
-	})
-})

cypress/e2e/sharing/team.spec.ts

@@ -1,131 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-import {TeamFactory} from '../../factories/team'
-import {TeamMemberFactory} from '../../factories/team_member'
-import {UserFactory} from '../../factories/user'
-
-describe('Team', () => {
-	createFakeUserAndLogin()
-
-    it('Creates a new team', () => {
-        TeamFactory.truncate()
-        cy.visit('/teams')
-
-        const newTeamName = 'New Team'
-
-        cy.get('a.button')
-            .contains('Create a new team')
-            .click()
-		cy.url()
-			.should('contain', '/teams/new')
-		cy.get('.card-header-title')
-			.contains('Create a new team')
-		cy.get('input.input')
-			.type(newTeamName)
-		cy.get('.button')
-			.contains('Create')
-			.click()
-
-		cy.url()
-            .should('contain', '/edit')
-        cy.get('input#teamtext')
-            .should('have.value', newTeamName)
-    })
-
-    it('Shows all teams', () => {
-        TeamMemberFactory.create(10, {
-            team_id: '{increment}',
-        })
-        const teams = TeamFactory.create(10, {
-            id: '{increment}',
-        })
-
-        cy.visit('/teams')
-
-        cy.get('.teams.box')
-            .should('not.be.empty')
-        teams.forEach(t => {
-            cy.get('.teams.box')
-                .should('contain', t.name)
-        })
-    })
-
-    it('Allows an admin to edit the team', () => {
-        TeamMemberFactory.create(1, {
-            team_id: 1,
-            admin: true,
-        })
-        const teams = TeamFactory.create(1, {
-            id: 1,
-        })
-        
-        cy.visit('/teams/1/edit')
-        cy.get('.card input.input')
-            .first()
-            .type('{selectall}New Team Name')
-
-        cy.get('.card .button')
-            .contains('Save')
-            .click()
-        
-        cy.get('table.table td')
-            .contains('Admin')
-            .should('exist')
-        cy.get('.global-notification')
-			.should('contain', 'Success')
-    })
-
-    it('Does not allow a normal user to edit the team', () => {
-        TeamMemberFactory.create(1, {
-            team_id: 1,
-            admin: false,
-        })
-        const teams = TeamFactory.create(1, {
-            id: 1,
-        })
-        
-        cy.visit('/teams/1/edit')
-        cy.get('.card input.input')
-            .should('not.exist')
-        cy.get('table.table td')
-            .contains('Member')
-            .should('exist')
-    })
-
-    it('Allows an admin to add members to the team', () => {
-        TeamMemberFactory.create(1, {
-            team_id: 1,
-            admin: true,
-        })
-        TeamFactory.create(1, {
-            id: 1,
-        })
-        const users = UserFactory.create(5)
-        
-        cy.visit('/teams/1/edit')
-        cy.get('.card')
-            .contains('Team Members')
-            .get('.card-content .multiselect .input-wrapper input')
-            .type(users[1].username)
-        cy.get('.card')
-            .contains('Team Members')
-            .get('.card-content .multiselect .search-results')
-				.children()
-				.first()
-				.click()
-        cy.get('.card')
-            .contains('Team Members')
-            .get('.card-content .button')
-            .contains('Add to team')
-            .click()
-        
-        cy.get('table.table td')
-            .contains('Admin')
-            .should('exist')
-        cy.get('table.table tr')
-            .should('contain', users[1].username)
-            .should('contain', 'Member')
-        cy.get('.global-notification')
-			.should('contain', 'Success')
-    })
-})

cypress/e2e/task/overview.spec.ts

@@ -1,153 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-import {ListFactory} from '../../factories/list'
-import {seed} from '../../support/seed'
-import {TaskFactory} from '../../factories/task'
-import {NamespaceFactory} from '../../factories/namespace'
-import {BucketFactory} from '../../factories/bucket'
-import {updateUserSettings} from '../../support/updateUserSettings'
-
-function seedTasks(numberOfTasks = 50, startDueDate = new Date()) {
-	NamespaceFactory.create(1)
-	const list = ListFactory.create()[0]
-	BucketFactory.create(1, {
-		list_id: list.id,
-	})
-	const tasks = []
-	let dueDate = startDueDate
-	for (let i = 0; i < numberOfTasks; i++) {
-		const now = new Date()
-		dueDate = new Date(new Date(dueDate).setDate(dueDate.getDate() + 2))
-		tasks.push({
-			id: i + 1,
-			list_id: list.id,
-			done: false,
-			created_by_id: 1,
-			title: 'Test Task ' + i,
-			index: i + 1,
-			due_date: dueDate.toISOString(),
-			created: now.toISOString(),
-			updated: now.toISOString(),
-		})
-	}
-	seed(TaskFactory.table, tasks)
-	return {tasks, list}
-}
-
-describe('Home Page Task Overview', () => {
-	createFakeUserAndLogin()
-
-	it('Should show tasks with a near due date first on the home page overview', () => {
-		const taskCount = 50
-		const {tasks} = seedTasks(taskCount)
-
-		cy.visit('/')
-		cy.get('[data-cy="showTasks"] .card .task')
-			.each(([task], index) => {
-				expect(task.innerText).to.contain(tasks[index].title)
-			})
-	})
-
-	it('Should show overdue tasks first, then show other tasks', () => {
-		const now = new Date()
-		const oldDate = new Date(new Date(now).setDate(now.getDate() - 14))
-		const taskCount = 50
-		const {tasks} = seedTasks(taskCount, oldDate)
-
-		cy.visit('/')
-		cy.get('[data-cy="showTasks"] .card .task')
-			.each(([task], index) => {
-				expect(task.innerText).to.contain(tasks[index].title)
-			})
-	})
-
-	it('Should show a new task with a very soon due date at the top', () => {
-		const {tasks} = seedTasks()
-		const newTaskTitle = 'New Task'
-		
-		cy.visit('/')
-		
-		TaskFactory.create(1, {
-			id: 999,
-			title: newTaskTitle,
-			due_date: new Date().toISOString(),
-		}, false)
-		
-		cy.visit(`/lists/${tasks[0].list_id}/list`)
-		cy.get('.tasks .task')
-			.first()
-			.should('contain.text', newTaskTitle)
-		cy.visit('/')
-		cy.get('[data-cy="showTasks"] .card .task')
-			.first()
-			.should('contain.text', newTaskTitle)
-	})
-	
-	it('Should not show a new task without a date at the bottom when there are > 50 tasks', () => {
-		// We're not using the api here to create the task in order to verify the flow
-		const {tasks} = seedTasks(100)
-		const newTaskTitle = 'New Task'
-
-		cy.visit('/')
-
-		cy.visit(`/lists/${tasks[0].list_id}/list`)
-		cy.get('.task-add textarea')
-			.type(newTaskTitle+'{enter}')
-		cy.visit('/')
-		cy.get('[data-cy="showTasks"] .card .task')
-			.last()
-			.should('not.contain.text', newTaskTitle)
-	})
-	
-	it('Should show a new task without a date at the bottom when there are < 50 tasks', () => {
-		seedTasks(40)
-		const newTaskTitle = 'New Task'
-		TaskFactory.create(1, {
-			id: 999,
-			title: newTaskTitle,
-		}, false)
-
-		cy.visit('/')
-		cy.get('[data-cy="showTasks"] .card .task')
-			.last()
-			.should('contain.text', newTaskTitle)
-	})
-	
-	it('Should show a task without a due date added via default list at the bottom', () => {
-		const {list} = seedTasks(40)
-		updateUserSettings({
-			default_list_id: list.id,
-			overdue_tasks_reminders_time: '9:00',
-		})
-		
-		const newTaskTitle = 'New Task'
-		cy.visit('/')
-		
-		cy.get('.add-task-textarea')
-			.type(`${newTaskTitle}{enter}`)
-		
-		cy.get('[data-cy="showTasks"] .card .task')
-			.last()
-			.should('contain.text', newTaskTitle)
-	})
-	
-	it('Should show the cta buttons for new list when there are no tasks', () => {
-		TaskFactory.truncate()
-		
-		cy.visit('/')
-		
-		cy.get('.home.app-content .content')
-			.should('contain.text', 'You can create a new list for your new tasks:')
-			.should('contain.text', 'Or import your lists and tasks from other services into Vikunja:')
-	})
-	
-	it('Should not show the cta buttons for new list when there are tasks', () => {
-		seedTasks()
-
-		cy.visit('/')
-
-		cy.get('.home.app-content .content')
-			.should('not.contain.text', 'You can create a new list for your new tasks:')
-			.should('not.contain.text', 'Or import your lists and tasks from other services into Vikunja:')
-	})
-})

cypress/e2e/task/task.spec.ts

@@ -1,581 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-import {TaskFactory} from '../../factories/task'
-import {ListFactory} from '../../factories/list'
-import {TaskCommentFactory} from '../../factories/task_comment'
-import {UserFactory} from '../../factories/user'
-import {NamespaceFactory} from '../../factories/namespace'
-import {UserListFactory} from '../../factories/users_list'
-import {TaskAssigneeFactory} from '../../factories/task_assignee'
-import {LabelFactory} from '../../factories/labels'
-import {LabelTaskFactory} from '../../factories/label_task'
-import {BucketFactory} from '../../factories/bucket'
-
-import {TaskAttachmentFactory} from '../../factories/task_attachments'
-
-function addLabelToTaskAndVerify(labelTitle: string) {
-	cy.get('.task-view .action-buttons .button')
-		.contains('Add Labels')
-		.click()
-	cy.get('.task-view .details.labels-list .multiselect input')
-		.type(labelTitle)
-	cy.get('.task-view .details.labels-list .multiselect .search-results')
-		.children()
-		.first()
-		.click()
-
-	cy.get('.global-notification', { timeout: 4000 })
-		.should('contain', 'Success')
-	cy.get('.task-view .details.labels-list .multiselect .input-wrapper span.tag')
-		.should('exist')
-		.should('contain', labelTitle)
-}
-
-function uploadAttachmentAndVerify(taskId: number) {
-	cy.intercept(`${Cypress.env('API_URL')}/tasks/${taskId}/attachments`).as('uploadAttachment')
-	cy.get('.task-view .action-buttons .button')
-		.contains('Add Attachments')
-		.click()
-	cy.get('input[type=file]', {timeout: 1000})
-		.selectFile('cypress/fixtures/image.jpg', {force: true}) // The input is not visible, but on purpose
-	cy.wait('@uploadAttachment')
-
-	cy.get('.attachments .attachments .files a.attachment')
-		.should('exist')
-}
-
-describe('Task', () => {
-	createFakeUserAndLogin()
-
-	let namespaces
-	let lists
-	let buckets
-
-	beforeEach(() => {
-		// UserFactory.create(1)
-		namespaces = NamespaceFactory.create(1)
-		lists = ListFactory.create(1)
-		buckets = BucketFactory.create(1, {
-			list_id: lists[0].id,
-		})
-		TaskFactory.truncate()
-		UserListFactory.truncate()
-	})
-
-	it('Should be created new', () => {
-		cy.visit('/lists/1/list')
-		cy.get('.input[placeholder="Add a new task…"')
-			.type('New Task')
-		cy.get('.button')
-			.contains('Add')
-			.click()
-		cy.get('.tasks .task .tasktext')
-			.first()
-			.should('contain', 'New Task')
-	})
-
-	it('Inserts new tasks at the top of the list', () => {
-		TaskFactory.create(1)
-
-		cy.visit('/lists/1/list')
-		cy.get('.list-is-empty-notice')
-			.should('not.exist')
-		cy.get('.input[placeholder="Add a new task…"')
-			.type('New Task')
-		cy.get('.button')
-			.contains('Add')
-			.click()
-
-		cy.wait(1000) // Wait for the request
-		cy.get('.tasks .task .tasktext')
-			.first()
-			.should('contain', 'New Task')
-	})
-
-	it('Marks a task as done', () => {
-		TaskFactory.create(1)
-
-		cy.visit('/lists/1/list')
-		cy.get('.tasks .task .fancycheckbox label.check')
-			.first()
-			.click()
-		cy.get('.global-notification')
-			.should('contain', 'Success')
-	})
-
-	it('Can add a task to favorites', () => {
-		TaskFactory.create(1)
-
-		cy.visit('/lists/1/list')
-		cy.get('.tasks .task .favorite')
-			.first()
-			.click()
-		cy.get('.menu.namespaces-lists')
-			.should('contain', 'Favorites')
-	})
-
-	describe('Task Detail View', () => {
-		beforeEach(() => {
-			TaskCommentFactory.truncate()
-			LabelTaskFactory.truncate()
-		})
-
-		it('Shows all task details', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				index: 1,
-				description: 'Lorem ipsum dolor sit amet.'
-			})
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view h1.title.input')
-				.should('contain', tasks[0].title)
-			cy.get('.task-view h1.title.task-id')
-				.should('contain', '#1')
-			cy.get('.task-view h6.subtitle')
-				.should('contain', namespaces[0].title)
-				.should('contain', lists[0].title)
-			cy.get('.task-view .details.content.description')
-				.should('contain', tasks[0].description)
-			cy.get('.task-view .action-buttons p.created')
-				.should('contain', 'Created')
-		})
-
-		it('Shows a done label for done tasks', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				index: 1,
-				done: true,
-				done_at: new Date().toISOString()
-			})
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view .heading .is-done')
-				.should('be.visible')
-				.should('contain', 'Done')
-			cy.get('.task-view .action-buttons p.created')
-				.scrollIntoView()
-				.should('be.visible')
-				.should('contain', 'Done')
-		})
-
-		it('Can mark a task as done', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				done: false,
-			})
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view .action-buttons .button')
-				.contains('Mark task done!')
-				.click()
-
-			cy.get('.task-view .heading .is-done')
-				.should('exist')
-				.should('contain', 'Done')
-			cy.get('.global-notification')
-				.should('contain', 'Success')
-			cy.get('.task-view .action-buttons .button')
-				.should('contain', 'Mark as undone')
-		})
-
-		it('Shows a task identifier since the list has one', () => {
-			const lists = ListFactory.create(1, {
-				id: 1,
-				identifier: 'TEST',
-			})
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				list_id: lists[0].id,
-				index: 1,
-			})
-
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view h1.title.task-id')
-				.should('contain', `${lists[0].identifier}-${tasks[0].index}`)
-		})
-
-		it('Can edit the description', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				description: 'Lorem ipsum dolor sit amet.'
-			})
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view .details.content.description .editor button')
-				.click()
-			cy.get('.task-view .details.content.description .editor .vue-easymde .EasyMDEContainer .CodeMirror-scroll')
-				.type('{selectall}New Description')
-			cy.get('[data-cy="saveEditor"]')
-				.contains('Save')
-				.click()
-
-			cy.get('.task-view .details.content.description h3 span.is-small.has-text-success')
-				.contains('Saved!')
-				.should('exist')
-		})
-
-		it('Can add a new comment', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-			})
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view .comments .media.comment .editor .vue-easymde .EasyMDEContainer .CodeMirror-scroll')
-				.should('be.visible')
-				.type('{selectall}New Comment')
-			cy.get('.task-view .comments .media.comment .button:not([disabled])')
-				.contains('Comment')
-				.should('be.visible')
-				.click()
-
-			cy.get('.task-view .comments .media.comment .editor')
-				.should('contain', 'New Comment')
-			cy.get('.global-notification')
-				.should('contain', 'Success')
-		})
-
-		it('Can move a task to another list', () => {
-			const lists = ListFactory.create(2)
-			BucketFactory.create(2, {
-				list_id: '{increment}'
-			})
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				list_id: lists[0].id,
-			})
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view .action-buttons .button')
-				.contains('Move')
-				.click()
-			cy.get('.task-view .content.details .field .multiselect.control .input-wrapper input')
-				.type(`${lists[1].title}{enter}`)
-			// The requests happen with a 200ms timeout. Because of that, the results are not yet there when cypress 
-			// presses enter and we can't simulate pressing on enter to select the item.
-			cy.get('.task-view .content.details .field .multiselect.control .search-results')
-				.children()
-				.first()
-				.click()
-
-			cy.get('.task-view h6.subtitle')
-				.should('contain', namespaces[0].title)
-				.should('contain', lists[1].title)
-			cy.get('.global-notification')
-				.should('contain', 'Success')
-		})
-
-		it('Can delete a task', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				list_id: 1,
-			})
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view .action-buttons .button')
-				.should('be.visible')
-				.contains('Delete')
-				.click()
-			cy.get('.modal-mask .modal-container .modal-content .header')
-				.should('contain', 'Delete this task')
-			cy.get('.modal-mask .modal-container .modal-content .actions .button')
-				.contains('Do it!')
-				.click()
-
-			cy.get('.global-notification')
-				.should('contain', 'Success')
-			cy.url()
-				.should('contain', `/lists/${tasks[0].list_id}/`)
-		})
-
-		it('Can add an assignee to a task', () => {
-			const users = UserFactory.create(5)
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				list_id: 1,
-			})
-			UserListFactory.create(5, {
-				list_id: 1,
-				user_id: '{increment}',
-			})
-
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('[data-cy="taskDetail.assign"]')
-				.click()
-			cy.get('.task-view .column.assignees .multiselect input')
-				.type(users[1].username)
-			cy.get('.task-view .column.assignees .multiselect .search-results')
-				.children()
-				.first()
-				.click()
-
-			cy.get('.global-notification')
-				.should('contain', 'Success')
-			cy.get('.task-view .column.assignees .multiselect .input-wrapper span.assignee')
-				.should('exist')
-		})
-
-		it('Can remove an assignee from a task', () => {
-			const users = UserFactory.create(2)
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				list_id: 1,
-			})
-			UserListFactory.create(5, {
-				list_id: 1,
-				user_id: '{increment}',
-			})
-			TaskAssigneeFactory.create(1, {
-				task_id: tasks[0].id,
-				user_id: users[1].id,
-			})
-
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view .column.assignees .multiselect .input-wrapper span.assignee')
-				.get('.remove-assignee')
-				.click()
-
-			cy.get('.global-notification')
-				.should('contain', 'Success')
-			cy.get('.task-view .column.assignees .multiselect .input-wrapper span.assignee')
-				.should('not.exist')
-		})
-
-		it('Can add a new label to a task', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				list_id: 1,
-			})
-			LabelFactory.truncate()
-			const newLabelText = 'some new label'
-
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view .action-buttons .button')
-				.contains('Add Labels')
-				.should('be.visible')
-				.click()
-			cy.get('.task-view .details.labels-list .multiselect input')
-				.type(newLabelText)
-			cy.get('.task-view .details.labels-list .multiselect .search-results')
-				.children()
-				.first()
-				.click()
-
-			cy.get('.global-notification')
-				.should('contain', 'Success')
-			cy.get('.task-view .details.labels-list .multiselect .input-wrapper span.tag')
-				.should('exist')
-				.should('contain', newLabelText)
-		})
-
-		it('Can add an existing label to a task', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				list_id: 1,
-			})
-			const labels = LabelFactory.create(1)
-			LabelTaskFactory.truncate()
-
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			addLabelToTaskAndVerify(labels[0].title)
-		})
-		
-		it('Can add a label to a task and it shows up on the kanban board afterwards', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				list_id: lists[0].id,
-				bucket_id: buckets[0].id,
-			})
-			const labels = LabelFactory.create(1)
-			LabelTaskFactory.truncate()
-			
-			cy.visit(`/lists/${lists[0].id}/kanban`)
-			
-			cy.get('.bucket .task')
-				.contains(tasks[0].title)
-				.click()
-			
-			addLabelToTaskAndVerify(labels[0].title)
-			
-			cy.get('.modal-content .close')
-				.click()
-			
-			cy.get('.bucket .task')
-				.should('contain.text', labels[0].title)
-		})
-
-		it('Can remove a label from a task', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				list_id: 1,
-			})
-			const labels = LabelFactory.create(1)
-			LabelTaskFactory.create(1, {
-				task_id: tasks[0].id,
-				label_id: labels[0].id,
-			})
-
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view .details.labels-list .multiselect .input-wrapper')
-				.should('be.visible')
-				.should('contain', labels[0].title)
-			cy.get('.task-view .details.labels-list .multiselect .input-wrapper')
-				.children()
-				.first()
-				.get('[data-cy="taskDetail.removeLabel"]')
-				.click()
-
-			cy.get('.global-notification')
-				.should('contain', 'Success')
-			cy.get('.task-view .details.labels-list .multiselect .input-wrapper')
-				.should('not.contain', labels[0].title)
-		})
-
-		it('Can set a due date for a task', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				done: false,
-			})
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view .action-buttons .button')
-				.contains('Set Due Date')
-				.click()
-			cy.get('.task-view .columns.details .column')
-				.contains('Due Date')
-				.get('.date-input .datepicker .show')
-				.click()
-			cy.get('.datepicker .datepicker-popup button')
-				.contains('Tomorrow')
-				.click()
-			cy.get('[data-cy="closeDatepicker"]')
-				.contains('Confirm')
-				.click()
-
-			cy.get('.task-view .columns.details .column')
-				.contains('Due Date')
-				.get('.date-input .datepicker-popup')
-				.should('not.exist')
-			cy.get('.global-notification')
-				.should('contain', 'Success')
-		})
-		
-		it('Can set a priority for a task', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-			})
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view .action-buttons .button')
-				.contains('Set Priority')
-				.click()
-			cy.get('.task-view .columns.details .column')
-				.contains('Priority')
-				.get('.select select')
-				.select('Urgent')
-			cy.get('.global-notification')
-				.should('contain', 'Success')
-
-			cy.get('.task-view .columns.details .column')
-				.contains('Priority')
-				.get('.select select')
-				.should('have.value', '4')
-		})
-
-		it('Can set the progress for a task', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-			})
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			cy.get('.task-view .action-buttons .button')
-				.contains('Set Progress')
-				.click()
-			cy.get('.task-view .columns.details .column')
-				.contains('Progress')
-				.get('.select select')
-				.select('50%')
-			cy.get('.global-notification')
-				.should('contain', 'Success')
-			
-			cy.wait(200)
-
-			cy.get('.task-view .columns.details .column')
-				.contains('Progress')
-				.get('.select select')
-				.should('be.visible')
-				.should('have.value', '0.5')
-		})
-		
-		it('Can add an attachment to a task', () => {
-			TaskAttachmentFactory.truncate()
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-			})
-			cy.visit(`/tasks/${tasks[0].id}`)
-
-			uploadAttachmentAndVerify(tasks[0].id)
-		})
-
-		it('Can add an attachment to a task and see it appearing on kanban', () => {
-			TaskAttachmentFactory.truncate()
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				list_id: lists[0].id,
-				bucket_id: buckets[0].id,
-			})
-			const labels = LabelFactory.create(1)
-			LabelTaskFactory.truncate()
-
-			cy.visit(`/lists/${lists[0].id}/kanban`)
-
-			cy.get('.bucket .task')
-				.contains(tasks[0].title)
-				.click()
-
-			uploadAttachmentAndVerify(tasks[0].id)
-
-			cy.get('.modal-content .close')
-				.click()
-
-			cy.get('.bucket .task .footer .icon svg.fa-paperclip')
-				.should('exist')
-		})
-		
-		it('Can check items off a checklist', () => {
-			const tasks = TaskFactory.create(1, {
-				id: 1,
-				description: `
-This is a checklist:
-
-* [ ] one item
-* [ ] another item
-* [ ] third item
-* [ ] fourth item
-* [x] and this one is already done
-`,
-			})
-			cy.visit(`/tasks/${tasks[0].id}`)
-			
-			cy.get('.task-view .checklist-summary')
-				.should('contain.text', '1 of 5 tasks')
-			cy.get('.editor .content ul > li input[type=checkbox]')
-				.eq(2)
-				.click()
-			
-			cy.get('.editor .content ul > li input[type=checkbox]')
-				.eq(2)
-				.should('be.checked')
-			cy.get('.editor .content input[type=checkbox]')
-				.should('have.length', 5)
-			cy.get('.task-view .checklist-summary')
-				.should('contain.text', '2 of 5 tasks')
-		})
-	})
-})

cypress/e2e/tsconfig.json

@@ -1,11 +0,0 @@
-{
-  "extends": "@vue/tsconfig/tsconfig.web.json",
-  "include": ["./**/*", "../support/**/*", "../factories/**/*"],
-  "compilerOptions": {
-    "baseUrl": ".",
-    "isolatedModules": false,
-    "target": "ES2015",
-    "lib": ["ESNext", "dom"],
-    "types": ["cypress"]
-  }
-}

cypress/e2e/user/login.spec.ts

@@ -1,58 +0,0 @@
-import {UserFactory} from '../../factories/user'
-
-const testAndAssertFailed = fixture => {
-	cy.visit('/login')
-	cy.get('input[id=username]').type(fixture.username)
-	cy.get('input[id=password]').type(fixture.password)
-	cy.get('.button').contains('Login').click()
-
-	cy.wait(5000) // It can take waaaayy too long to log the user in
-	cy.url().should('include', '/')
-	cy.get('div.message.danger').contains('Wrong username or password.')
-}
-
-const username = 'test'
-
-context('Login', () => {
-	beforeEach(() => {
-		UserFactory.create(1, {username})
-	})
-
-	it('Should log in with the right credentials', () => {
-		const fixture = {
-			username: 'test',
-			password: '1234',
-		}
-
-		cy.visit('/login')
-		cy.get('input[id=username]').type(fixture.username)
-		cy.get('input[id=password]').type(fixture.password)
-		cy.get('.button').contains('Login').click()
-		cy.url().should('include', '/')
-		cy.clock(1625656161057) // 13:00
-		cy.get('h2').should('contain', `Hi ${fixture.username}!`)
-	})
-
-	it('Should fail with a bad password', () => {
-		const fixture = {
-			username: 'test',
-			password: '123456',
-		}
-
-		testAndAssertFailed(fixture)
-	})
-
-	it('Should fail with a bad username', () => {
-		const fixture = {
-			username: 'loremipsum',
-			password: '1234',
-		}
-
-		testAndAssertFailed(fixture)
-	})
-	
-	it('Should redirect to /login when no user is logged in', () => {
-		cy.visit('/')
-		cy.url().should('include', '/login')
-	})
-})

cypress/e2e/user/logout.spec.ts

@@ -1,46 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-import {createLists} from '../list/prepareLists'
-
-function logout() {
-	cy.get('.navbar .username-dropdown-trigger')
-		.click()
-	cy.get('.navbar .dropdown-item')
-		.contains('Logout')
-		.click()
-}
-
-describe('Log out', () => {
-	createFakeUserAndLogin()
-
-	it('Logs the user out', () => {
-		cy.visit('/')
-
-		expect(localStorage.getItem('token')).to.not.eq(null)
-
-		logout()
-
-		cy.url()
-			.should('contain', '/login')
-			.then(() => {
-				expect(localStorage.getItem('token')).to.eq(null)
-			})
-	})
-	
-	it.skip('Should clear the list history after logging the user out', () => {
-		const lists = createLists()
-		cy.visit(`/lists/${lists[0].id}`)
-			.then(() => {
-				expect(localStorage.getItem('listHistory')).to.not.eq(null)
-			})
-
-		logout()
-
-		cy.wait(1000) // This makes re-loading of the list and associated entities (and the resulting error) visible
-		
-		cy.url()
-			.should('contain', '/login')
-			.then(() => {
-				expect(localStorage.getItem('listHistory')).to.eq(null)
-			})
-	})
-})

cypress/e2e/user/registration.spec.ts

@@ -1,48 +0,0 @@
-// This test assumes no mailer is set up and all users are activated immediately.
-
-import {UserFactory} from '../../factories/user'
-
-context('Registration', () => {
-	beforeEach(() => {
-		UserFactory.create(1, {
-			username: 'test',
-		})
-		cy.visit('/', {
-			onBeforeLoad(win) {
-				win.localStorage.removeItem('token')
-			},
-		})
-	})
-
-	it('Should work without issues', () => {
-		const fixture = {
-			username: 'testuser',
-			password: '123456',
-			email: 'testuser@example.com',
-		}
-
-		cy.visit('/register')
-		cy.get('#username').type(fixture.username)
-		cy.get('#email').type(fixture.email)
-		cy.get('#password').type(fixture.password)
-		cy.get('#register-submit').click()
-		cy.url().should('include', '/')
-		cy.clock(1625656161057) // 13:00
-		cy.get('h2').should('contain', `Hi ${fixture.username}!`)
-	})
-
-	it.only('Should fail', () => {
-		const fixture = {
-			username: 'test',
-			password: '123456',
-			email: 'testuser@example.com',
-		}
-
-		cy.visit('/register')
-		cy.get('#username').type(fixture.username)
-		cy.get('#email').type(fixture.email)
-		cy.get('#password').type(fixture.password)
-		cy.get('#register-submit').click()
-		cy.get('div.message.danger').contains('A user with this username already exists.')
-	})
-})

cypress/e2e/user/settings.spec.ts

@@ -1,43 +0,0 @@
-import {createFakeUserAndLogin} from '../../support/authenticateUser'
-
-describe('User Settings', () => {
-	createFakeUserAndLogin()
-
-	it('Changes the user avatar', () => {
-		cy.intercept(`${Cypress.env('API_URL')}/user/settings/avatar/upload`).as('uploadAvatar')
-		
-		cy.visit('/user/settings/avatar')
-
-		cy.get('input[name=avatarProvider][value=upload]')
-			.click()
-		cy.get('input[type=file]', {timeout: 1000})
-			.selectFile('cypress/fixtures/image.jpg', {force: true}) // The input is not visible, but on purpose
-		cy.get('.vue-handler-wrapper.vue-handler-wrapper--south .vue-simple-handler.vue-simple-handler--south')
-			.trigger('mousedown', {which: 1})
-			.trigger('mousemove', {clientY: 100})
-			.trigger('mouseup')
-		cy.get('[data-cy="uploadAvatar"]')
-			.contains('Upload Avatar')
-			.click()
-
-		cy.wait('@uploadAvatar')
-		cy.get('.global-notification')
-			.should('contain', 'Success')
-	})
-
-	it('Updates the name', () => {
-		cy.visit('/user/settings/general')
-
-		cy.get('.general-settings .control input.input')
-			.first()
-			.type('Lorem Ipsum')
-		cy.get('[data-cy="saveGeneralSettings"]')
-			.contains('Save')
-			.click()
-
-		cy.get('.global-notification')
-			.should('contain', 'Success')
-		cy.get('.navbar .username-dropdown-trigger .username')
-			.should('contain', 'Lorem Ipsum')
-	})
-})

cypress/factories/bucket.ts

@@ -1,19 +0,0 @@
-import {faker} from '@faker-js/faker'
-import {Factory} from '../support/factory'
-
-export class BucketFactory extends Factory {
-	static table = 'buckets'
-
-	static factory() {
-		const now = new Date()
-
-		return {
-			id: '{increment}',
-			title: faker.lorem.words(3),
-			list_id: 1,
-			created_by_id: 1,
-			created: now.toISOString(),
-			updated: now.toISOString(),
-		}
-	}
-}

cypress/factories/label_task.ts

@@ -1,16 +0,0 @@
-import {Factory} from '../support/factory'
-
-export class LabelTaskFactory extends Factory {
-	static table = 'label_tasks'
-
-	static factory() {
-		const now = new Date()
-
-		return {
-			id: '{increment}',
-			task_id: 1,
-			label_id: 1,
-			created: now.toISOString(),
-		}
-	}
-}

cypress/factories/labels.ts

@@ -1,21 +0,0 @@
-import {faker} from '@faker-js/faker'
-
-import {Factory} from '../support/factory'
-
-export class LabelFactory extends Factory {
-	static table = 'labels'
-
-	static factory() {
-		const now = new Date()
-
-		return {
-			id: '{increment}',
-			title: faker.lorem.words(2),
-			description: faker.lorem.text(10),
-			hex_color: (Math.random()*0xFFFFFF<<0).toString(16), // random 6-digit hex number
-			created_by_id: 1,
-			created: now.toISOString(),
-			updated: now.toISOString(),
-		}
-	}
-}

cypress/factories/link_sharing.ts

@@ -1,21 +0,0 @@
-import {Factory} from '../support/factory'
-import {faker} from '@faker-js/faker'
-
-export class LinkShareFactory extends Factory {
-	static table = 'link_shares'
-
-	static factory() {
-		const now = new Date()
-
-		return {
-			id: '{increment}',
-			hash: faker.random.word(32),
-			list_id: 1,
-			right: 0,
-			sharing_type: 0,
-			shared_by_id: 1,
-			created: now.toISOString(),
-			updated: now.toISOString(),
-		}
-	}
-}

cypress/factories/list.ts

@@ -1,19 +0,0 @@
-import {Factory} from '../support/factory'
-import {faker} from '@faker-js/faker'
-
-export class ListFactory extends Factory {
-	static table = 'lists'
-
-	static factory() {
-		const now = new Date()
-
-		return {
-			id: '{increment}',
-			title: faker.lorem.words(3),
-			owner_id: 1,
-			namespace_id: 1,
-			created: now.toISOString(),
-			updated: now.toISOString(),
-		}
-	}
-}

cypress/factories/namespace.ts

@@ -1,18 +0,0 @@
-import {faker} from '@faker-js/faker'
-import {Factory} from '../support/factory'
-
-export class NamespaceFactory extends Factory {
-	static table = 'namespaces'
-
-	static factory() {
-		const now = new Date()
-
-		return {
-			id: '{increment}',
-			title: faker.lorem.words(3),
-			owner_id: 1,
-			created: now.toISOString(),
-			updated: now.toISOString(),
-		}
-	}
-}

cypress/factories/task.ts

@@ -1,22 +0,0 @@
-import {faker} from '@faker-js/faker'
-import {Factory} from '../support/factory'
-
-export class TaskFactory extends Factory {
-	static table = 'tasks'
-
-	static factory() {
-		const now = new Date()
-
-		return {
-			id: '{increment}',
-			title: faker.lorem.words(3),
-			done: false,
-			list_id: 1,
-			created_by_id: 1,
-			index: '{increment}',
-			position: '{increment}',
-			created: now.toISOString(),
-			updated: now.toISOString()
-		}
-	}
-}

cypress/factories/task_assignee.ts

@@ -1,16 +0,0 @@
-import {Factory} from '../support/factory'
-
-export class TaskAssigneeFactory extends Factory {
-	static table = 'task_assignees'
-
-	static factory() {
-		const now = new Date()
-
-		return {
-			id: '{increment}',
-			task_id: 1,
-			user_id: 1,
-			created: now.toISOString(),
-		}
-	}
-}

cypress/factories/task_attachments.ts

@@ -1,16 +0,0 @@
-import {Factory} from '../support/factory'
-
-export class TaskAttachmentFactory extends Factory {
-	static table = 'task_attachments'
-	
-	static factory() {
-		const now = new Date()
-
-		return {
-			id: '{increment}',
-			task_id: 1,
-			file_id: 1,
-			created: now.toISOString(),
-		}
-	}
-}

cypress/factories/task_comment.ts

@@ -1,20 +0,0 @@
-import {faker} from '@faker-js/faker'
-
-import {Factory} from '../support/factory'
-
-export class TaskCommentFactory extends Factory {
-	static table = 'task_comments'
-
-	static factory() {
-		const now = new Date()
-
-		return {
-			id: '{increment}',
-			comment: faker.lorem.text(3),
-			author_id: 1,
-			task_id: 1,
-			created: now.toISOString(),
-			updated: now.toISOString()
-		}
-	}
-}

cypress/factories/team.ts

@@ -1,17 +0,0 @@
-import {faker} from '@faker-js/faker'
-import {Factory} from '../support/factory'
-
-export class TeamFactory extends Factory {
-    static table = 'teams'
-
-    static factory() {
-        const now = new Date()
-
-        return {
-            name: faker.lorem.words(3),
-            created_by_id: 1,
-			created: now.toISOString(),
-			updated: now.toISOString(),
-        }
-    }
-}

cypress/factories/team_member.ts

@@ -1,14 +0,0 @@
-import {Factory} from '../support/factory'
-
-export class TeamMemberFactory extends Factory {
-    static table = 'team_members'
-
-    static factory() {
-        return {
-            team_id: 1,
-            user_id: 1,
-            admin: false,
-            created: new Date().toISOString(),
-        }
-    }
-}

cypress/factories/user.ts

@@ -1,21 +0,0 @@
-import {faker} from '@faker-js/faker'
-
-import {Factory} from '../support/factory'
-
-export class UserFactory extends Factory {
-	static table = 'users'
-
-	static factory() {
-		const now = new Date()
-
-		return {
-            id: '{increment}',
-            username: faker.lorem.word(10) + faker.datatype.uuid(),
-            password: '$2a$14$dcadBoMBL9jQoOcZK8Fju.cy0Ptx2oZECkKLnaa8ekRoTFe1w7To.', // 1234
-			status: 0,
-			issuer: 'local',
-			created: now.toISOString(),
-			updated: now.toISOString(),
-		}
-	}
-}

cypress/factories/users_list.ts

@@ -1,18 +0,0 @@
-import {Factory} from '../support/factory'
-
-export class UserListFactory extends Factory {
-	static table = 'users_lists'
-
-	static factory() {
-		const now = new Date()
-
-		return {
-			id: '{increment}',
-			list_id: 1,
-			user_id: 1,
-			right: 0,
-			created: now.toISOString(),
-			updated: now.toISOString(),
-		}
-	}
-}

cypress/support/authenticateUser.ts

@@ -1,35 +0,0 @@
-
-// This authenticates a user and puts the token in local storage which allows us to perform authenticated requests.
-// Built after https://github.com/cypress-io/cypress-example-recipes/tree/bd2d6ffb33214884cab343d38e7f9e6ebffb323f/examples/logging-in__jwt
-
-import {UserFactory} from '../factories/user'
-
-export function login(user, cacheAcrossSpecs = false) {
-	if (!user) {
-		throw new Error('Needs user')
-	}
-	// Caching session when logging in via page visit
-	cy.session(`user__${user.username}`, () => {
-		cy.request('POST', `${Cypress.env('API_URL')}/login`, {
-			username: user.username,
-			password: '1234',
-		}).then(({ body }) => {
-			window.localStorage.setItem('token', body.token)
-		})
-	}, {
-    cacheAcrossSpecs,
-  })
-}
-
-export function createFakeUserAndLogin() {
-	let user
-	before(() => {
-		user = UserFactory.create(1)[0]
-	})
-
-	beforeEach(() => {
-		login(user, true)
-	})
-
-	return user
-}

cypress/support/commands.ts

@@ -1,37 +0,0 @@
-/// <reference types="cypress" />
-// ***********************************************
-// This example commands.ts shows you how to
-// create various custom commands and overwrite
-// existing commands.
-//
-// For more comprehensive examples of custom
-// commands please read more here:
-// https://on.cypress.io/custom-commands
-// ***********************************************
-//
-//
-// -- This is a parent command --
-// Cypress.Commands.add('login', (email, password) => { ... })
-//
-//
-// -- This is a child command --
-// Cypress.Commands.add('drag', { prevSubject: 'element'}, (subject, options) => { ... })
-//
-//
-// -- This is a dual command --
-// Cypress.Commands.add('dismiss', { prevSubject: 'optional'}, (subject, options) => { ... })
-//
-//
-// -- This will overwrite an existing command --
-// Cypress.Commands.overwrite('visit', (originalFn, url, options) => { ... })
-//
-// declare global {
-//   namespace Cypress {
-//     interface Chainable {
-//       login(email: string, password: string): Chainable<void>
-//       drag(subject: string, options?: Partial<TypeOptions>): Chainable<Element>
-//       dismiss(subject: string, options?: Partial<TypeOptions>): Chainable<Element>
-//       visit(originalFn: CommandOriginalFn, url: string, options: Partial<VisitOptions>): Chainable<Element>
-//     }
-//   }
-// }

cypress/support/component.index.html

@@ -1,12 +0,0 @@
-<!DOCTYPE html>
-<html>
-  <head>
-    <meta charset="utf-8">
-    <meta http-equiv="X-UA-Compatible" content="IE=edge">
-    <meta name="viewport" content="width=device-width,initial-scale=1.0">
-    <title>Components App</title>
-  </head>
-  <body>
-    <div data-cy-root></div>
-  </body>
-</html>

cypress/support/component.ts

@@ -1,29 +0,0 @@
-// ***********************************************************
-// This example support/component.ts is processed and
-// loaded automatically before your test files.
-//
-// This is a great place to put global configuration and
-// behavior that modifies Cypress.
-//
-// You can change the location of this file or turn off
-// automatically serving support files with the
-// 'supportFile' configuration option.
-//
-// You can read more here:
-// https://on.cypress.io/configuration
-// ***********************************************************
-
-// Import commands.js using ES2015 syntax:
-import './commands'
-
-// Alternatively you can use CommonJS syntax:
-// require('./commands')
-
-import { mount } from 'cypress/vue'
-// Ensure global styles are loaded
-import '../../src/styles/global.scss';
-
-Cypress.Commands.add('mount', mount)
-
-// Example use:
-// cy.mount(MyComponent)

cypress/support/e2e.ts

@@ -1,10 +0,0 @@
-
-import './commands'
-import '@4tw/cypress-drag-drop'
-
-// see https://github.com/cypress-io/cypress/issues/702#issuecomment-587127275
-Cypress.on('window:before:load', (win) => {
-	// disable service workers
-	// @ts-ignore
-	delete win.navigator.__proto__.ServiceWorker
-})

cypress/support/factory.ts

@@ -1,52 +0,0 @@
-import {seed} from './seed'
-
-/**
- * A factory makes it easy to seed the database with data.
- */
-export class Factory {
-	static table = null
-
-	static factory() {
-		return {}
-	}
-
-	/**
-	 * Seeds a bunch of fake data into the database.
-	 *
-	 * Takes an override object as its single argument which will override the data from the factory.
-	 * If the value of one of the override fields is `{increment}` that value will be replaced with an incrementing
-	 * number through all created entities.
-	 *
-	 * @param override
-	 * @returns {[]}
-	 */
-	static create(count = 1, override = {}, truncate = true) {
-		const data = []
-
-		for (let i = 1; i <= count; i++) {
-			const entry = {
-				...this.factory(),
-				...override,
-			}
-			for (const e in entry) {
-				if(typeof entry[e] === 'function') {
-					entry[e] = entry[e](i)
-					continue
-				}
-				if (entry[e] === '{increment}') {
-					entry[e] = i
-				}
-			}
-			data.push(entry)
-		}
-
-		seed(this.table, data, truncate)
-
-		return data
-	}
-
-	static truncate() {
-		seed(this.table, null)
-	}
-}
-

cypress/support/seed.ts

@@ -1,24 +0,0 @@
-/**
- * Seeds a db table with data. If a data object is provided as the second argument, it will load the fixtures
- * file for the table and merge the data from it with the passed data. This allows you to override specific
- * fields of the fixtures without having to redeclare the whole fixture.
- *
- * Passing null as the second argument empties the table.
- *
- * @param table
- * @param data
- */
-export function seed(table, data = {}, truncate = true) {
-	if (data === null) {
-		data = []
-	}
-
-	cy.request({
-		method: 'PATCH',
-		url: `${Cypress.env('API_URL')}/test/${table}?truncate=${truncate ? 'true' : 'false'}`,
-		headers: {
-			'Authorization': Cypress.env('TEST_SECRET'),
-		},
-		body: data,
-	})
-}

cypress/support/updateUserSettings.ts

@@ -1,26 +0,0 @@
-
-export function updateUserSettings(settings) {
-	const token = `Bearer ${window.localStorage.getItem('token')}`
-	
-	return cy.request({
-		method: 'GET',
-		url: `${Cypress.env('API_URL')}/user`,
-		headers: {
-			'Authorization': token,
-		},
-	})
-		.its('body')
-		.then(oldSettings => {
-			return cy.request({
-				method: 'POST',
-				url: `${Cypress.env('API_URL')}/user/settings/general`,
-				headers: {
-					'Authorization': token,
-				},
-				body: {
-					...oldSettings,
-					...settings,
-				},
-			})
-		})
-}

docker/entrypoint.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env sh
+set -e
+
+if [ -n "$PUID" ] && [ "$PUID" -ne 0 ] && \
+   [ -n "$PGID" ] && [ "$PGID" -ne 0 ] ; then
+  echo "info: creating the new user vikunja with $PUID:$PGID"
+  groupmod -g "$PGID" -o vikunja
+  usermod -u "$PUID" -o vikunja
+  chown -R vikunja:vikunja ./
+  exec su vikunja -c /app/vikunja/vikunja "$@"
+else
+  echo "info: creation of non-root user is skipped"
+  exec /app/vikunja/vikunja "$@"
+fi

docker/injector.sh

@@ -1,15 +0,0 @@
-#!/usr/bin/env sh
-set -e
-
-echo "info: API URL is $VIKUNJA_API_URL"
-echo "info: Sentry enabled: $VIKUNJA_SENTRY_ENABLED"
-
-# Escape the variable to prevent sed from complaining
-VIKUNJA_API_URL="$(echo "$VIKUNJA_API_URL" | sed -r 's/([:;])/\\\1/g')"
-VIKUNJA_SENTRY_DSN="$(echo "$VIKUNJA_SENTRY_DSN" | sed -r 's/([:;])/\\\1/g')"
-
-sed -ri "s:^(\s*window.API_URL\s*=)\s*.+:\1 '${VIKUNJA_API_URL}':g" /usr/share/nginx/html/index.html
-sed -ri "s:^(\s*window.SENTRY_ENABLED\s*=)\s*.+:\1 ${VIKUNJA_SENTRY_ENABLED}:g" /usr/share/nginx/html/index.html
-sed -ri "s:^(\s*window.SENTRY_DSN\s*=)\s*.+:\1 '${VIKUNJA_SENTRY_DSN}':g" /usr/share/nginx/html/index.html
-
-date -uIseconds | xargs echo 'info: started at'

docker/ipv6-disable.sh

@@ -1,19 +0,0 @@
-#!/usr/bin/env sh
-set -e
-
-if [ ! -f "/proc/net/if_inet6" ]; then
-  echo "info: IPv6 is not available! Removing IPv6 listen configuration"
-  find /etc/nginx/conf.d -name '*.conf' -type f | \
-  while IFS= read -r CONFIG; do
-    sed -r '/^\s*listen\s*\[::\]:.+$/d' "$CONFIG" > "$CONFIG.temp"
-    if ! diff -U 5 "$CONFIG" "$CONFIG.temp" > "$CONFIG.diff"; then
-      echo "info: Removing IPv6 lines from $CONFIG" | \
-      cat - "$CONFIG.diff"
-      echo "# IPv6 is disabled because /proc/net/if_inet6 was not found" | \
-      cat - "$CONFIG.temp" > "$CONFIG"
-    else
-      echo "info: Skipping $CONFIG because it does not have IPv6 listen"
-    fi
-    rm -f "$CONFIG.temp" "$CONFIG.diff"
-  done
-fi

docker/nginx.conf

@@ -1,112 +0,0 @@
-# Generated by nginxconfig.io
-# https://www.digitalocean.com/community/tools/nginx?domains.0.server.domain=localhost&domains.0.server.documentRoot=%2Fusr%2Fshare%2Fnginx%2Fhtml&domains.0.server.cdnSubdomain=true&domains.0.https.https=false&domains.0.php.php=false&domains.0.routing.index=index.html&domains.0.routing.fallbackHtml=true&domains.0.routing.fallbackPhp=false&global.performance.assetsExpiration=1d&global.performance.mediaExpiration=1d&global.performance.svgExpiration=1d&global.performance.fontsExpiration=1d&global.logging.accessLog=%2Fdev%2Fstdout&global.logging.errorLog=%2Fdev%2Fstderr%20warn&global.logging.logNotFound=true&global.nginx.user=nginx&global.nginx.pid=%2Fvar%2Frun%2Fnginx.pid&global.nginx.clientMaxBodySize=50&global.docker.dockerfile=true&global.tools.modularizedStructure=false&global.tools.symlinkVhost=false
-# and then edited manually ;)
-
-pid                  /tmp/nginx.pid;
-worker_processes     auto;
-worker_rlimit_nofile 65535;
-
-events {
-  multi_accept       on;
-  worker_connections  1024;
-}
-
-http {
-  charset                utf-8;
-  sendfile               on;
-  tcp_nopush             on;
-  tcp_nodelay            on;
-  server_tokens          off;
-  types_hash_max_size    2048;
-  types_hash_bucket_size 64;
-
-  # rootless
-  client_body_temp_path /tmp/client_temp;
-  proxy_temp_path       /tmp/proxy_temp_path;
-  fastcgi_temp_path     /tmp/fastcgi_temp;
-  uwsgi_temp_path       /tmp/uwsgi_temp;
-  scgi_temp_path        /tmp/scgi_temp;
-
-  # MIME
-  include                mime.types;
-  default_type           application/octet-stream;
-  types {
-    application/manifest+json webmanifest;
-  }
-
-  # Logging
-  log_format json escape=json
-    '{'
-      '"bytes_sent": "$bytes_sent",'
-      '"http_user_agent": "$http_user_agent",'
-      '"nginx_version": "$nginx_version",'
-      '"query_string": "$query_string",'
-      '"realip_remote_addr": "$realip_remote_addr",'
-      '"remote_addr": "$remote_addr",'
-      '"remote_user": "$remote_user",'
-      '"request_length": "$request_length",'
-      '"request_method": "$request_method",'
-      '"request_time": "$request_time",'
-      '"server_addr": "$server_addr",'
-      '"server_port": "$server_port",'
-      '"server_protocol": "$server_protocol",'
-      '"status": "$status",'
-      '"time_local": "$time_local",'
-      '"uri": "$uri"' 
-    '}';
-
-  log_format main '$remote_addr - $remote_user [$time_local] "$request" '
-                  '$status $body_bytes_sent "$http_referer" '
-                  '"$http_user_agent" "$http_x_forwarded_for"';
-
-  access_log             /dev/stdout main;
-  error_log              /dev/stderr warn;
-
-  keepalive_timeout  65;
-
-  # compression
-  gzip            on;
-  gzip_vary       on;
-  gzip_proxied    any;
-  gzip_comp_level 6;
-  gzip_buffers    16 8k;
-  gzip_http_version 1.1;
-  gzip_min_length 256;
-  gzip_types
-    text/plain
-    text/css
-    application/json
-    application/x-javascript
-    application/javascript
-    text/xml
-    application/xml
-    application/xml+rss
-    text/javascript
-    application/vnd.ms-fontobject
-    application/x-font-ttf
-    font/opentype
-    image/svg+xml
-    image/x-icon
-    audio/wav;
-
-  map_hash_max_size 128;
-  map_hash_bucket_size 128;
-
-  map $sent_http_content_type $expires {
-    default                       off;
-    text/css                      max;
-    application/javascript        max;
-    text/javascript               max;
-    application/vnd.ms-fontobject max;
-    application/x-font-ttf        max;
-    font/opentype                 max;
-    font/woff2                    max;
-    image/svg+xml                 max;
-    image/x-icon                  max;
-    audio/wav                     max;
-    ~images/                      max;
-    ~font/                        max;
-  }
-
-  include /etc/nginx/conf.d/*.conf;
-}

docker/templates/default.conf.template

@@ -1,85 +0,0 @@
-server {
-  listen      ${VIKUNJA_HTTP_PORT};
-  listen      [::]:${VIKUNJA_HTTP_PORT};
-  ## Needed when behind HAProxy with SSL termination + HTTP/2 support
-  listen      ${VIKUNJA_HTTP2_PORT}  default_server http2 proxy_protocol;
-  listen      [::]:${VIKUNJA_HTTP2_PORT} default_server http2 proxy_protocol;
-
-  server_name _;
-  expires     $expires;
-  root        /usr/share/nginx/html;
-  access_log  /dev/stdout ${VIKUNJA_LOG_FORMAT};
-  # security headers
-  add_header X-XSS-Protection        "1; mode=block" always;
-  add_header X-Content-Type-Options  "nosniff" always;
-  add_header Referrer-Policy         "no-referrer-when-downgrade" always;
-  add_header Content-Security-Policy "default-src 'self' http: https: ws: wss: data: blob: 'unsafe-inline'; frame-ancestors 'self';" always;
-  add_header Permissions-Policy      "interest-cohort=()" always;
-
-  # . files
-  location ~ /\.(?!well-known) {
-    deny all;
-  }
-
-  # assume that everything else is handled by the application router, by injecting the index.html.
-  location / {
-    autoindex off;
-    expires off;
-    add_header Cache-Control "public, max-age=0, s-maxage=0, must-revalidate" always;
-    try_files $uri /index.html =404;
-  }
-  
-  # Disable caching for sw
-  location = /sw.js {
-    autoindex off;
-    expires off;
-    add_header Cache-Control "public, max-age=0, s-maxage=0, must-revalidate" always;
-  }
-
-  # Disable caching for webmanifest
-  location = /manifest.webmanifest {
-    autoindex off;
-    expires off;
-    add_header Cache-Control "public, max-age=0, s-maxage=0, must-revalidate" always;
-  }
-
-  # favicon.ico
-  location = /favicon.ico {
-    log_not_found off;
-    access_log    off;
-  }
-
-  # robots.txt
-  location = /robots.txt {
-    log_not_found off;
-    access_log    off;
-    expires -1; # no-cache
-  }
-
-  location = /ready {
-    return 200 "";
-    access_log off;
-    expires -1; # no-cache
-  }
-
-  # all assets contain hash in filename, cache forever
-  location ^~ /assets/ {
-    add_header Cache-Control "public, max-age=31536000, s-maxage=31536000, immutable";
-    try_files $uri =404;
-  }
-
-  # all workbox scripts are compiled with hash in filename, cache forever3
-  location ^~ /workbox- {
-    add_header Cache-Control "public, max-age=31536000, s-maxage=31536000, immutable";
-    try_files $uri =404;
-  }
-
-  # assets, media
-  location ~* .(txt|webmanifest|css|js|mjs|map|svg|jpg|jpeg|png|ico|ttf|woff|woff2|wav)$ {
-    try_files $uri $uri/ =404;
-  }
-
-  error_page   500 502 503 504  /50x.html;
-  location = /50x.html { }
-
-}

docs/Dockerfile

@@ -0,0 +1,3 @@
+FROM nginx
+ADD public /usr/share/nginx/html/docs
+ADD nginx.conf /etc/nginx/conf.d/default.conf

docs/config.yml

@@ -0,0 +1,50 @@
+baseurl: https://vikunja.io/docs/
+title: Vikunja
+theme: vikunja
+enableRobotsTXT: true
+canonifyURLs: false
+
+pygmentsUseClasses: true
+
+permalinks:
+  post: /:year/:month/:title/
+  doc: /:slug/
+  page: /:slug/
+  default: /:slug/
+
+params:
+  description: The to-do app to organize your life
+  author: The Vikunja Authors
+  website: https://vikunja.io
+  plausibleEnabled: true
+  plausibleDomain: vikunja.io
+  plausibleURL: https://analytics.kolaente.de
+
+markup:
+  goldmark:
+    renderer:
+      unsafe: true
+
+menu:
+  page:
+    - name: Home
+      url: https://vikunja.io/en/
+      weight: 10
+    - name: Features
+      url: https://vikunja.io/features
+      weight: 20
+    - name: Download
+      url: https://vikunja.io/download
+      weight: 30
+    - name: Docs
+      url: https://vikunja.io/docs
+      weight: 40
+    - name: Code
+      url: https://code.vikunja.io/
+      weight: 50
+    - name: Community
+      url: https://community.vikunja.io/
+      weight: 60
+    - name: Get it Hosted
+      url: https://vikunja.cloud/?utm_source=io&utm_medium=io&utm_campaign=menu
+      weight: 70

docs/content/doc/_index.md

@@ -0,0 +1,25 @@
+---
+date: "2019-02-12:00:00+02:00"
+title: "Docs"
+draft: false
+url: "/docs"
+type: "doc"
+weight: 10
+---
+# Documentation
+
+This is the documentation for Vikunja.
+You can find available articles in the menu on the left.
+
+## About
+
+To learn more about the what, why and how, take a look at [the features page](https://vikunja.io/en/features).
+
+## Start
+
+A good starting point if you want to install and host Vikunja on your server are [the install documentation]({{< ref "./setup/install.md">}})
+and [available configuration options]({{< ref "./setup/config.md">}}).
+
+## Developing
+
+If you want to start contributing to Vikunja, take a look at [the development docs]({{< ref "./development/development.md">}}).

docs/content/doc/development/cli.md

@@ -0,0 +1,34 @@
+---
+date: "2019-03-31:00:00+01:00"
+title: "Cli Commands"
+draft: false
+type: "doc"
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Adding new cli commands
+
+All cli-related functions are located in `pkg/cmd`.
+Each cli command usually calls a function in another package.
+For example, the `vikunja migrate` command calls `migration.Migrate()`. 
+
+Vikunja uses the amazing [cobra](https://github.com/spf13/cobra) library for its cli.
+Please refer to its documentation for informations about how to use flags etc.
+
+To add a new cli command, add something like the following:
+
+{{< highlight golang >}}
+func init() {
+	rootCmd.AddCommand(myCmd)
+}
+
+var myCmd = &cobra.Command{
+	Use:   "My-command",
+	Short: "A short description about your command.",
+	Run: func(cmd *cobra.Command, args []string) {
+		// Call other functions
+	},
+}
+{{</ highlight >}}

docs/content/doc/development/config.md

@@ -0,0 +1,41 @@
+---
+date: "2019-02-12:00:00+02:00"
+title: "Configuration Options"
+draft: false
+type: "doc"
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Configuration options
+
+All configuration variables are declared in the `config` package.
+It uses [viper](https://github.com/spf13/viper) under the hood to handle setting defaults and parsing config files.
+Viper handles parsing all different configuration sources.
+
+## Adding new config options
+
+To make handling configuration parameters a bit easier, we introduced a `Key` string type in the `config` package which 
+you can call directly to get a config value.
+
+To add a new config option, you should add a new key const to `pkg/config/config.go` and possibly a default value.
+Default values should always enable the feature to work or turn it off completely if it always needs
+additional configuration.
+
+Make sure to also add the new config option to the default config file (`config.yml.sample` at the root of the repository) 
+with an explanatory comment to make sure it is well documented.
+Then run `mage generate-docs` to generate the configuration docs from the sample file.
+
+## Getting Configuration Values
+
+To retreive a configured value call the key with a getter for the type you need.
+For example:
+
+{{< highlight golang >}}
+if config.CacheEnabled.GetBool() {
+	// Do something with enabled caches
+}
+{{< /highlight >}}
+
+Take a look at the methods declared on the type to see what's available.

docs/content/doc/development/cron.md

@@ -0,0 +1,35 @@
+---
+title: "Cron Tasks"
+date: 2021-07-13T23:21:52+02:00
+draft: false
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# How to add a cron job task
+
+Cron jobs are tasks which run on a predefined schedule.
+Vikunja uses these through a light wrapper package around the excellent [github.com/robfig/cron](https://github.com/robfig/cron) package.
+
+The package exposes a `cron.Schedule` method with two arguments: The first one to define the schedule when the cron task 
+should run, and the second one with the actual function to run at the schedule.
+You would then create a new function to register your the actual cron task in your package.
+
+A basic function to register a cron task looks like this:
+
+{{< highlight golang >}}
+func RegisterSomeCronTask() {
+	err := cron.Schedule("0 * * * *", func() {
+		// Do something every hour
+	}
+}
+{{< /highlight >}}
+
+Call the register method in the `FullInit()` method of the `init` package to actually register it.
+
+## Schedule Syntax
+
+The cron syntax uses the same on you may know from unix systems.
+
+It is described in detail [here](https://pkg.go.dev/github.com/robfig/cron#hdr-CRON_Expression_Format).

docs/content/doc/development/database.md

@@ -0,0 +1,40 @@
+---
+date: "2019-02-12:00:00+02:00"
+title: "Database"
+draft: false
+type: "doc"
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Database
+
+Vikunja uses [xorm](https://xorm.io/) as an abstraction layer to handle the database connection.
+Please refer to [their](https://xorm.io/docs/) documentation on how to exactly use it.
+
+{{< table_of_contents >}}
+
+## Using the database
+
+When using the common web handlers, you get an `xorm.Session` to do database manipulations.
+In other packages, use the `db.NewSession()` method to get a new database session.
+
+## Adding new database tables
+
+To add a new table to the database, create the struct and [add a migration for it]({{< ref "db-migrations.md" >}}).
+
+To learn more about how to configure your struct to create "good" tables, refer to [the xorm documentaion](https://xorm.io/docs/).
+
+In most cases you will also need to implement the `TableName() string` method on the new struct to make sure the table 
+name matches the rest of the tables - plural.
+
+## Adding data to test fixtures
+
+Adding data for test fixtures can be done via `yaml` files in `pkg/models/fixtures`.
+
+The name of the yaml file should match the table name in the database.
+Adding values to it is done via array definition inside it.
+
+**Note**: Table and column names need to be in snake_case as that's what is used internally in the database 
+and for mapping values from the database to xorm so your structs can use it.

docs/content/doc/development/db-migrations.md

@@ -0,0 +1,78 @@
+---
+date: "2019-03-29:00:00+02:00"
+title: "Database Migrations"
+draft: false
+type: "doc"
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Database Migrations
+
+Vikunja runs all database migrations automatically on each start if needed.
+Additionally, they can also be run directly by using the `migrate` command.
+
+We use [xormigrate](https://github.com/techknowlogick/xormigrate) to handle migrations, 
+which is based on gormigrate.
+
+{{< table_of_contents >}}
+
+## Add a new migration
+
+All migrations are stored in `pkg/migrations` and files should have the same name as their id.
+
+Each migration should have a function to apply and roll it back, as well as a numeric id (the datetime)
+and a more in-depth description of what the migration actually does.
+
+To easily get a new id, run the following on any unix system: 
+
+{{< highlight bash >}}
+date +%Y%m%d%H%M%S
+{{< /highlight >}}
+
+New migrations should be added via the `init()` function to the `migrations` variable.
+All migrations are sorted before being executed, since `init()` does not guarantee the order.
+
+When you're adding a new struct, you also need to add it to the `models.GetTables()` function
+to ensure it will be created on new installations.
+
+### Generating a new migration stub
+
+You can easily generate a pre-filled migration stub by running `mage dev:make-migration`.
+It will ask you for a table name and generate an empty migration similar to the example shown below.
+
+### Example
+
+{{< highlight golang >}}
+package migration
+
+import (
+	"github.com/go-xorm/xorm"
+	"src.techknowlogick.com/xormigrate"
+)
+
+// Used for rollback
+type teamMembersMigration20190328074430 struct {
+	Updated int64 `xorm:"updated"`
+}
+
+func (teamMembersMigration20190328074430) TableName() string {
+	return "team_members"
+}
+
+func init() {
+	migrations = append(migrations, &xormigrate.Migration{
+		ID:          "20190328074430",
+		Description: "Remove updated from team_members",
+		Migrate: func(tx *xorm.Engine) error {
+			return dropTableColum(tx, "team_members", "updated")
+		},
+		Rollback: func(tx *xorm.Engine) error {
+			return tx.Sync2(teamMembersMigration20190328074430{})
+		},
+	})
+}
+{{< /highlight >}}
+
+You should always copy the changed parts of the struct you're changing when adding migraitons.

docs/content/doc/development/development.md

@@ -0,0 +1,55 @@
+---
+date: "2022-09-21:00:00+02:00"
+title: "Development"
+toc: true
+draft: false
+type: "doc"
+menu:
+  sidebar:
+    parent: "development"
+    name: "Development"
+---
+
+# Development
+
+{{< table_of_contents >}}
+
+## General
+
+To contribute to Vikunja, fork the project and work on the main branch.
+Once you feel like your changes are ready, open a PR in the respective repo.
+A maintainer will take a look and give you feedback. Once everyone is happy, the PR gets merged and released.
+
+If you plan to do a bigger change, it is better to open an issue for discussion first.
+
+## API
+
+The code for the api is located at [code.vikunja.io/api](https://code.vikunja.io/api).
+
+We use go modules to manage third-party libraries for Vikunja, so you'll need at least go `1.17` to use these.
+
+A lot of developing tasks are automated using a Magefile, so make sure to [take a look at it]({{< ref "mage.md">}}).
+
+Make sure to check the other doc articles for specific development tasks like [testing]({{< ref "test.md">}}),
+[database migrations]({{< ref "db-migrations.md" >}}) and the [project structure]({{< ref "structure.md" >}}).
+
+## Frontend requirements
+
+The code for the frontend is located at [code.vikunja.io/frontend](https://code.vikunja.io/frontend).
+More instructions can be found in the repo's README.
+
+You need to have [pnpm](https://pnpm.io/) and nodejs in version 16 or 18 installed.
+
+## Git flow
+
+The `main` branch is the latest and bleeding edge branch with all changes. Unstable releases are automatically created from this branch.
+
+A release gets tagged from the main branch with the version name as tag name.
+
+Backports and point-releases should go to a `release/version` branch, based on the tag they are building on top of.
+
+## Conventional commits
+
+We're using [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) because they greatly simplify generating release notes.
+
+It is not required to use them when creating a PR, but appreciated.

docs/content/doc/development/errors.md

@@ -0,0 +1,72 @@
+---
+date: "2019-02-12:00:00+02:00"
+title: "Custom Errors"
+draft: false
+type: "doc"
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Custom Errors
+
+All custom errors are defined in `pkg/models/errors.go`.
+You should add new ones in this file.
+
+Custom errors usually have fields for the http return code, a [vikunja-specific error code]({{< ref "../usage/errors.md">}}) 
+and a human-readable error message about what went wrong.
+
+An error consists of multiple functions and definitions:
+
+{{< highlight golang >}}
+// This struct holds any information about this specific error.
+// In this case, it contains the user ID of a nonexistand user.
+// This type should always be a struct, even if it has no values in it.
+
+// ErrUserDoesNotExist represents a "UserDoesNotExist" kind of error.
+type ErrUserDoesNotExist struct {
+	UserID int64
+}
+
+// This function is mostly used in unit tests to check if a returned error is of that type.
+// Every error type should have one of these.
+// The name should always start with IsErr... followed by the name of the error.
+
+// IsErrUserDoesNotExist checks if an error is a ErrUserDoesNotExist.
+func IsErrUserDoesNotExist(err error) bool {
+	_, ok := err.(ErrUserDoesNotExist)
+	return ok
+}
+
+// This is the definition of the actual error type.
+// Your error type is _required_ to implement this in order to be able to be returned as an "error" from functions.
+func (err ErrUserDoesNotExist) Error() string {
+	return fmt.Sprintf("User does not exist [user id: %d]", err.UserID)
+}
+
+// This const holds the vikunja error code used to be able to identify this error without having to 
+// rely on an error string.
+// This needs to be unique, so you should check whether the error code exists or not.
+// The general convention for error codes is as follows:
+// * Every "group" errors lives in a thousend something. For example all user issues are 1000-something, all 
+//   list errors are 3000-something and so on.
+// * New error codes should be the current max error code + 1. Don't take free numbers to prevent old errors
+//   which are depricated and removed from being "new ones". For example, if there are error codes 1001, 1002, 1004,
+//   a new error should be 1005 and not 1003.
+
+// ErrCodeUserDoesNotExist holds the unique world-error code of this error
+const ErrCodeUserDoesNotExist = 1005
+
+// This is the implementation which returns an http error which is then passed to the client.
+// Here you define the http status code with which one the error will be returned, the vikunja error code and 
+// a human-readable error message.
+
+// HTTPError holds the http error description
+func (err ErrUserDoesNotExist) HTTPError() web.HTTPError {
+	return web.HTTPError{
+		HTTPCode: http.StatusNotFound, 
+		Code: ErrCodeUserDoesNotExist, 
+		Message: "The user does not exist.",
+    }
+}
+{{< /highlight >}}

docs/content/doc/development/events-and-listeners.md

@@ -0,0 +1,211 @@
+---
+date: 2018-10-13T19:26:34+02:00
+title: "Events and Listeners"
+draft: false
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Events and Listeners
+
+Vikunja provides a simple observer pattern mechanism through events and listeners.
+The basic principle of events is always the same: Something happens (=An event is fired) and something reacts to it (=A listener is called).
+
+Vikunja supports this principle through the `events` package.
+It is built upon the excellent [watermill](https://watermill.io) library.
+
+Currently, it only supports dispatching events through Go Channels which makes it configuration-less.
+More methods of dispatching events (like kafka or rabbitmq) are available in watermill and could be enabled with a PR.
+
+This document explains how events and listeners work in Vikunja, how to use them and how to create new ones.
+
+{{< table_of_contents >}}
+
+## Events
+
+### Definition
+
+Each event has to implement this interface:
+
+{{< highlight golang >}}
+type Event interface {
+    Name() string
+}
+{{< /highlight >}}
+
+An event can contain whatever data you need.
+
+When an event is dispatched, all of the data it contains will be marshaled into json for dispatching.
+You then get the event with all its data back in the listener, see below.
+
+#### Naming Convention
+
+Event names should roughly have the entity they're dealing with on the left and the action on the right of the name, separated by `.`.
+There's no limit to how "deep" or specifig an event name can be.
+
+The name should have the most general concept it's describing at the left, getting more specific on the right of it.
+
+#### Location
+
+All events for a package should be declared in the `events.go` file of that package.
+
+### Creating a New Event
+
+The easiest way to create a new event is to generate it with mage:
+
+```
+mage dev:make-event <event-name> <package>
+```
+
+The function takes the name of the event as the first argument and the package where the event should be created as the second argument.
+Events will be appended to the `pkg/<module>/events.go` file.
+Both parameters are mandatory.
+
+The event type name is automatically camel-cased and gets the `Event` suffix if the provided name does not already have one.
+The event name is derived from the type name and stripped of the `.event` suffix.
+
+The generated event will look something like the example below.
+
+### Dispatching events
+
+To dispatch an event, simply call the `events.Dispatch` method and pass in the event as parameter.
+
+### Example
+
+The `TaskCreatedEvent` is declared in the `pkg/models/events.go` file as follows:
+
+{{< highlight golang >}}
+// TaskCreatedEvent represents an event where a task has been created
+type TaskCreatedEvent struct {
+    Task *Task
+    Doer web.Auth
+}
+
+// Name defines the name for TaskCreatedEvent
+func (t *TaskCreatedEvent) Name() string {
+    return "task.created"
+}
+{{< /highlight >}}
+
+It is dispatched in the `createTask` function of the `models` package:
+
+{{< highlight golang >}}
+func createTask(s *xorm.Session, t *Task, a web.Auth, updateAssignees bool) (err error) {
+
+    // ...
+    
+    err = events.Dispatch(&TaskCreatedEvent{
+        Task: t,
+        Doer: a,
+    })
+    
+    // ...
+}
+{{< /highlight >}}
+
+As you can see, the curent task and doer are injected into it.
+
+### Special Events
+
+#### `BootedEvent`
+
+Once Vikunja is fully initialized, right before the api web server is started, this event is fired.
+
+## Listeners
+
+A listener is a piece of code that gets executed asynchronously when an event is dispatched.
+
+A single event can have multiple listeners who are independent of each other.
+
+### Definition
+
+All listeners must implement this interface:
+
+{{< highlight golang >}}
+// Listener represents something that listens to events
+type Listener interface {
+    Handle(msg *message.Message) error
+    Name() string
+}
+{{< /highlight >}}
+
+The `Handle` method is executed when the event this listener listens on is dispatched. 
+* As the single parameter, it gets the payload of the event, which is the event struct when it was dispatched decoded as json object and passed as a slice of bytes.
+To use it you'll need to unmarshal it. Unfortunately there's no way to pass an already populated event object to the function because we would not know what type it has when parsing it.
+* If the handler returns an error, the listener is retried 5 times, with an exponentional back-off period in between retries.
+If it still fails after the fifth retry, the event is nack'd and it's up to the event dispatcher to resend it.
+You can learn more about this mechanism in the [watermill documentation](https://watermill.io/docs/middlewares/#retry).
+
+The `Name` method needs to return a unique listener name for this listener.
+It should follow the same convention as event names, see above.
+
+### Creating a New Listener
+
+The easiest way to create a new listener for an event is with mage:
+
+```
+mage dev:make-listener <listener-name> <event-name> <package>
+```
+
+This will create a new listener type in the `pkg/<package>/listners.go` file and implement the `Handle` and `Name` methods.
+It will also pre-generate some boilerplate code to unmarshal the event from the payload.
+
+Furthermore, it will register the listener for its event in the `RegisterListeners()` method of the same file.
+This function is called at startup and has to contain all events you want to listen for.
+
+### Listening for Events
+
+To listen for an event, you need to register the listener for the event it should be called for.
+This usually happens in the `RegisterListeners()` method in `pkg/<package>/listners.go` which is called at start up.
+
+The listener will never be executed if it hasn't been registered.
+
+See the example below.
+
+### Example
+
+{{< highlight golang >}}
+// RegisterListeners registers all event listeners
+func RegisterListeners() {
+    events.RegisterListener((&ListCreatedEvent{}).Name(), &IncreaseListCounter{})
+}
+
+// IncreaseTaskCounter represents a listener
+type IncreaseTaskCounter struct {}
+
+// Name defines the name for the IncreaseTaskCounter listener
+func (s *IncreaseTaskCounter) Name() string {
+    return "task.counter.increase"
+}
+
+// Hanlde is executed when the event IncreaseTaskCounter listens on is fired
+func (s *IncreaseTaskCounter) Handle(payload message.Payload) (err error) {
+    return keyvalue.IncrBy(metrics.TaskCountKey, 1)
+}
+{{< /highlight >}}
+
+## Testing
+
+When testing, you should call the `events.Fake()` method in the `TestMain` function of the package you want to test.
+This prevents any events from being fired and lets you assert an event has been dispatched like so:
+
+{{< highlight golang >}}
+events.AssertDispatched(t, &TaskCreatedEvent{})
+{{< /highlight >}}
+
+### Testing a listener
+
+You can call an event listener manually with the `events.TestListener` method like so:
+
+{{< highlight golang >}}
+ev := &TaskCommentCreatedEvent{
+	Task:    &task,
+	Doer:    u,
+	Comment: tc,
+}
+
+events.TestListener(t, ev, &SendTaskCommentNotification{})
+{{< /highlight >}}
+
+This will call the listener's `Handle` method and assert it did not return an error when calling.

docs/content/doc/development/feature.md

@@ -0,0 +1,33 @@
+---
+date: "2019-02-12:00:00+02:00"
+title: "New API Endpoints"
+draft: false
+type: "doc"
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Add a new api endpoint/feature
+
+Most of the api endpoints/features of Vikunja are using the [common web handler](https://code.vikunja.io/web).
+This is a library created by Vikunja in an effort to facilitate the creation of REST endpoints.
+
+This works by abstracting the handling of CRUD-Requests, including rights check.
+
+You can learn more about the web handler on [the project's repo](https://code.vikunja.io/web).
+
+### Helper for pagination
+
+Pagination limits can be calculated with a helper function, `getLimitFromPageIndex(pageIndex)` 
+(only available in the `models` package) from any page number.
+It returns the `limit` (max-length) and `offset` parameters needed for SQL-Queries.
+
+You can feed this function directly into xorm's `Limit`-Function like so:
+
+{{< highlight golang >}}
+lists := []List{}
+err := x.Limit(getLimitFromPageIndex(pageIndex, itemsPerPage)).Find(&lists)
+{{< /highlight >}}
+
+// TODO: Add a full example from start to finish, like a tutorial on how to create a new endpoint?

docs/content/doc/development/mage.md

@@ -0,0 +1,192 @@
+---
+date: "2019-02-12:00:00+02:00"
+title: "Magefile"
+draft: false
+type: "doc"
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Mage
+
+Vikunja uses [Mage](https://magefile.org/) to script common development tasks and even releasing.
+Mage is a pure go solution which allows for greater flexibility and things like better parallelization.
+
+This document explains what tasks are available and what they do.
+
+{{< table_of_contents >}}
+
+## Installation
+
+To use mage, you'll need to install the mage cli.
+To install it, run the following command:
+
+```
+go install github.com/magefile/mage
+```
+
+## Categories
+
+There are multiple categories of subcommands in the magefile:
+
+* `build`: Contains commands to build a single binary
+* `check`: Contains commands to statically check the source code 
+* `release`: Contains commands to release Vikunja with everything that's required
+* `test`: Contains commands to run all kinds of tests
+* `dev`: Contains commands to run development tasks
+* `misc`: Commands which do not belong in either of the other categories
+
+## CI
+
+These tasks are automatically run in our CI every time someone pushes to main or you update a pull request:
+
+* `mage check:lint`
+* `mage check:fmt`
+* `mage check:ineffassign`
+* `mage check:misspell`
+* `mage check:goconst`
+* `mage build:generate`
+* `mage build:build`
+
+## Build
+
+### Build Vikunja
+
+{{< highlight bash >}}
+mage build:build
+{{< /highlight >}}
+
+or
+
+{{< highlight bash >}}
+mage build
+{{< /highlight >}}
+
+Builds a `vikunja`-binary in the root directory of the repo for the platform it is run on.
+
+### clean
+
+{{< highlight bash >}}
+mage build:clean
+{{< /highlight >}}
+
+Cleans all build and executable files
+
+## Check
+
+All check sub-commands exit with a status code of 1 if the check fails.
+
+Various code-checks are available:
+
+* `mage check:all`: Runs fmt-check, lint, got-swag, misspell-check, ineffasign-check, gocyclo-check, static-check, gosec-check, goconst-check all in parallel
+* `mage check:fmt`: Checks if the code is properly formatted with go fmt
+* `mage check:go-sec`: Checks the source code for potential security issues by scanning the Go AST using the [gosec tool](https://github.com/securego/gosec)
+* `mage check:goconst`: Checks for repeated strings that could be replaced by a constant using [goconst](https://github.com/jgautheron/goconst/)
+* `mage check:gocyclo`: Checks for the cyclomatic complexity of the source code using [gocyclo](https://github.com/fzipp/gocyclo)
+* `mage check:got-swag`: Checks if the swagger docs need to be re-generated from the code annotations
+* `mage check:ineffassign`: Checks the source code for ineffectual assigns using [ineffassign](https://github.com/gordonklaus/ineffassign)
+* `mage check:lint`: Runs golint on all packages
+* `mage check:misspell`: Checks the source code for misspellings
+* `mage check:static`: Statically analyzes the source code about a range of different problems using [staticcheck](https://staticcheck.io/docs/)
+
+## Release
+
+### Build Releases
+
+{{< highlight bash >}}
+mage release
+{{< /highlight >}}
+
+Builds binaries for all platforms and zips them with a copy of the `templates/` folder.
+All built zip files are stored into `dist/zips/`. Binaries are stored in `dist/binaries/`,
+binaries bundled with `templates` are stored in `dist/releases/`.
+
+All cross-platform binaries built using this series of commands are built with the help of 
+[xgo](https://github.com/techknowlogick/xgo). The mage command will automatically install the
+binary to be able to use it.
+
+`mage release:release` is a shortcut to execute `mage release:dirs release:windows release:linux release:darwin release:copy release:check release:os-package release:zip`.
+
+* `mage release:dirs` creates all directories needed
+* `mage release:windows`/`release:linux`/`release:darwin` execute xgo to build for their respective platforms
+* `mage release:copy` bundles binaries with a copy of the `LICENSE` and sample config files to then be zipped
+* `mage release:check` creates sha256 checksums for each binary which will be included in the zip file
+* `mage release:os-package` bundles a binary with the `sha256` checksum file, a sample `config.yml` and a copy of the license in a folder for each architecture
+* `mage release:compress` compresses all build binaries with `upx` to save space
+* `mage release:zip` paclages a zip file for the files created by `release:os-package`
+
+### Build os packages
+
+{{< highlight bash >}}
+mage release:packages
+{{< /highlight >}}
+
+Will build `.deb`, `.rpm` and `.apk` packages to `dist/os-packages`.
+
+### Make a debian repo
+
+{{< highlight bash >}}
+mage release:reprepro
+{{< /highlight >}}
+
+Takes an already built debian package and creates a debian repo structure around it.
+
+Used to be run inside a [docker container](https://git.kolaente.de/konrad/reprepro-docker) in the CI process when releasing.
+
+## Test
+
+### unit
+
+{{< highlight bash >}}
+mage test:unit
+{{< /highlight >}}
+
+Runs all tests except integration tests.
+
+### coverage
+
+{{< highlight bash >}}
+mage test:coverage
+{{< /highlight >}}
+
+Runs all tests except integration tests and generates a `coverage.html` file to inspect the code coverage.
+
+### integration
+
+{{< highlight bash >}}
+mage test:integration
+{{< /highlight >}}
+
+Runs all integration tests.
+
+## Dev
+
+### Create a new migration 
+
+{{< highlight bash >}}
+mage dev:create-migration
+{{< /highlight >}}
+
+Creates a new migration with the current date. 
+Will ask for the name of the struct you want to create a migration for.
+
+See also [migration docs]({{< ref "mage.md" >}}).
+
+## Misc
+
+### Format the code
+
+{{< highlight bash >}}
+mage fmt
+{{< /highlight >}}
+
+Formats all source code using `go fmt`.
+
+### Generate swagger definitions from code comments
+
+{{< highlight bash >}}
+mage do-the-swag
+{{< /highlight >}}
+
+Generates swagger definitions from the comment annotations in the code.

docs/content/doc/development/metrics.md

@@ -0,0 +1,48 @@
+---
+date: "2019-02-12:00:00+02:00"
+title: "Metrics"
+draft: false
+type: "doc"
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Metrics
+
+Metrics work by exposing a `/metrics` endpoint which can then be accessed by prometheus.
+
+To keep the load on the database minimal, metrics are stored and updated in redis.
+The `metrics` package provides several functions to create and update metrics.
+
+{{< table_of_contents >}}
+
+## Exposing New Metrics
+
+First, define a `const` with the metric key in redis. This is done in `pkg/metrics/metrics.go`.
+
+To expose a new metric, you need to register it in the `init` function inside of the `metrics` package like so:
+
+{{< highlight golang >}}
+// Register total user count metric
+promauto.NewGaugeFunc(prometheus.GaugeOpts{
+    Name: "vikunja_team_count", // The key of the metric. Must be unique.
+    Help: "The total number of teams on this instance", // A description about the metric itself.
+}, func() float64 {
+    count, _ := GetCount(TeamCountKey) // TeamCountKey is the const we defined earlier.
+    return float64(count)
+})
+{{< /highlight >}}
+
+Then you'll need to set the metrics initial value on every startup of vikunja.
+This is done in `pkg/routes/routes.go` to avoid cyclic imports.
+If metrics are enabled, it checks if a redis connection is available and then sets the initial values.
+A convenience function is available if the metric is based on a database struct.
+
+Because metrics are stored in redis, you are responsible to increase or decrease these based on criteria you define.
+To do this, use `metrics.UpdateCount(value, key)` where `value` is the amount you want to cange it (you can pass
+negative values to decrease it) and `key` it the redis key used to define the metric.
+
+## Using it
+
+A Prometheus config with a Grafana template is available at [our git repo](https://git.kolaente.de/vikunja/monitoring).

docs/content/doc/development/migration.md

@@ -0,0 +1,136 @@
+---
+date: "2020-01-19:16:00+02:00"
+title: "Migrations"
+draft: false
+type: "doc"
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Writing a migrator for Vikunja
+
+It is possible to migrate data from other to-do services to Vikunja.
+To make this easier, we have put together a few helpers which are documented on this page.
+
+In general, each migrator implements a migrator interface which is then called from a client.
+The interface makes it possible to use helper methods which handle http and focus only on the implementation of the migrator itself.
+
+There are two ways of migrating data from another service:
+1. Through the auth-based flow where the user gives you access to their data at the third-party service through an 
+   oauth flow. You can then call the service's api on behalf of your user to get all the data.
+   The Todoist, Trello and Microsoft To-Do Migrators use this pattern.
+2. A file migration where the user uploads a file obtained from some third-party service. In your migrator, you need 
+   to parse the file and create the lists, tasks etc.
+   The Vikunja File Import uses this pattern.
+
+To differentiate the two, there are two different interfaces you must implement.
+
+{{< table_of_contents >}}
+
+## Structure
+
+All migrator implementations live in their own package in `pkg/modules/migration/<name-of-the-service>`.
+When creating a new migrator, you should place all related code inside that module.
+
+## Migrator Interface
+
+The migrator interface is defined as follows:
+
+```go
+// Migrator is the basic migrator interface which is shared among all migrators
+type Migrator interface {
+	// Name holds the name of the migration.
+	// This is used to show the name to users and to keep track of users who already migrated.
+	Name() string
+	// Migrate is the interface used to migrate a user's tasks from another platform to vikunja.
+	// The user object is the user who's tasks will be migrated.
+	Migrate(user *models.User) error
+	// AuthURL returns a url for clients to authenticate against.
+	// The use case for this are Oauth flows, where the server token should remain hidden and not
+	// known to the frontend.
+	AuthURL() string
+}
+```
+
+## File Migrator Interface
+
+```go
+// FileMigrator handles importing Vikunja data from a file. The implementation of it determines the format.
+type FileMigrator interface {
+	// Name holds the name of the migration.
+	// This is used to show the name to users and to keep track of users who already migrated.
+	Name() string
+	// Migrate is the interface used to migrate a user's tasks, list and other things from a file to vikunja.
+	// The user object is the user who's tasks will be migrated.
+	Migrate(user *user.User, file io.ReaderAt, size int64) error
+}
+```
+
+## Defining http routes
+
+Once your migrator implements the migration interface, it becomes possible to use the helper http handlers.
+Their usage is very similar to the [general web handler](https://kolaente.dev/vikunja/web#user-content-defining-routes-using-the-standard-web-handler):
+
+The `RegisterRoutes(m)` method registers all routes with the scheme `/[MigratorName]/(auth|migrate|status)` for the 
+authUrl, Status and Migrate methods.
+
+```go
+// This is an example for the Wunderlist migrator
+if config.MigrationWunderlistEnable.GetBool() {
+	wunderlistMigrationHandler := &migrationHandler.MigrationWeb{
+		MigrationStruct: func() migration.Migrator {
+			return &wunderlist.Migration{}
+		},
+	}
+	wunderlistMigrationHandler.RegisterRoutes(m)
+}
+```
+
+And for the file migrator:
+
+```go
+vikunjaFileMigrationHandler := &migrationHandler.FileMigratorWeb{
+	MigrationStruct: func() migration.FileMigrator {
+		return &vikunja_file.FileMigrator{}
+	},
+}
+vikunjaFileMigrationHandler.RegisterRoutes(m)
+```
+
+You should also document the routes with [swagger annotations]({{< ref "swagger-docs.md" >}}).
+
+## Insertion helper method
+
+There is a method available in the `migration` package which takes a fully nested Vikunja structure and creates it with all relations. 
+This means you start by adding a namespace, then add lists inside of that namespace, then tasks in the lists and so on.
+
+The root structure must be present as `[]*models.NamespaceWithListsAndTasks`. It allows to represent all of Vikunja's 
+hierachie as a single data structure.
+
+Then call the method like so:
+
+```go
+fullVikunjaHierachie, err := convertWunderlistToVikunja(wContent)
+if err != nil {
+    return
+}
+
+err = migration.InsertFromStructure(fullVikunjaHierachie, user)
+```
+
+## Configuration
+
+If your migrator is an oauth-based one, you should add at least an option to enable or disable it.
+Chances are, you'll need some more options for things like client ID and secret 
+(if the other service uses oAuth as an authentication flow).
+
+The easiest way to implement an on/off switch is to check whether your migration service is enabled or not when 
+registering the routes, and then simply don't registering the routes in case it is disabled.
+
+File based migrators can always be enabled.
+
+### Making the migrator public in `/info` 
+
+You should make your migrator available in the `/info` endpoint so that frontends can display options to enable them or not.
+To do this, add an entry to the `AvailableMigrators` field in `pkg/routes/api/v1/info.go`.

docs/content/doc/development/notifications.md

@@ -0,0 +1,120 @@
+---
+date: 2021-02-07T19:26:34+02:00
+title: "Notifications"
+toc: true
+draft: false
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Notifications
+
+Vikunjs provides a simple abstraction to send notifications per mail and in the database.
+
+{{< table_of_contents >}}
+
+## Definition
+
+Each notification has to implement this interface:
+
+{{< highlight golang >}}
+type Notification interface {
+    ToMail() *Mail
+    ToDB() interface{}
+    Name() string
+}
+{{< /highlight >}}
+
+Both functions return the formatted messages for mail and database.
+
+A notification will only be sent or recorded for those of the two methods which don't return `nil`.
+For example, if your notification should not be recorded in the database but only sent out per mail, it is enough to let the `ToDB` function return `nil`.
+
+### Mail notifications
+
+A list of chainable functions is available to compose a mail:
+
+{{< highlight golang >}}
+mail := NewMail(). 
+    // The optional sender of the mail message.
+    From("test@example.com").
+	// The optional receipient of the mail message. Uses the mail address of the notifiable if omitted.
+    To("test@otherdomain.com").
+	// The subject of the mail to send.
+    Subject("Testmail").
+	// The greeting, or "intro" line of the mail.
+    Greeting("Hi there,").
+	// A line of text
+    Line("This is a line of text").
+	// An action can contain a title and a url. It gets rendered as a big button in the mail.
+	// Note that you can have only one action per mail.
+	// All lines added before an action will appearr in the mail before the button, all lines 
+	// added afterwards will appear after it.
+    Action("The Action", "https://example.com").
+	// Another line of text.
+    Line("This should be an outro line").
+{{< /highlight >}}
+
+If not provided, the `from` field of the mail contains the value configured in [`mailer.fromemail`](https://vikunja.io/docs/config-options/#fromemail).
+
+### Database notifications
+
+All data returned from the `ToDB()` method is serialized to json and saved into the database, along with the id of the 
+notifiable, the name of the notification and a time stamp.
+If you don't use the database notification, the `Name()` function can return an empty string.
+
+## Creating a new notification
+
+The easiest way to generate a mail is by using the `mage dev:make-notification` command.
+
+It takes the name of the notification and the package where the notification will be created.
+
+## Notifiables
+
+Notifiables can receive a notification.
+A notifiable is defined with this interface:
+
+{{< highlight golang >}}
+type Notifiable interface {
+    // Should return the email address this notifiable has.
+    RouteForMail() string
+    // Should return the id of the notifiable entity
+    RouteForDB() int64
+}
+{{< /highlight >}}
+
+The `User` type from the `user` package implements this interface.
+
+## Sending a notification
+
+Sending a notification is done with the `Notify` method from the `notifications` package.
+It takes a notifiable and a notification as input.
+
+For example, the email confirm notification when a new user registers is sent like this:
+
+{{< highlight golang >}}
+n := &EmailConfirmNotification{
+    User:  update.User,
+    IsNew: false,
+}
+
+err = notifications.Notify(update.User, n)
+return
+{{< /highlight >}}
+
+## Testing
+
+The `mail` package provides a `Fake()` method which you should call in the `MainTest` functions of your package.
+If it was called, no mails are being sent and you can instead assert they have been sent with the `AssertSent` method.
+
+When testing, you should call the `notifications.Fake()` method in the `TestMain` function of the package you want to test.
+This prevents any notifications from being sent and lets you assert a notifications has been sent like this:
+
+{{< highlight golang >}}
+notifications.AssertSent(t, &ReminderDueNotification{})
+{{< /highlight >}}
+
+## Example
+
+Take a look at the [pkg/user/notifications.go](https://code.vikunja.io/api/src/branch/main/pkg/user/notifications.go) file for a good example.

docs/content/doc/development/releasing.md

@@ -0,0 +1,39 @@
+---
+title: "Releasing a new Vikunja version"
+date: 2022-10-28T13:06:05+02:00
+draft: false
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Releasing a new Vikunja version
+
+This checklist is a collection of all steps usually involved when releasing a new version of Vikunja.
+Not all steps are necessary for every release.
+
+* Website update :
+	* New Features: If there are new features worth mentioning the feature page should be updated.
+	* New Screenshots: If an overhaul of an existing feature happend so that it now looks different from the existing screenshot, a new one is required.
+* Generate changelogs: (with git-cliff)
+	* Frontend
+	* API
+	* Desktop
+* Tag a new version: Include the changelog for that version as the tag message
+	* Frontend
+	* API
+	* Desktop
+	* Once built: Prune the cloudflare cache so that the new versions show up at dl.vikunja.io
+* Release Highlights Blogpost:
+	* Include a section about Vikunja in general (totally fine to copy one from the earlier blog posts)
+	* New Features & Improvements: Mention bigger features, potentially with screenshots. Things like refactoring are sometimes also worth mentioneing.
+* Publish:
+	* Reddit
+	* Twitter
+	* Mastodon
+	* Chat
+	* Newsletter
+	* Forum
+	* If features in the release were sponsored, send an email to relevant stakeholders
+* Update Vikunja Cloud version and other instances
+

docs/content/doc/development/structure.md

@@ -0,0 +1,171 @@
+---
+date: "2019-02-12:00:00+02:00"
+title: "Project Structure"
+draft: false
+type: "doc"
+menu:
+  sidebar:
+    parent: "development"
+---
+
+# Project structure
+
+This document explains what each package does.
+
+{{< table_of_contents >}}
+
+## Root level
+
+The root directory is where [the config file]({{< ref "../setup/config.md">}}), [Magefile]({{< ref "mage.md">}}), license, drone config, 
+application entry point (`main.go`) and so on are located.
+
+## pkg
+
+This is where most of the magic happens. Most packages with actual code are located in this folder.
+
+### caldav
+
+This folder holds a simple caldav implementation which is responsible for the caldav feature.
+
+### cmd
+
+This package contains all cli-related files and functions.
+
+To learn more about how to add a new command, see [the cli docs]({{< ref "cli.md">}}).
+
+To learn more about how to use this cli, see [the cli usage docs]({{< ref "../usage/cli.md">}}).
+
+### config
+
+This package configures handling of Vikunja's runtime configuration.
+It sets default values and sets up viper and tells it where to look for config files, how to interpret which env variables 
+for config etc.
+
+See also the [docs about adding a new configuration parameter]({{< ref "config.md" >}}).
+
+### cron
+
+See [how to add a cron task]({{< ref "cron.md" >}}).
+
+### db
+
+This package contains the db connection handling and db fixtures for testing.
+Each other package gets its db connection object from this package.
+
+### files
+
+This package is responsible for all file-related things.
+This means it handles saving and retrieving files from the db and the underlying file system.
+
+### integration
+
+All integration tests live here.
+See [integration tests]({{< ref "test.md" >}}#integration-tests) for more details.
+
+### log
+
+Similar to `config`, this will set up the logging, based on differen logging backends.
+This init is called in `main.go` after the config init is done.
+
+### mail
+
+This package handles all mail sending. To learn how to send a mail, see [notifications]({{< ref "notifications.md" >}}).
+
+### metrics
+
+This package handles all metrics which are exposed to the prometheus endpoint.
+To learn how it works and how to add new metrics, take a look at [how metrics work]({{< ref "metrics.md">}}).
+
+### migration
+
+This package handles all migrations.
+All migrations are stored and executed in this package.
+
+To learn more, take a look at the [migrations docs]({{< ref "../development/db-migrations.md">}}).
+
+### models
+
+This is where most of the magic happens.
+When adding new features or upgrading existing ones, that most likely happens here.
+
+Because this package is pretty huge, there are several documents and how-to's about it:
+
+* [Adding a feature]({{< ref "feature.md">}})
+* [Making calls to the database]({{< ref "database.md">}})
+
+### modules
+
+Everything that can have multiple implementations (like a task migrator from a third-party task provider) lives in a 
+respective sub package in this package.
+
+#### auth
+
+Contains openid related authentication.
+
+#### avatar
+
+Contains all possible avatar providers a user can choose to set their avatar.
+
+#### background
+
+All list background providers are in sub-packages of this package.
+
+#### dump
+
+Handles everything related to the `dump` and `restore` commands of Vikunja.
+
+#### keyvalue
+
+A simple key-value store with an implementation for memory and redis. 
+Can be used to cache values.
+
+#### migration
+
+See [writing a migrator]({{< ref "migration.md" >}}).
+
+### red (redis)
+
+This package initializes a connection to a redis server.
+This inizialization is automatically done at the startup of vikunja.
+
+It also has a function (`GetRedis()`) which returns a redis client object you can then use in your package 
+to talk to redis.
+
+It uses the [go-redis](https://github.com/go-redis/redis) library, please see their configuration on how to use it.
+
+**Note**: Only use this package directly if you have to use a direct redis connection.
+In most cases, using the `keyvalue` package is a better fit.
+
+### routes
+
+This package defines all routes which are available for vikunja clients to use.
+To add a new route, see [adding a new route]({{< ref "feature.md">}}).
+
+#### api/v1
+
+This is where all http-handler functions for the api are stored. 
+Every handler function which does not use the standard web handler should live here.
+
+### swagger
+
+This is where the [generated]({{< ref "mage.md#generate-swagger-definitions-from-code-comments">}} [api docs]({{< ref "../usage/api.md">}}) live. 
+You usually don't need to touch this package.
+
+### user
+
+All user-related things like registration etc. live in this package.
+
+### utils
+
+A small package, containing some helper functions:
+
+* `MakeRandomString`: Generates a random string of a given length.
+* `Sha256`: Calculates a sha256 hash from a given string.
+
+See their function definitions for instructions on how to use them. 
+
+### version
+
+The single purpouse of this package is to hold the current vikunja version which gets overridden through build flags 
+each time `mage release` or `mage build` is run.
+It is a seperate package to avoid import cycles with other packages.