fix(views): enable search in bucket filters

Resolves https://github.com/go-vikunja/vikunja/issues/350

.drone.yml

@@ -3,6 +3,11 @@ kind: pipeline
 type: docker
 name: build-and-test
 
+trigger:
+  event:
+    exclude:
+      - cron
+
 workspace:
   base: /go
   path: src/code.vikunja.io/api
@@ -35,7 +40,6 @@ volumes:
   - name: tmp-postgres-migration
     temp:
       medium: memory
-      
 
 services:
   - name: test-mysql-unit
@@ -134,7 +138,7 @@ steps:
       event: [ push, tag, pull_request ]
 
   - name: api-lint
-    image: golangci/golangci-lint:v1.55.2
+    image: golangci/golangci-lint:v1.61.0
     pull: always
     environment:
       GOPROXY: 'https://goproxy.kolaente.de'
@@ -156,7 +160,7 @@ steps:
   - name: test-migration-sqlite
     image: vikunja/golang-build:latest
     pull: always
-    depends_on: 
+    depends_on:
       - test-migration-prepare
       - api-build
     environment:
@@ -359,7 +363,7 @@ steps:
       - api-build
 
   - name: frontend-dependencies
-    image: node:20.11.0-alpine
+    image: node:22.11.0-alpine
     pull: always
     environment:
       PNPM_CACHE_FOLDER: .cache/pnpm
@@ -373,7 +377,7 @@ steps:
   #      - restore-cache
 
   - name: frontend-lint
-    image: node:20.11.0-alpine
+    image: node:22.11.0-alpine
     pull: always
     environment:
       PNPM_CACHE_FOLDER: .cache/pnpm
@@ -385,7 +389,7 @@ steps:
       - frontend-dependencies
 
   - name: frontend-build-prod
-    image: node:20.11.0-alpine
+    image: node:22.11.0-alpine
     pull: always
     environment:
       PNPM_CACHE_FOLDER: .cache/pnpm
@@ -397,7 +401,7 @@ steps:
       - frontend-dependencies
 
   - name: frontend-test-unit
-    image: node:20.11.0-alpine
+    image: node:22.11.0-alpine
     pull: always
     commands:
       - cd frontend
@@ -408,7 +412,7 @@ steps:
 
   - name: frontend-typecheck
     failure: ignore
-    image: node:20.11.0-alpine
+    image: node:22.11.0-alpine
     pull: always
     environment:
       PNPM_CACHE_FOLDER: .cache/pnpm
@@ -439,7 +443,7 @@ steps:
     depends_on:
       - frontend-build-prod
       - test-api-run
-  
+
   - name: frontend-deploy-preview
     image: williamjackson/netlify-cli
     pull: always
@@ -456,7 +460,6 @@ steps:
       - cp -r dist-test dist-preview
       # Override the default api url used for preview
       - sed -i 's|http://localhost:3456|https://try.vikunja.io|g' dist-preview/index.html
-      - apk add --no-cache perl-utils
       # create via:
       # `shasum -a 384 ./scripts/deploy-preview-netlify.mjs > ./scripts/deploy-preview-netlify.mjs.sha384`
       - shasum -a 384 -c ./scripts/deploy-preview-netlify.mjs.sha384
@@ -495,7 +498,7 @@ steps:
     environment:
       GOPROXY: 'https://goproxy.kolaente.de'
     commands:
-      - mage do-the-swag
+      - mage generate:swagger-docs
 
   - name: push
     pull: always
@@ -528,6 +531,9 @@ trigger:
   ref:
     - refs/heads/main
     - "refs/tags/**"
+  event:
+    exclude:
+      - cron
 
 steps:
   # Needed to get the versions right as they depend on tags
@@ -537,7 +543,7 @@ steps:
       - git fetch --tags
 
   - name: frontend-dependencies
-    image: node:20.11.0-alpine
+    image: node:22.11.0-alpine
     pull: always
     environment:
       PNPM_CACHE_FOLDER: .cache/pnpm
@@ -549,7 +555,7 @@ steps:
       - pnpm install --fetch-timeout 100000
 
   - name: frontend-build
-    image: node:20.11.0-alpine
+    image: node:22.11.0-alpine
     pull: always
     environment:
       PNPM_CACHE_FOLDER: .cache/pnpm
@@ -572,8 +578,55 @@ steps:
     when:
       event: [ push, tag, pull_request ]
 
+  - name: generate-config-yaml
+    image: vikunja/golang-build:latest
+    pull: always
+    commands:
+      - ./mage-static generate:config-yaml 1
+    depends_on: [ mage ]
+
+  - name: upload-config-yaml-unstable
+    image: plugins/s3
+    pull: always
+    settings:
+      bucket: vikunja
+      access_key:
+        from_secret: hetzner_access_key_id
+      secret_key:
+        from_secret: hetzner_secret_access_key
+      endpoint: https://fsn1.your-objectstorage.com
+      region: fsn1
+      path_style: true
+      source: config.yml.sample
+      target: /vikunja/unstable/
+    when:
+      branch:
+        - main
+      event:
+        - push
+    depends_on: [ generate-config-yaml ]
+
+  - name: upload-config-yaml-version
+    image: plugins/s3
+    pull: always
+    settings:
+      bucket: vikunja
+      access_key:
+        from_secret: hetzner_access_key_id
+      secret_key:
+        from_secret: hetzner_secret_access_key
+      endpoint: https://fsn1.your-objectstorage.com
+      region: fsn1
+      path_style: true
+      source: config.yml.sample
+      target: /vikunja/${DRONE_TAG##v}/
+    when:
+      event:
+        - tag
+    depends_on: [ generate-config-yaml ]
+
   - name: before-static-build
-    image: techknowlogick/xgo:latest
+    image: ghcr.io/techknowlogick/xgo:go-1.23.x
     pull: always
     commands:
       - export PATH=$PATH:$GOPATH/bin
@@ -582,7 +635,7 @@ steps:
     depends_on: [ fetch-tags, mage ]
 
   - name: static-build-windows
-    image: techknowlogick/xgo:latest
+    image: ghcr.io/techknowlogick/xgo:go-1.23.x
     pull: always
     environment:
       # This path does not exist. However, when we set the gopath to /go, the build fails. Not sure why.
@@ -598,7 +651,7 @@ steps:
       - frontend-build
 
   - name: static-build-linux
-    image: techknowlogick/xgo:latest
+    image: ghcr.io/techknowlogick/xgo:go-1.23.x
     pull: always
     environment:
       # This path does not exist. However, when we set the gopath to /go, the build fails. Not sure why.
@@ -614,7 +667,7 @@ steps:
       - frontend-build
 
   - name: static-build-darwin
-    image: techknowlogick/xgo:latest
+    image: ghcr.io/techknowlogick/xgo:go-1.23.x
     pull: always
     environment:
       # This path does not exist. However, when we set the gopath to /go, the build fails. Not sure why.
@@ -640,12 +693,13 @@ steps:
       - ./mage-static release:compress
 
   - name: after-build-static
-    image: techknowlogick/xgo:latest
+    image: ghcr.io/techknowlogick/xgo:go-1.23.x
     pull: always
     depends_on:
       - after-build-compress
     commands:
       - go install github.com/magefile/mage
+      - ./mage-static generate:config-yaml 1
       - ./mage-static release:copy
       - ./mage-static release:check
       - ./mage-static release:os-package
@@ -669,13 +723,13 @@ steps:
     image: plugins/s3
     pull: always
     settings:
-      bucket: vikunja-releases
+      bucket: vikunja
       access_key:
-        from_secret: aws_access_key_id
+        from_secret: hetzner_access_key_id
       secret_key:
-        from_secret: aws_secret_access_key
-      endpoint: https://s3.fr-par.scw.cloud
-      region: fr-par
+        from_secret: hetzner_secret_access_key
+      endpoint: https://fsn1.your-objectstorage.com
+      region: fsn1
       path_style: true
       strip_prefix: dist/zip/
       source: dist/zip/*
@@ -691,13 +745,13 @@ steps:
     image: plugins/s3
     pull: always
     settings:
-      bucket: vikunja-releases
+      bucket: vikunja
       access_key:
-        from_secret: aws_access_key_id
+        from_secret: hetzner_access_key_id
       secret_key:
-        from_secret: aws_secret_access_key
-      endpoint: https://s3.fr-par.scw.cloud
-      region: fr-par
+        from_secret: hetzner_secret_access_key
+      endpoint: https://fsn1.your-objectstorage.com
+      region: fsn1
       path_style: true
       strip_prefix: dist/zip/
       source: dist/zip/*
@@ -709,7 +763,7 @@ steps:
 
   # Build os packages and push it to our bucket
   - name: build-os-packages-unstable
-    image: goreleaser/nfpm:v2.35.3
+    image: goreleaser/nfpm:v2.41.0
     pull: always
     commands:
       - apk add git go
@@ -725,7 +779,7 @@ steps:
     depends_on: [ after-build-compress ]
 
   - name: build-os-packages-version
-    image: goreleaser/nfpm:v2.35.3
+    image: goreleaser/nfpm:v2.41.0
     pull: always
     commands:
       - apk add git go
@@ -743,13 +797,13 @@ steps:
     image: plugins/s3
     pull: always
     settings:
-      bucket: vikunja-releases
+      bucket: vikunja
       access_key:
-        from_secret: aws_access_key_id
+        from_secret: hetzner_access_key_id
       secret_key:
-        from_secret: aws_secret_access_key
-      endpoint: https://s3.fr-par.scw.cloud
-      region: fr-par
+        from_secret: hetzner_secret_access_key
+      endpoint: https://fsn1.your-objectstorage.com
+      region: fsn1
       path_style: true
       strip_prefix: dist/os-packages/
       source: dist/os-packages/*
@@ -765,13 +819,13 @@ steps:
     image: plugins/s3
     pull: always
     settings:
-      bucket: vikunja-releases
+      bucket: vikunja
       access_key:
-        from_secret: aws_access_key_id
+        from_secret: hetzner_access_key_id
       secret_key:
-        from_secret: aws_secret_access_key
-      endpoint: https://s3.fr-par.scw.cloud
-      region: fr-par
+        from_secret: hetzner_secret_access_key
+      endpoint: https://fsn1.your-objectstorage.com
+      region: fsn1
       path_style: true
       strip_prefix: dist/os-packages/
       source: dist/os-packages/*
@@ -790,7 +844,7 @@ steps:
       base_url: https://kolaente.dev
       files: dist/zip/*
       prerelease: true
-      title: ${DRONE_TAG##v} 
+      title: ${DRONE_TAG##v}
     when:
       event:
         - tag
@@ -808,6 +862,9 @@ trigger:
   ref:
     - refs/heads/main
     - "refs/tags/**"
+  event:
+    exclude:
+      - cron
 
 steps:
   - name: fetch-tags
@@ -827,7 +884,6 @@ steps:
       repo: vikunja/vikunja
       tags: unstable
       platforms:
-        - linux/386
         - linux/amd64
         - linux/arm/v6
         - linux/arm/v7
@@ -859,7 +915,6 @@ steps:
         from_secret: docker_password
       repo: vikunja/vikunja
       platforms:
-        - linux/386
         - linux/amd64
         - linux/arm/v6
         - linux/arm/v7
@@ -889,9 +944,9 @@ steps:
     image: docker:git
     commands:
       - git fetch --tags
-  
+
   - name: build
-    image: node:20.11.0-alpine
+    image: node:22.11.0-alpine
     pull: always
     environment:
       PNPM_CACHE_FOLDER: .cache/pnpm
@@ -921,13 +976,13 @@ steps:
     image: plugins/s3
     pull: always
     settings:
-      bucket: vikunja-releases
+      bucket: vikunja
       access_key:
-        from_secret: aws_access_key_id
+        from_secret: hetzner_access_key_id
       secret_key:
-        from_secret: aws_secret_access_key
-      endpoint: https://s3.fr-par.scw.cloud
-      region: fr-par
+        from_secret: hetzner_secret_access_key
+      endpoint: https://fsn1.your-objectstorage.com
+      region: fsn1
       path_style: true
       source: frontend/vikunja-frontend-unstable.zip
       target: /
@@ -950,9 +1005,9 @@ steps:
     image: docker:git
     commands:
       - git fetch --tags
-  
+
   - name: build
-    image: node:20.11.0-alpine
+    image: node:22.11.0-alpine
     pull: always
     environment:
       PNPM_CACHE_FOLDER: .cache/pnpm
@@ -980,13 +1035,13 @@ steps:
     image: plugins/s3
     pull: always
     settings:
-      bucket: vikunja-releases
+      bucket: vikunja
       access_key:
-        from_secret: aws_access_key_id
+        from_secret: hetzner_access_key_id
       secret_key:
-        from_secret: aws_secret_access_key
-      endpoint: https://s3.fr-par.scw.cloud
-      region: fr-par
+        from_secret: hetzner_secret_access_key
+      endpoint: https://fsn1.your-objectstorage.com
+      region: fsn1
       path_style: true
       source: frontend/vikunja-frontend-${DRONE_TAG##v}.zip
       target: /
@@ -1073,33 +1128,33 @@ steps:
     image: docker:git
     commands:
       - git fetch --tags
-#
-#  - name: restore-cache
-#    image: meltwater/drone-cache:dev
-#    pull: true
-#    environment:
-#      AWS_ACCESS_KEY_ID:
-#        from_secret: cache_aws_access_key_id
-#      AWS_SECRET_ACCESS_KEY:
-#        from_secret: cache_aws_secret_access_key
-#    settings:
-#      restore: true
-#      bucket: kolaente.dev-drone-dependency-cache
-#      endpoint: https://s3.fr-par.scw.cloud
-#      region: fr-par
-#      path_style: true
-#      cache_key: '{{ .Repo.Name }}_{{ checksum "desktop/yarn.lock" }}_{{ arch }}_{{ os }}'
-#      mount:
-#        - '.cache'
+  #
+  #  - name: restore-cache
+  #    image: meltwater/drone-cache:dev
+  #    pull: true
+  #    environment:
+  #      AWS_ACCESS_KEY_ID:
+  #        from_secret: cache_aws_access_key_id
+  #      AWS_SECRET_ACCESS_KEY:
+  #        from_secret: cache_aws_secret_access_key
+  #    settings:
+  #      restore: true
+  #      bucket: kolaente.dev-drone-dependency-cache
+  #      endpoint: https://fsn1.your-objectstorage.com
+  #      region: fsn1
+  #      path_style: true
+  #      cache_key: '{{ .Repo.Name }}_{{ checksum "desktop/yarn.lock" }}_{{ arch }}_{{ os }}'
+  #      mount:
+  #        - '.cache'
 
   - name: build
-    image: electronuserland/builder:wine-mono
+    image: electronuserland/builder:wine
     pull: true
     environment:
-      YARN_CACHE_FOLDER: .cache/yarn/
+      PNPM_CACHE_FOLDER: .cache/pnpm
     depends_on:
       - fetch-tags
-#      - restore-cache
+    #      - restore-cache
     commands:
       - cd desktop
       - export VERSION=${DRONE_TAG##v}
@@ -1109,8 +1164,9 @@ steps:
       - unzip vikunja-frontend-$$VERSION.zip -d frontend
       - sed -i 's/\\/api\\/v1//g' frontend/index.html
       - ./bumpp.sh
-      - yarn install
-      - yarn dist --linux --windows
+      - corepack enable && pnpm config set store-dir .cache/pnpm
+      - pnpm install --fetch-timeout 100000
+      - pnpm dist --linux zip
 
 #  - name: rebuild-cache
 #    image: meltwater/drone-cache:dev
@@ -1123,8 +1179,8 @@ steps:
 #    settings:
 #      rebuild: true
 #      bucket: kolaente.dev-drone-dependency-cache
-#      endpoint: https://s3.fr-par.scw.cloud
-#      region: fr-par
+#      endpoint: https://fsn1.your-objectstorage.com
+#      region: fsn1
 #      path_style: true
 #      cache_key: '{{ .Repo.Name }}_{{ checksum "desktop/yarn.lock" }}_{{ arch }}_{{ os }}'
 #      mount:
@@ -1145,39 +1201,42 @@ trigger:
   ref:
     - refs/heads/main
     - "refs/tags/**"
+  event:
+    exclude:
+      - cron
 
 steps:
   - name: fetch-tags
     image: docker:git
     commands:
       - git fetch --tags
-
-#  - name: restore-cache
-#    image: meltwater/drone-cache:dev
-#    pull: true
-#    environment:
-#      AWS_ACCESS_KEY_ID:
-#        from_secret: cache_aws_access_key_id
-#      AWS_SECRET_ACCESS_KEY:
-#        from_secret: cache_aws_secret_access_key
-#    settings:
-#      restore: true
-#      bucket: kolaente.dev-drone-dependency-cache
-#      endpoint: https://s3.fr-par.scw.cloud
-#      region: fr-par
-#      path_style: true
-#      cache_key: '{{ .Repo.Name }}_{{ checksum "desktop/yarn.lock" }}_{{ arch }}_{{ os }}'
-#      mount:
-#        - '.cache'
+  
+  #  - name: restore-cache
+  #    image: meltwater/drone-cache:dev
+  #    pull: true
+  #    environment:
+  #      AWS_ACCESS_KEY_ID:
+  #        from_secret: cache_aws_access_key_id
+  #      AWS_SECRET_ACCESS_KEY:
+  #        from_secret: cache_aws_secret_access_key
+  #    settings:
+  #      restore: true
+  #      bucket: kolaente.dev-drone-dependency-cache
+  #      endpoint: https://fsn1.your-objectstorage.com
+  #      region: fsn1
+  #      path_style: true
+  #      cache_key: '{{ .Repo.Name }}_{{ checksum "desktop/yarn.lock" }}_{{ arch }}_{{ os }}'
+  #      mount:
+  #        - '.cache'
 
   - name: build
-    image: electronuserland/builder:wine-mono
+    image: electronuserland/builder:wine
     pull: true
     environment:
-      YARN_CACHE_FOLDER: .cache/yarn/
+      PNPM_CACHE_FOLDER: .cache/pnpm
     depends_on:
       - fetch-tags
-#      - restore-cache
+    #      - restore-cache
     commands:
       - cd desktop
       - export VERSION=${DRONE_TAG##v}
@@ -1187,30 +1246,30 @@ steps:
       - unzip vikunja-frontend-$$VERSION.zip -d frontend
       - sed -i 's/\\/api\\/v1//g' frontend/index.html
       - ./bumpp.sh
-      - yarn install
-      - cat package.json
-      - yarn dist --linux --windows
-
-#  - name: rebuild-cache
-#    image: meltwater/drone-cache:dev
-#    pull: true
-#    environment:
-#      AWS_ACCESS_KEY_ID:
-#        from_secret: cache_aws_access_key_id
-#      AWS_SECRET_ACCESS_KEY:
-#        from_secret: cache_aws_secret_access_key
-#    settings:
-#      rebuild: true
-#      bucket: kolaente.dev-drone-dependency-cache
-#      endpoint: https://s3.fr-par.scw.cloud
-#      region: fr-par
-#      path_style: true
-#      cache_key: '{{ .Repo.Name }}_{{ checksum "desktop/yarn.lock" }}_{{ arch }}_{{ os }}'
-#      mount:
-#        - '.cache'
-#    depends_on:
-#      - build
+      - corepack enable && pnpm config set store-dir .cache/pnpm
+      - pnpm install --fetch-timeout 100000
+      - pnpm dist --linux --windows
   
+  #  - name: rebuild-cache
+  #    image: meltwater/drone-cache:dev
+  #    pull: true
+  #    environment:
+  #      AWS_ACCESS_KEY_ID:
+  #        from_secret: cache_aws_access_key_id
+  #      AWS_SECRET_ACCESS_KEY:
+  #        from_secret: cache_aws_secret_access_key
+  #    settings:
+  #      rebuild: true
+  #      bucket: kolaente.dev-drone-dependency-cache
+  #      endpoint: https://fsn1.your-objectstorage.com
+  #      region: fsn1
+  #      path_style: true
+  #      cache_key: '{{ .Repo.Name }}_{{ checksum "desktop/yarn.lock" }}_{{ arch }}_{{ os }}'
+  #      mount:
+  #        - '.cache'
+  #    depends_on:
+  #      - build
+
   - name: rename-unstable
     image: bash
     pull: true
@@ -1228,13 +1287,13 @@ steps:
     image: plugins/s3
     pull: true
     settings:
-      bucket: vikunja-releases
+      bucket: vikunja
       access_key:
-        from_secret: aws_access_key_id
+        from_secret: hetzner_access_key_id
       secret_key:
-        from_secret: aws_secret_access_key
-      endpoint: https://s3.fr-par.scw.cloud
-      region: fr-par
+        from_secret: hetzner_secret_access_key
+      endpoint: https://fsn1.your-objectstorage.com
+      region: fsn1
       path_style: true
       strip_prefix: desktop/dist/
       source: desktop/dist/Vikunja-Desktop*
@@ -1250,13 +1309,13 @@ steps:
     image: plugins/s3
     pull: true
     settings:
-      bucket: vikunja-releases
+      bucket: vikunja
       access_key:
-        from_secret: aws_access_key_id
+        from_secret: hetzner_access_key_id
       secret_key:
-        from_secret: aws_secret_access_key
-      endpoint: https://s3.fr-par.scw.cloud
-      region: fr-par
+        from_secret: hetzner_secret_access_key
+      endpoint: https://fsn1.your-objectstorage.com
+      region: fsn1
       path_style: true
       strip_prefix: desktop/dist/
       source: desktop/dist/*
@@ -1285,9 +1344,9 @@ steps:
 #  - name: build
 #    environment:
 #      ACCESS_KEY:
-#        from_secret: aws_access_key_id
+#        from_secret: hetzner_access_key_id
 #      SECRET_KEY:
-#        from_secret: aws_secret_access_key
+#        from_secret: hetzner_secret_access_key
 #    commands:
 #      - git fetch --tags
 #      - export VERSION=${DRONE_TAG##v}
@@ -1300,57 +1359,10 @@ steps:
 #      - sed -i '' "s/\$${version}/$$VERSION/g" package.json
 #      - yarn install
 #      - yarn dist --mac
-#      - mc config host add scw-fr-par https://s3.fr-par.scw.cloud $ACCESS_KEY $SECRET_KEY --api S3v4
-#      - mc cp ./dist/*.dmg scw-fr-par/vikunja-releases/desktop/$VERSION/
-#      - mc cp ./dist/*.dmg.blockmap scw-fr-par/vikunja-releases/desktop/$VERSION/
+#      - mc config host add scw-fsn1 https://fsn1.your-objectstorage.com $ACCESS_KEY $SECRET_KEY --api S3v4
+#      - mc cp ./dist/*.dmg scw-fsn1/vikunja/desktop/$VERSION/
+#      - mc cp ./dist/*.dmg.blockmap scw-fsn1/vikunja/desktop/$VERSION/
 
----
-kind: pipeline
-type: docker
-name: deploy-docs
-
-workspace:
-  base: /go
-  path: src/code.vikunja.io/api
-
-clone:
-  depth: 50
-
-trigger:
-  event:
-    - push
-  branch:
-    - main
-
-steps:
-  - name: theme
-    image: kolaente/toolbox
-    pull: always
-    commands:
-      - mkdir docs/themes/vikunja -p
-      - cd docs/themes/vikunja
-      - wget https://dl.vikunja.io/theme/vikunja-theme.tar.gz
-      - tar -xzf vikunja-theme.tar.gz
-
-  - name: build
-    image: klakegg/hugo:0.111.3
-    pull: always
-    commands:
-      - cd docs
-      - hugo
-      - mv public/docs/* public # Hugo seems to be not capable of setting a different theme for a home page, so we do this ugly hack to fix it.
-
-  - name: docker
-    image: plugins/docker
-    pull: always
-    settings:
-      username:
-        from_secret: docker_username
-      password:
-        from_secret: docker_password
-      repo: vikunja/docs
-      context: docs/
-      dockerfile: docs/Dockerfile
 ---
 kind: pipeline
 type: docker
@@ -1360,11 +1372,13 @@ trigger:
   ref:
     - refs/heads/main
     - "refs/tags/**"
+  event:
+    exclude:
+      - cron
 
 depends_on:
   - build-and-test
   - release
-  - deploy-docs
   - docker-release
   - desktop-release
 
@@ -1384,6 +1398,6 @@ steps:
         - failure
 ---
 kind: signature
-hmac: 008b86263a8d03806da907c128a837a380901f1a2190a658c22d4e06cadc1b64
+hmac: 7fc1cb2b0cfdc84d7eda25ce75dd56446fc01060c03af89c91043f095e92a2b3
 
 ...

.envrc

@@ -0,0 +1,3 @@
+source_url "https://raw.githubusercontent.com/cachix/devenv/95f329d49a8a5289d31e0982652f7058a189bfca/direnvrc" "sha256-d+8cBpDfDBj41inrADaJt+bDWhOktwslgoP5YiGJ1v0="
+
+use devenv

.gitignore

@@ -28,3 +28,14 @@ vendor/
 os-packages/
 mage_output_file.go
 mage-static
+.DS_Store
+
+# Devenv
+.devenv*
+devenv.local.nix
+
+# direnv
+.direnv
+
+# pre-commit
+.pre-commit-config.yaml

.golangci.yml

@@ -4,20 +4,22 @@ run:
 
 linters:
   enable:
-    - megacheck
+    - gosimple
+    - staticcheck
+    - unused
     - govet
     - gocritic
     - gocyclo
-    - goerr113
+    - err113
     - goheader
     - gofmt
     - goimports
     - revive
     - misspell
   disable:
-    - scopelint # Obsolete, using exportloopref instead
     - durationcheck
     - goconst
+    - musttag
   presets:
     - bugs
     - unused
@@ -54,7 +56,7 @@ issues:
     - path: pkg/migration/*
       linters:
         - exhaustive
-        - goerr113
+        - err113
     - path: pkg/models/task_collection_filter\.go
       linters:
         - exhaustive
@@ -64,11 +66,11 @@ issues:
         - gosec
     - path: pkg/modules/dump/*
       linters:
-        - goerr113
+        - err113
     - path: pkg/
-      text: "err113: do not define dynamic errors, use wrapped static errors instead:"
+      text: "do not define dynamic errors, use wrapped static errors instead:"
       linters:
-        - goerr113
+        - err113
     - text: "commentFormatting: put a space between `//` and comment text"
       linters:
         - gocritic
@@ -99,3 +101,21 @@ issues:
     - path: pkg/modules/migration/ticktick/ticktick_test.go
       linters:
         - testifylint
+    - path: pkg/migration/*
+      text: "parameter 'tx' seems to be unused, consider removing or renaming it as"
+      linters:
+        - revive
+    - path: pkg/models/typesense.go
+      text: 'structtag: struct field Position repeats json tag "position" also at'
+      linters:
+        - govet
+    - path: pkg/cmd/user.go
+      text: 'G115: integer overflow conversion uintptr -> int'
+      linters:
+        - gosec
+    - text: 'G115: integer overflow conversion int64 -> uint64'
+      linters:
+        - gosec
+    - text: 'G115: integer overflow conversion int -> uint64'
+      linters:
+        - gosec

.vscode/extensions.json

@@ -1,14 +1,15 @@
 {
-  "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",
-    "zixuanchen.vitest-explorer"
-  ]
+    "recommendations": [
+        "codezombiech.gitignore",
+        "dbaeumer.vscode-eslint",
+        "editorconfig.editorconfig",
+        "vue.volar",
+        "lokalise.i18n-ally",
+        "mgmcdermott.vscode-language-babel",
+        "mikestead.dotenv",
+        "Syler.sass-indented",
+        "vitest.explorer",
+        "mkhl.direnv",
+        "golang.Go"
+    ]
 }

.vscode/settings.json

@@ -2,10 +2,9 @@
     "go.testEnvVars": {
         "VIKUNJA_SERVICE_ROOTPATH": "${workspaceRoot}"
     },
-    "eslint.packageManager": "pnpm",
     "editor.formatOnSave": false,
     "editor.codeActionsOnSave": {
-        "source.fixAll": true
+        "source.fixAll": "explicit"
     },
     "eslint.format.enable": true,
     "[javascript]": {
@@ -22,14 +21,12 @@
         "vue"
     ],
 
-    "volar.completion.preferredTagNameCase": "pascal",
-
-    // disable vetur in case it is installed
+    // disable vetur in case it's installed
     "vetur.validation.template": false,
 
     // i18n ally
     "i18n-ally.localesPaths": [
-        "src/i18n/lang"
+        "frontend/src/i18n/lang"
     ],
     "i18n-ally.sortKeys": true,
     "i18n-ally.keepFulfilled": true,

Dockerfile

@@ -1,10 +1,11 @@
 # syntax=docker/dockerfile:1
-FROM --platform=$BUILDPLATFORM node:20.11.0-alpine AS frontendbuilder
+FROM --platform=$BUILDPLATFORM node:22.11.0-alpine AS frontendbuilder
 
 WORKDIR /build
 
-ENV PNPM_CACHE_FOLDER .cache/pnpm/
-ENV PUPPETEER_SKIP_DOWNLOAD true
+ENV PNPM_CACHE_FOLDER=.cache/pnpm/
+ENV PUPPETEER_SKIP_DOWNLOAD=true
+ENV CYPRESS_INSTALL_BINARY=0
 
 COPY frontend/ ./
 
@@ -12,7 +13,7 @@ RUN corepack enable && \
       pnpm install && \
       pnpm run build
 
-FROM --platform=$BUILDPLATFORM techknowlogick/xgo:go-1.21.x AS apibuilder
+FROM --platform=$BUILDPLATFORM ghcr.io/techknowlogick/xgo:go-1.23.x AS apibuilder
 
 RUN go install github.com/magefile/mage@latest && \
     mv /go/bin/mage /usr/local/go/bin
@@ -23,7 +24,7 @@ COPY --from=frontendbuilder /build/dist ./frontend/dist
 
 ARG TARGETOS TARGETARCH TARGETVARIANT
 
-ENV GOPROXY https://goproxy.kolaente.de
+ENV GOPROXY=https://goproxy.kolaente.de
 RUN export PATH=$PATH:$GOPATH/bin && \
 	mage build:clean && \
     mage release:xgo "${TARGETOS}/${TARGETARCH}/${TARGETVARIANT}"
@@ -34,7 +35,14 @@ RUN export PATH=$PATH:$GOPATH/bin && \
 
 # The actual image
 FROM scratch
-LABEL maintainer="maintainers@vikunja.io"
+
+LABEL org.opencontainers.image.authors='maintainers@vikunja.io'
+LABEL org.opencontainers.image.url='https://vikunja.io'
+LABEL org.opencontainers.image.documentation='https://vikunja.io/docs'
+LABEL org.opencontainers.image.source='https://code.vikunja.io/vikunja'
+LABEL org.opencontainers.image.licenses='AGPLv3'
+LABEL org.opencontainers.image.title='Vikunja'
+
 WORKDIR /app/vikunja
 ENTRYPOINT [ "/app/vikunja/vikunja" ]
 EXPOSE 3456

README.md

@@ -2,7 +2,7 @@
 
 [![Build Status](https://drone.kolaente.de/api/badges/vikunja/vikunjaa/status.svg)](https://drone.kolaente.de/vikunja/vikunja)
 [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](LICENSE)
-[![Download](https://img.shields.io/badge/download-v0.23.0-brightgreen.svg)](https://dl.vikunja.io)
+[![Install](https://img.shields.io/badge/download-v0.24.4-brightgreen.svg)](https://vikunja.io/docs/installing)
 [![Docker Pulls](https://img.shields.io/docker/pulls/vikunja/vikunja.svg)](https://hub.docker.com/r/vikunja/vikunja/)
 [![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/vikunja)](https://goreportcard.com/report/kolaente.dev/vikunja/vikunja)
@@ -29,7 +29,7 @@ If you find any security-related issues you don't want to disclose publicly, ple
 
 ## Features
 
-See [the features page](https://vikunja.io/features/) on our website for a more exaustive list or 
+See [the features page](https://vikunja.io/features/) on our website for a more exhaustive list or 
 try it on [try.vikunja.io](https://try.vikunja.io)!
 
 ## Docs

cliff.toml

@@ -17,6 +17,7 @@ body = """
         {% raw %}  {% endraw %}- **BREAKING**: {{commit.breaking_description}}
         {%- endif -%}
     {%- endfor -%}
+		{% raw %}\n{% endraw %}\
     {%- for commit in commits %}
         {%- if commit.scope -%}
         {% else -%}
@@ -56,4 +57,3 @@ commit_parsers = [
     { body = ".*security", group = "Security"},
     { message = ".*", group = "Other", default_scope = "other"}, # Everything that's not a conventional commit goes into the "Other" category
 ]
-

config-raw.json

@@ -0,0 +1,839 @@
+{
+    "children": [
+        {
+            "key": "service",
+            "children": [
+                {
+                    "key": "JWTSecret",
+                    "default_value": "\u003cjwt-secret\u003e",
+                    "comment": "This token is used to verify issued JWT tokens.\nDefault is a random token which will be generated at each startup of Vikunja.\n(This means all already issued tokens will be invalid once you restart Vikunja)"
+                },
+                {
+                    "key": "jwtttl",
+                    "default_value": "259200",
+                    "comment": "The duration of the issued JWT tokens in seconds.\nThe default is 259200 seconds (3 Days)."
+                },
+                {
+                    "key": "jwtttllong",
+                    "default_value": "2592000",
+                    "comment": "The duration of the \"remember me\" time in seconds. When the login request is made with\nthe long param set, the token returned will be valid for this period.\nThe default is 2592000 seconds (30 Days)."
+                },
+                {
+                    "key": "interface",
+                    "default_value": ":3456",
+                    "comment": "The interface on which to run the webserver"
+                },
+                {
+                    "key": "unixsocket",
+                    "default_value": "",
+                    "comment": "Path to Unix socket. If set, it will be created and used instead of tcp"
+                },
+                {
+                    "key": "unixsocketmode",
+                    "default_value": "",
+                    "comment": "Permission bits for the Unix socket. Note that octal values must be prefixed by \"0o\", e.g. 0o660"
+                },
+                {
+                    "key": "publicurl",
+                    "default_value": "",
+                    "comment": "The public facing URL where your users can reach Vikunja. Used in emails and for the communication between api and frontend."
+                },
+                {
+                    "key": "rootpath",
+                    "default_value": "\u003crootpath\u003e",
+                    "comment": "The base path on the file system where the binary and assets are.\nVikunja will also look in this path for a config file, so you could provide only this variable to point to a folder\nwith a config file which will then be used."
+                },
+                {
+                    "key": "maxitemsperpage",
+                    "default_value": "50",
+                    "comment": "The max number of items which can be returned per page"
+                },
+                {
+                    "key": "enablecaldav",
+                    "default_value": "true",
+                    "comment": "Enable the caldav endpoint, see the docs for more details"
+                },
+                {
+                    "key": "motd",
+                    "default_value": "",
+                    "comment": "Set the motd message, available from the /info endpoint"
+                },
+                {
+                    "key": "enablelinksharing",
+                    "default_value": "true",
+                    "comment": "Enable sharing of project via a link"
+                },
+                {
+                    "key": "enableregistration",
+                    "default_value": "true",
+                    "comment": "Whether to let new users registering themselves or not"
+                },
+                {
+                    "key": "enabletaskattachments",
+                    "default_value": "true",
+                    "comment": "Whether to enable task attachments or not"
+                },
+                {
+                    "key": "timezone",
+                    "default_value": "GMT",
+                    "comment": "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."
+                },
+                {
+                    "key": "enabletaskcomments",
+                    "default_value": "true",
+                    "comment": "Whether task comments should be enabled or not"
+                },
+                {
+                    "key": "enabletotp",
+                    "default_value": "true",
+                    "comment": "Whether totp is enabled. In most cases you want to leave that enabled."
+                },
+                {
+                    "key": "testingtoken",
+                    "default_value": "",
+                    "comment": "If not empty, this will enable `/test/{table}` endpoints which allow to put any content in the database.\nUsed to reset the db before frontend tests. Because this is quite a dangerous feature allowing for lots of harm,\neach request made to this endpoint needs to provide an `Authorization: \u003ctoken\u003e` header with the token from below. \u003cbr/\u003e\n**You should never use this unless you know exactly what you're doing**"
+                },
+                {
+                    "key": "enableemailreminders",
+                    "default_value": "true",
+                    "comment": "If enabled, Vikunja will send an email to everyone who is either assigned to a task or created it when a task reminder\nis due."
+                },
+                {
+                    "key": "enableuserdeletion",
+                    "default_value": "true",
+                    "comment": "If true, will allow users to request the complete deletion of their account. When using external authentication methods\nit may be required to coordinate with them in order to delete the account. This setting will not affect the cli commands\nfor user deletion."
+                },
+                {
+                    "key": "maxavatarsize",
+                    "default_value": "1024",
+                    "comment": "The maximum size clients will be able to request for user avatars.\nIf clients request a size bigger than this, it will be changed on the fly."
+                },
+                {
+                    "key": "demomode",
+                    "default_value": "false",
+                    "comment": "If set to true, the frontend will show a big red warning not to use this instance for real data as it will be cleared out.\nYou probably don't need to set this value, it was created specifically for usage on [try](https://try.vikunja.io)."
+                },
+                {
+                    "key": "allowiconchanges",
+                    "default_value": "true",
+                    "comment": "Allow changing the logo and other icons based on various occasions throughout the year."
+                },
+                {
+                    "key": "customlogourl",
+                    "default_value": "",
+                    "comment": "Allow using a custom logo via external URL."
+                },
+                {
+                    "key": "enablepublicteams",
+                    "default_value": "false",
+                    "comment": "Enables the public team feature. If enabled, it is possible to configure teams to be public, which makes them\ndiscoverable when sharing a project, therefore not only showing teams the user is member of."
+                },
+                {
+                    "key": "bcryptrounds",
+                    "default_value": "11",
+                    "comment": "The number of bcrypt rounds to use during registration. Each increment of this number doubles the computational cost. You probably don't need to change this value."
+                },
+                {
+                    "key": "enableopenidteamusersearch",
+                    "default_value": "false",
+                    "comment": "If enabled, users will only find other users who are part of an existing team when they are searching for a user by their partial name. The other existing team may be created from openid. It is still possible to add users to teams with their exact email address even when this is enabled."
+                }
+            ]
+        },
+        {
+            "key": "sentry",
+            "children": [
+                {
+                    "key": "enabled",
+                    "default_value": "false",
+                    "comment": "If set to true, enables anonymous error tracking of api errors via Sentry. This allows us to gather more\ninformation about errors in order to debug and fix it."
+                },
+                {
+                    "key": "dsn",
+                    "default_value": "https://440eedc957d545a795c17bbaf477497c@o1047380.ingest.sentry.io/4504254983634944",
+                    "comment": "Configure the Sentry dsn used for api error tracking. Only used when Sentry is enabled for the api."
+                },
+                {
+                    "key": "frontendenabled",
+                    "default_value": "false",
+                    "comment": "If set to true, enables anonymous error tracking of frontend errors via Sentry. This allows us to gather more\ninformation about errors in order to debug and fix it."
+                },
+                {
+                    "key": "frontenddsn",
+                    "default_value": "https://85694a2d757547cbbc90cd4b55c5a18d@o1047380.ingest.sentry.io/6024480",
+                    "comment": "Configure the Sentry dsn used for frontend error tracking. Only used when Sentry is enabled for the frontend."
+                }
+            ]
+        },
+        {
+            "key": "database",
+            "children": [
+                {
+                    "key": "type",
+                    "default_value": "sqlite",
+                    "comment": "Database type to use. Supported values are mysql, postgres and sqlite. Vikunja is able to run with MySQL 8.0+, Mariadb 10.2+, PostgreSQL 12+, and sqlite."
+                },
+                {
+                    "key": "user",
+                    "default_value": "vikunja",
+                    "comment": "Database user which is used to connect to the database."
+                },
+                {
+                    "key": "password",
+                    "default_value": "",
+                    "comment": "Database password"
+                },
+                {
+                    "key": "host",
+                    "default_value": "localhost",
+                    "comment": "Database host"
+                },
+                {
+                    "key": "database",
+                    "default_value": "vikunja",
+                    "comment": "Database to use"
+                },
+                {
+                    "key": "path",
+                    "default_value": "./vikunja.db",
+                    "comment": "When using sqlite, this is the path where to store the data"
+                },
+                {
+                    "key": "maxopenconnections",
+                    "default_value": "100",
+                    "comment": "Sets the max open connections to the database. Only used when using mysql and postgres."
+                },
+                {
+                    "key": "maxidleconnections",
+                    "default_value": "50",
+                    "comment": "Sets the maximum number of idle connections to the db."
+                },
+                {
+                    "key": "maxconnectionlifetime",
+                    "default_value": "10000",
+                    "comment": "The maximum lifetime of a single db connection in milliseconds."
+                },
+                {
+                    "key": "sslmode",
+                    "default_value": "disable",
+                    "comment": "Secure connection mode. Only used with postgres.\n(see https://pkg.go.dev/github.com/lib/pq?tab=doc#hdr-Connection_String_Parameters)"
+                },
+                {
+                    "key": "sslcert",
+                    "default_value": "",
+                    "comment": "The path to the client cert. Only used with postgres."
+                },
+                {
+                    "key": "sslkey",
+                    "default_value": "",
+                    "comment": "The path to the client key. Only used with postgres."
+                },
+                {
+                    "key": "sslrootcert",
+                    "default_value": "",
+                    "comment": "The path to the ca cert. Only used with postgres."
+                },
+                {
+                    "key": "tls",
+                    "default_value": "false",
+                    "comment": "Enable SSL/TLS for mysql connections. Options: false, true, skip-verify, preferred"
+                }
+            ]
+        },
+        {
+            "key": "typesense",
+            "children": [
+                {
+                    "key": "enabled",
+                    "default_value": "false",
+                    "comment": "Whether to enable the Typesense integration. If true, all tasks will be synced to the configured Typesense\ninstance and all search and filtering will run through Typesense instead of only through the database.\nTypesense allows fast fulltext search including fuzzy matching support. It may return different results than\nwhat you'd get with a database-only search."
+                },
+                {
+                    "key": "url",
+                    "default_value": "",
+                    "comment": "The url to the Typesense instance you want to use. Can be hosted locally or in Typesense Cloud as long\nas Vikunja is able to reach it."
+                },
+                {
+                    "key": "apikey",
+                    "default_value": "",
+                    "comment": "The Typesense API key you want to use."
+                }
+            ]
+        },
+        {
+            "key": "redis",
+            "children": [
+                {
+                    "key": "enabled",
+                    "default_value": "false",
+                    "comment": "Whether to enable redis or not"
+                },
+                {
+                    "key": "host",
+                    "default_value": "localhost:6379",
+                    "comment": "The host of the redis server including its port."
+                },
+                {
+                    "key": "password",
+                    "default_value": "",
+                    "comment": "The password used to authenticate against the redis server"
+                },
+                {
+                    "key": "db",
+                    "default_value": "0",
+                    "comment": "0 means default database"
+                }
+            ]
+        },
+        {
+            "key": "cors",
+            "children": [
+                {
+                    "key": "enable",
+                    "default_value": "false",
+                    "comment": "Whether to enable or disable cors headers.\nNote: If you want to put the frontend and the api on separate domains or ports, you will need to enable this.\nOtherwise the frontend won't be able to make requests to the api through the browser."
+                },
+                {
+                    "key": "origins",
+                    "comment": "A list of origins which may access the api. These need to include the protocol (`http://` or `https://`) and port, if any.",
+                    "children": [
+                        {
+                            "default_value": "*"
+                        }
+                    ]
+                },
+                {
+                    "key": "maxage",
+                    "default_value": "0",
+                    "comment": "How long (in seconds) the results of a preflight request can be cached."
+                }
+            ]
+        },
+        {
+            "key": "mailer",
+            "children": [
+                {
+                    "key": "enabled",
+                    "default_value": "false",
+                    "comment": "Whether to enable the mailer or not. If it is disabled, all users are enabled right away and password reset is not possible."
+                },
+                {
+                    "key": "host",
+                    "default_value": "",
+                    "comment": "SMTP Host"
+                },
+                {
+                    "key": "port",
+                    "default_value": "587",
+                    "comment": "SMTP Host port.\n**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`."
+                },
+                {
+                    "key": "authtype",
+                    "default_value": "plain",
+                    "comment": "SMTP Auth Type. Can be either `plain`, `login` or `cram-md5`."
+                },
+                {
+                    "key": "username",
+                    "default_value": "user",
+                    "comment": "SMTP username"
+                },
+                {
+                    "key": "password",
+                    "default_value": "",
+                    "comment": "SMTP password"
+                },
+                {
+                    "key": "skiptlsverify",
+                    "default_value": "false",
+                    "comment": "Whether to skip verification of the tls certificate on the server"
+                },
+                {
+                    "key": "fromemail",
+                    "default_value": "mail@vikunja",
+                    "comment": "The default from address when sending emails"
+                },
+                {
+                    "key": "queuelength",
+                    "default_value": "100",
+                    "comment": "The length of the mail queue."
+                },
+                {
+                    "key": "queuetimeout",
+                    "default_value": "30",
+                    "comment": "The timeout in seconds after which the current open connection to the mailserver will be closed."
+                },
+                {
+                    "key": "forcessl",
+                    "default_value": "false",
+                    "comment": "By default, Vikunja will try to connect with starttls, use this option to force it to use ssl."
+                }
+            ]
+        },
+        {
+            "key": "log",
+            "children": [
+                {
+                    "key": "path",
+                    "default_value": "\u003crootpath\u003elogs",
+                    "comment": "A folder where all the logfiles should go."
+                },
+                {
+                    "key": "enabled",
+                    "default_value": "true",
+                    "comment": "Whether to show any logging at all or none"
+                },
+                {
+                    "key": "standard",
+                    "default_value": "stdout",
+                    "comment": "Where the normal log should go. Possible values are stdout, stderr, file or off to disable standard logging."
+                },
+                {
+                    "key": "level",
+                    "default_value": "INFO",
+                    "comment": "Change the log level. Possible values (case-insensitive) are CRITICAL, ERROR, WARNING, NOTICE, INFO, DEBUG."
+                },
+                {
+                    "key": "database",
+                    "default_value": "off",
+                    "comment": "Whether or not to log database queries. Useful for debugging. Possible values are stdout, stderr, file or off to disable database logging."
+                },
+                {
+                    "key": "databaselevel",
+                    "default_value": "WARNING",
+                    "comment": "The log level for database log messages. Possible values (case-insensitive) are CRITICAL, ERROR, WARNING, NOTICE, INFO, DEBUG."
+                },
+                {
+                    "key": "http",
+                    "default_value": "stdout",
+                    "comment": "Whether to log http requests or not. Possible values are stdout, stderr, file or off to disable http logging."
+                },
+                {
+                    "key": "echo",
+                    "default_value": "off",
+                    "comment": "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."
+                },
+                {
+                    "key": "events",
+                    "default_value": "off",
+                    "comment": "Whether or not to log events. Useful for debugging. Possible values are stdout, stderr, file or off to disable events logging."
+                },
+                {
+                    "key": "eventslevel",
+                    "default_value": "info",
+                    "comment": "The log level for event log messages. Possible values (case-insensitive) are ERROR, INFO, DEBUG."
+                },
+                {
+                    "key": "mail",
+                    "default_value": "off",
+                    "comment": "Whether or not to log mail log messages. This will not log mail contents. Possible values are stdout, stderr, file or off to disable mail-related logging."
+                },
+                {
+                    "key": "maillevel",
+                    "default_value": "info",
+                    "comment": "The log level for mail log messages. Possible values (case-insensitive) are ERROR, WARNING, INFO, DEBUG."
+                }
+            ]
+        },
+        {
+            "key": "ratelimit",
+            "children": [
+                {
+                    "key": "enabled",
+                    "default_value": "false",
+                    "comment": "whether or not to enable the rate limit"
+                },
+                {
+                    "key": "kind",
+                    "default_value": "user",
+                    "comment": "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."
+                },
+                {
+                    "key": "period",
+                    "default_value": "60",
+                    "comment": "The time period in seconds for the limit"
+                },
+                {
+                    "key": "limit",
+                    "default_value": "100",
+                    "comment": "The max number of requests a user is allowed to do in the configured time period"
+                },
+                {
+                    "key": "store",
+                    "default_value": "keyvalue",
+                    "comment": "The store where the limit counter for each user is stored.\nPossible values are \"keyvalue\", \"memory\" or \"redis\".\nWhen choosing \"keyvalue\" this setting follows the one configured in the \"keyvalue\" section."
+                },
+                {
+                    "key": "noauthlimit",
+                    "default_value": "10",
+                    "comment": "The number of requests a user can make from the same IP to all unauthenticated routes (login, register,\npassword confirmation, email verification, password reset request) per minute. This limit cannot be disabled.\nYou should only change this if you know what you're doing."
+                }
+            ]
+        },
+        {
+            "key": "files",
+            "children": [
+                {
+                    "key": "basepath",
+                    "default_value": "./files",
+                    "comment": "The path where files are stored"
+                },
+                {
+                    "key": "maxsize",
+                    "default_value": "20MB",
+                    "comment": "The maximum size of a file, as a human-readable string.\nWarning: The max size is limited 2^64-1 bytes due to the underlying datatype"
+                }
+            ]
+        },
+        {
+            "key": "migration",
+            "comment": "To use any of the available migrators, you usually need to configure credentials for the appropriate service and enable it. Find instructions below on how to do this for the provided migrators.",
+            "children": [
+                {
+                    "key": "todoist",
+                    "children": [
+                        {
+                            "key": "enable",
+                            "default_value": "false",
+                            "comment": "Wheter to enable the Todoist migrator."
+                        },
+                        {
+                            "key": "clientid",
+                            "default_value": "",
+                            "comment": "The client id, required for making requests to the Todoist api\nYou need to register your Vikunja instance at https://developer.todoist.com/appconsole.html to get this."
+                        },
+                        {
+                            "key": "clientsecret",
+                            "default_value": "",
+                            "comment": "The client secret, also required for making requests to the Todoist api. Obtain it at https://developer.todoist.com/appconsole.html after registering your Vikunja instance."
+                        },
+                        {
+                            "key": "redirecturl",
+                            "default_value": "\u003cservice.publicurl\u003e/migrate/todoist",
+                            "comment": "The url where clients are redirected after they authorized Vikunja to access their Todoist items.\nIn Todoist, this is called `OAuth redirect URL` and it needs to match the url you entered when registering\nyour Vikunja instance at the Todoist developer console.\nWhen using the official Vikunja frontend, set this to `\u003cservice.publicurl\u003e/migrate/todoist` (the default value).\nOtherwise, set this to an url which then makes a request to /api/v1/migration/todoist/migrate\nwith the code obtained from the Todoist api."
+                        }
+                    ]
+                },
+                {
+                    "key": "trello",
+                    "children": [
+                        {
+                            "key": "enable",
+                            "default_value": "false",
+                            "comment": "Whether to enable the Trello migrator."
+                        },
+                        {
+                            "key": "key",
+                            "default_value": "",
+                            "comment": "The client id, required for making requests to the trello api.\nYou need to register your Vikunja instance at https://trello.com/app-key (log in before you visit that link) to get one. Copy the `Personal Key` and set it as the client id. Add your Vikunja domain to the Allowed Origins list."
+                        },
+                        {
+                            "key": "redirecturl",
+                            "default_value": "\u003cfrontend url\u003e/migrate/trello",
+                            "comment": "The url where clients are redirected after they authorized Vikunja to access their trello cards.\nThis needs to match the url you entered when registering your Vikunja instance at trello.\nWhen using the official Vikunja frontend, set this to `\u003cservice.publicurl\u003e/migrate/trello` (the default value).\nOtherwise, set this to an url which then makes a request to /api/v1/migration/trello/migrate\nwith the code obtained from the Trello api."
+                        }
+                    ]
+                },
+                {
+                    "key": "microsofttodo",
+                    "children": [
+                        {
+                            "key": "enable",
+                            "default_value": "false",
+                            "comment": "Wheter to enable the Microsoft Todo migrator."
+                        },
+                        {
+                            "key": "clientid",
+                            "default_value": "",
+                            "comment": "The client id, required for making requests to the Microsoft graph api.\nSee https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app#register-an-application\nfor information about how to register your Vikunja instance."
+                        },
+                        {
+                            "key": "clientsecret",
+                            "default_value": "",
+                            "comment": "The client secret, also required for making requests to the Microsoft graph api"
+                        },
+                        {
+                            "key": "redirecturl",
+                            "default_value": "\u003cfrontend url\u003e/migrate/microsoft-todo",
+                            "comment": "The url where clients are redirected after they authorized Vikunja to access their Microsoft todo tasks.\nThis needs to match the url you entered when registering your Vikunja instance at Microsoft.\nWhen using the official Vikunja frontend, set this to `\u003cservice.publicurl\u003e/migrate/microsoft-todo` (the default value).\nOtherwise, set this to an url which then makes a request to /api/v1/migration/microsoft-todo/migrate\nwith the code obtained from the Microsoft Todo api."
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "key": "avatar",
+            "children": [
+                {
+                    "key": "gravatarexpiration",
+                    "default_value": "3600",
+                    "comment": "When using gravatar, this is the duration in seconds until a cached gravatar user avatar expires"
+                }
+            ]
+        },
+        {
+            "key": "backgrounds",
+            "children": [
+                {
+                    "key": "enabled",
+                    "default_value": "true",
+                    "comment": "Whether to enable backgrounds for projects at all."
+                },
+                {
+                    "key": "providers",
+                    "children": [
+                        {
+                            "key": "upload",
+                            "children": [
+                                {
+                                    "key": "enabled",
+                                    "default_value": "true",
+                                    "comment": "Whether to enable uploaded project backgrounds"
+                                }
+                            ]
+                        },
+                        {
+                            "key": "unsplash",
+                            "children": [
+                                {
+                                    "key": "enabled",
+                                    "default_value": "false",
+                                    "comment": "Whether to enable setting backgrounds from unsplash as project backgrounds"
+                                },
+                                {
+                                    "key": "accesstoken",
+                                    "default_value": "",
+                                    "comment": "You need to create an application for your installation at https://unsplash.com/oauth/applications/new\nand set the access token below."
+                                },
+                                {
+                                    "key": "applicationid",
+                                    "default_value": "",
+                                    "comment": "The unsplash application id is only used for pingback and required as per their api guidelines.\nYou can find the Application ID in the dashboard for your API application. It should be a numeric ID.\nIt will only show in the UI if your application has been approved for Enterprise usage, therefore if\nyou’re in Demo mode, you can also find the ID in the URL at the end: https://unsplash.com/oauth/applications/:application_id"
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "key": "legal",
+            "comment": "Legal urls\nWill be shown in the frontend if configured here",
+            "children": [
+                {
+                    "key": "imprinturl",
+                    "default_value": ""
+                },
+                {
+                    "key": "privacyurl",
+                    "default_value": ""
+                }
+            ]
+        },
+        {
+            "key": "keyvalue",
+            "comment": "Key Value Storage settings\nThe Key Value Storage is used for different kinds of things like metrics and a few cache systems.",
+            "children": [
+                {
+                    "key": "type",
+                    "default_value": "memory",
+                    "comment": "The type of the storage backend. Can be either \"memory\" or \"redis\". If \"redis\" is chosen it needs to be configured separately."
+                }
+            ]
+        },
+        {
+            "key": "auth",
+            "children": [
+                {
+                    "key": "local",
+                    "comment": "Local authentication will let users log in and register (if enabled) through the db.\nThis is the default auth mechanism and does not require any additional configuration.",
+                    "children": [
+                        {
+                            "key": "enabled",
+                            "default_value": "true",
+                            "comment": "Enable or disable local authentication"
+                        }
+                    ]
+                },
+                {
+                    "key": "openid",
+                    "comment": "OpenID configuration will allow users to authenticate through a third-party OpenID Connect compatible provider.\u003cbr/\u003e\nThe provider needs to support the `openid`, `profile` and `email` scopes.\u003cbr/\u003e\n**Note:** Some openid providers (like Gitlab) only make the email of the user available through OpenID if they have set it to be publicly visible.\nIf the email is not public in those cases, authenticating will fail.\u003cbr/\u003e\n**Note 2:** The frontend expects the third party to redirect the user \u003cfrontend-url\u003e/auth/openid/\u003cauth key\u003e after authentication. Please make sure to configure the redirect url in your third party auth service accordingly if you're using the default Vikunja frontend.\nThe frontend will automatically provide the API with the redirect url, composed from the current url where it's hosted.\nIf you want to use the desktop client with OpenID, make sure to allow redirects to `127.0.0.1`.",
+                    "children": [
+                        {
+                            "key": "enabled",
+                            "default_value": "false",
+                            "comment": "Enable or disable OpenID Connect authentication"
+                        },
+                        {
+                            "key": "providers",
+                            "comment": "A list of enabled providers. You can freely choose the `<provider key>`. Note that you must add at least one key to a config file if you want to read values from an environment variable as the provider won't be known to Vikunja otherwise.",
+                            "children": [
+                                {
+                                    "key": "<provider key>",
+                                    "children": [
+                                        {
+                                            "key": "name",
+                                            "default_value": "",
+                                            "comment": "The name of the provider as it will appear in the frontend."
+                                        },
+                                        {
+                                            "key": "authurl",
+                                            "default_value": "",
+                                            "comment": "The auth url to send users to if they want to authenticate using OpenID Connect."
+                                        },
+                                        {
+                                            "key": "logouturl",
+                                            "default_value": "",
+                                            "comment": "The oidc logouturl that users will be redirected to on logout.\nLeave empty or delete key, if you do not want to be redirected."
+                                        },
+                                        {
+                                            "key": "clientid",
+                                            "default_value": "",
+                                            "comment": "The client ID used to authenticate Vikunja at the OpenID Connect provider."
+                                        },
+                                        {
+                                            "key": "clientsecret",
+                                            "default_value": "",
+                                            "comment": "The client secret used to authenticate Vikunja at the OpenID Connect provider."
+                                        },
+                                        {
+                                            "key": "scope",
+                                            "default_value": "openid email profile",
+                                            "comment": "The scope necessary to use oidc.\nIf you want to use the Feature to create and assign to Vikunja teams via oidc, you have to add the custom \"vikunja_scope\" and check [openid.md](https://vikunja.io/docs/openid/).\ne.g. scope: openid email profile vikunja_scope"
+                                        }
+                                    ]
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "key": "metrics",
+            "comment": "Prometheus metrics endpoint",
+            "children": [
+                {
+                    "key": "enabled",
+                    "default_value": "false",
+                    "comment": "If set to true, enables a /metrics endpoint for prometheus to collect metrics about Vikunja. You can query it from `/api/v1/metrics`."
+                },
+                {
+                    "key": "username",
+                    "default_value": "",
+                    "comment": "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."
+                },
+                {
+                    "key": "password",
+                    "default_value": "",
+                    "comment": "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."
+                }
+            ]
+        },
+        {
+            "key": "defaultsettings",
+            "comment": "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.",
+            "children": [
+                {
+                    "key": "avatar_provider",
+                    "default_value": "initials",
+                    "comment": "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`."
+                },
+                {
+                    "key": "avatar_file_id",
+                    "default_value": "0",
+                    "comment": "The id of the file used as avatar."
+                },
+                {
+                    "key": "email_reminders_enabled",
+                    "default_value": "false",
+                    "comment": "If set to true users will get task reminders via email."
+                },
+                {
+                    "key": "discoverable_by_name",
+                    "default_value": "false",
+                    "comment": "If set to true will allow other users to find this user when searching for parts of their name."
+                },
+                {
+                    "key": "discoverable_by_email",
+                    "default_value": "false",
+                    "comment": "If set to true will allow other users to find this user when searching for their exact email."
+                },
+                {
+                    "key": "overdue_tasks_reminders_enabled",
+                    "default_value": "true",
+                    "comment": "If set to true will send an email every day with all overdue tasks at a configured time."
+                },
+                {
+                    "key": "overdue_tasks_reminders_time",
+                    "default_value": "9:00",
+                    "comment": "When to send the overdue task reminder email."
+                },
+                {
+                    "key": "default_project_id",
+                    "default_value": "0",
+                    "comment": "The id of the default project. Make sure users actually have access to this project when setting this value."
+                },
+                {
+                    "key": "week_start",
+                    "default_value": "0",
+                    "comment": "Start of the week for the user. `0` is sunday, `1` is monday and so on."
+                },
+                {
+                    "key": "language",
+                    "default_value": "\u003cunset\u003e",
+                    "comment": "The language of the user interface. Must be an ISO 639-1 language code followed by an ISO 3166-1 alpha-2 country code. Check https://kolaente.dev/vikunja/vikunja/frontend/src/branch/main/src/i18n/lang for a list of possible languages. Will default to the browser language the user uses when signing up."
+                },
+                {
+                    "key": "timezone",
+                    "default_value": "\u003ctime zone set at service.timezone\u003e",
+                    "comment": "The time zone of each individual user. This will affect when users get reminders and overdue task emails."
+                }
+            ]
+        },
+        {
+            "key": "webhooks",
+            "children": [
+                {
+                    "key": "enabled",
+                    "default_value": "true",
+                    "comment": "Whether to enable support for webhooks"
+                },
+                {
+                    "key": "timeoutseconds",
+                    "default_value": "30",
+                    "comment": "The timeout in seconds until a webhook request fails when no response has been received."
+                },
+                {
+                    "key": "proxyurl",
+                    "default_value": "",
+                    "comment": "The URL of [a mole instance](https://github.com/frain-dev/mole) to use to proxy outgoing webhook requests. You should use this and configure appropriately if you're not the only one using your Vikunja instance. More info about why: https://webhooks.fyi/best-practices/webhook-providers#implement-security-on-egress-communication. Must be used in combination with `webhooks.password` (see below)."
+                },
+                {
+                    "key": "proxypassword",
+                    "default_value": "",
+                    "comment": "The proxy password to use when authenticating against the proxy."
+                }
+            ]
+        },
+        {
+            "key": "autotls",
+            "children": [
+                {
+                    "key": "enabled",
+                    "default_value": "false",
+                    "comment": "If set to true, Vikunja will automatically request a TLS certificate from Let's Encrypt and use it to serve Vikunja over TLS. By enabling this option, you agree to Let's Encrypt's TOS.\nYou must configure a `service.publicurl` with a valid TLD where Vikunja is reachable to make this work. Furthermore, it is reccomened to set `service.interface` to `:443` if you're using this."
+                },
+                {
+                    "key": "email",
+                    "default_value": "",
+                    "comment": "A valid email address which will be used to register certificates with Let's Encrypt. You must provide this value in order to use autotls."
+                },
+                {
+                    "key": "renewbefore",
+                    "default_value": "30d",
+                    "comment": "A duration when certificates should be renewed before they expire. Valid time units are `ns`, `us` (or `µs`), `ms`, `s`, `m`, `h`."
+                }
+            ]
+        }
+    ]
+}

config.yml.sample

@@ -1,373 +0,0 @@
-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 issued 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 public facing URL where your users can reach Vikunja. Used in emails and for the communication between api and frontend.
-  publicurl: ""
-  # 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>
-  # 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 project 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, 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 needs 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
-  # If set to true, the frontend will show a big red warning not to use this instance for real data as it will be cleared out.
-  # You probably don't need to set this value, it was created specifically for usage on [try](https://try.vikunja.io).
-  demomode: false
-  # Allow changing the logo and other icons based on various occasions throughout the year.
-  allowiconchanges: true
-  # Allow using a custom logo via external URL.
-  customlogourl: ''
-
-sentry:
-  # If set to true, enables anonymous error tracking of api errors via Sentry. This allows us to gather more 
-  # information about errors in order to debug and fix it.
-  enabled: false
-  # Configure the Sentry dsn used for api error tracking. Only used when Sentry is enabled for the api.
-  dsn: "https://440eedc957d545a795c17bbaf477497c@o1047380.ingest.sentry.io/4504254983634944"
-  # If set to true, enables anonymous error tracking of frontend errors via Sentry. This allows us to gather more 
-  # information about errors in order to debug and fix it.
-  frontendenabled: false
-  # Configure the Sentry dsn used for frontend error tracking. Only used when Sentry is enabled for the frontend.
-  frontenddsn: "https://85694a2d757547cbbc90cd4b55c5a18d@o1047380.ingest.sentry.io/6024480"
-
-database:
-  # Database type to use. Supported values are mysql, postgres and sqlite. Vikunja is able to run with MySQL 8.0+, Mariadb 10.2+, PostgreSQL 12+, 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 milliseconds.
-  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
-
-typesense:
-  # Whether to enable the Typesense integration. If true, all tasks will be synced to the configured Typesense
-  # instance and all search and filtering will run through Typesense instead of only through the database.
-  # Typesense allows fast fulltext search including fuzzy matching support. It may return different results than
-  # what you'd get with a database-only search.
-  enabled: false
-  # The url to the Typesense instance you want to use. Can be hosted locally or in Typesense Cloud as long
-  # as Vikunja is able to reach it.
-  url: ''
-  # The Typesense API key you want to use.
-  apikey: ''
-
-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 authenticate 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 separate 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: false
-  # 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"
-  # Whether or not to log mail log messages. This will not log mail contents. Possible values are stdout, stderr, file or off to disable mail-related logging.
-  mail: "off"
-  # The log level for mail log messages. Possible values (case-insensitive) are ERROR, WARNING, INFO, DEBUG.
-  maillevel: "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
-  # The number of requests a user can make from the same IP to all unauthenticated routes (login, register,
-  # password confirmation, email verification, password reset request) per minute. This limit cannot be disabled.
-  # You should only change this if you know what you're doing.
-  noauthlimit: 10
-
-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:
-    # Whether 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 Vikunja 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 projects at all.
-  enabled: true
-  providers:
-    upload:
-      # Whether to enable uploaded project backgrounds
-      enabled: true
-    unsplash:
-      # Whether to enable setting backgrounds from unsplash as project 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 separately.
-  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 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 the third party to rediect the user <frontend-url>/auth/openid/<auth key> after authentication. Please make sure to configure the redirect url in your third party auth service accordingly if you're using the default vikunja frontend.
-  # The frontend will automatically provide the API with the redirect url, composed from the current url where it's hosted.
-  # If you want to use the desktop client with OpenID, make sure to allow redirects to `127.0.0.1`.
-  # Take a look at the [default config file](https://kolaente.dev/vikunja/vikunja/src/branch/main/config.yml.sample) for more information about how to configure openid authentication.
-  openid:
-    # Enable or disable OpenID Connect authentication
-    enabled: false
-    # 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:
-        # The scope necessary to use oidc.
-        # If you want to use the Feature to create and assign to vikunja teams via oidc, you have to add the custom "vikunja_scope" and check [openid.md](https://vikunja.io/docs/openid/).
-        # e.g. scope: openid email profile vikunja_scope
-        scope: openid email profile
-
-# Prometheus metrics endpoint
-metrics:
-  # If set to true, enables a /metrics endpoint for prometheus to collect metrics about Vikunja. You can query it from `/api/v1/metrics`.
-  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 project. Make sure users actually have access to this project when setting this value.
-  default_project_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 followed by an ISO 3166-1 alpha-2 country code. Check https://kolaente.dev/vikunja/vikunja/frontend/src/branch/main/src/i18n/lang for a list of possible languages. 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>
-
-webhooks:
-  # Whether to enable support for webhooks
-  enabled: true
-  # The timout in seconds until a webhook request fails when no response has been received.
-  timoutseconds: 30
-  # The URL of [a mole instance](https://github.com/frain-dev/mole) to use to proxy outgoing webhook requests. You should use this and configure appropriately if you're not the only one using your Vikunja instance. More info about why: https://webhooks.fyi/best-practices/webhook-providers#implement-security-on-egress-communication. Must be used in combination with `webhooks.password` (see below).
-  proxyurl:
-  # The proxy password to use when authenticating against the proxy.
-  proxypassword:

desktop/default.nix

@@ -1,9 +0,0 @@
-{ pkgs ? import <nixpkgs> {}
-}:
-pkgs.mkShell {
-  name="electron-dev";
-  buildInputs = [
-    pkgs.electron
-  ];
-}
-

desktop/package.json

@@ -51,11 +51,11 @@
     }
   },
   "devDependencies": {
-    "electron": "29.1.0",
-    "electron-builder": "24.13.3"
+    "electron": "33.2.0",
+    "electron-builder": "25.1.8"
   },
   "dependencies": {
     "connect-history-api-fallback": "2.0.0",
-    "express": "4.18.3"
+    "express": "4.21.1"
   }
 }

devenv.lock

@@ -0,0 +1,132 @@
+{
+  "nodes": {
+    "devenv": {
+      "locked": {
+        "dir": "src/modules",
+        "lastModified": 1730028891,
+        "owner": "cachix",
+        "repo": "devenv",
+        "rev": "a337f8862efa9bde348c48a48b5b943f710604dd",
+        "type": "github"
+      },
+      "original": {
+        "dir": "src/modules",
+        "owner": "cachix",
+        "repo": "devenv",
+        "type": "github"
+      }
+    },
+    "flake-compat": {
+      "flake": false,
+      "locked": {
+        "lastModified": 1696426674,
+        "owner": "edolstra",
+        "repo": "flake-compat",
+        "rev": "0f9255e01c2351cc7d116c072cb317785dd33b33",
+        "type": "github"
+      },
+      "original": {
+        "owner": "edolstra",
+        "repo": "flake-compat",
+        "type": "github"
+      }
+    },
+    "gitignore": {
+      "inputs": {
+        "nixpkgs": [
+          "pre-commit-hooks",
+          "nixpkgs"
+        ]
+      },
+      "locked": {
+        "lastModified": 1709087332,
+        "owner": "hercules-ci",
+        "repo": "gitignore.nix",
+        "rev": "637db329424fd7e46cf4185293b9cc8c88c95394",
+        "type": "github"
+      },
+      "original": {
+        "owner": "hercules-ci",
+        "repo": "gitignore.nix",
+        "type": "github"
+      }
+    },
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1716977621,
+        "owner": "cachix",
+        "repo": "devenv-nixpkgs",
+        "rev": "4267e705586473d3e5c8d50299e71503f16a6fb6",
+        "type": "github"
+      },
+      "original": {
+        "owner": "cachix",
+        "ref": "rolling",
+        "repo": "devenv-nixpkgs",
+        "type": "github"
+      }
+    },
+    "nixpkgs-stable": {
+      "locked": {
+        "lastModified": 1729973466,
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "cd3e8833d70618c4eea8df06f95b364b016d4950",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixos-24.05",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "nixpkgs-unstable": {
+      "locked": {
+        "lastModified": 1729880355,
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "18536bf04cd71abd345f9579158841376fdd0c5a",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixos-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "pre-commit-hooks": {
+      "inputs": {
+        "flake-compat": "flake-compat",
+        "gitignore": "gitignore",
+        "nixpkgs": [
+          "nixpkgs"
+        ],
+        "nixpkgs-stable": "nixpkgs-stable"
+      },
+      "locked": {
+        "lastModified": 1729104314,
+        "owner": "cachix",
+        "repo": "pre-commit-hooks.nix",
+        "rev": "3c3e88f0f544d6bb54329832616af7eb971b6be6",
+        "type": "github"
+      },
+      "original": {
+        "owner": "cachix",
+        "repo": "pre-commit-hooks.nix",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "devenv": "devenv",
+        "nixpkgs": "nixpkgs",
+        "nixpkgs-unstable": "nixpkgs-unstable",
+        "pre-commit-hooks": "pre-commit-hooks"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}

devenv.nix

@@ -0,0 +1,38 @@
+{ pkgs, lib, config, inputs, ... }:
+
+let
+  pkgs-unstable = import inputs.nixpkgs-unstable { system = pkgs.stdenv.system; };
+in {
+  packages = with pkgs-unstable; [
+    # General tools
+    git-cliff 
+    # API tools
+    golangci-lint mage
+    # Desktop
+    electron
+  ] ++ lib.optionals (!pkgs.stdenv.isDarwin) [
+    # Frontend tools (exclude on Darwin)
+    cypress
+  ];
+  
+  languages = {
+    javascript = {
+      enable = true;
+      package = pkgs-unstable.nodejs-slim;
+      pnpm = {
+        enable = true;
+        package = pkgs-unstable.pnpm;
+      };
+    };
+    
+    go = {
+      enable = true;
+      enableHardeningWorkaround = true;
+    };
+  };
+  
+  services.mailpit = {
+    enable = true;
+    package = pkgs-unstable.mailpit;
+  };
+}

devenv.yaml

@@ -0,0 +1,17 @@
+# yaml-language-server: $schema=https://devenv.sh/devenv.schema.json
+inputs:
+  nixpkgs:
+    url: github:cachix/devenv-nixpkgs/rolling
+  nixpkgs-unstable:
+    url: github:NixOS/nixpkgs/nixos-unstable
+
+# If you're using non-OSS software, you can set allowUnfree to true.
+allowUnfree: true
+
+# If you're willing to use a package that's vulnerable
+# permittedInsecurePackages:
+#  - "openssl-1.1.1w"
+
+# If you have more than one devenv you can merge them
+#imports:
+# - ./backend

docs/Dockerfile

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

docs/config.yml

@@ -1,63 +0,0 @@
-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/
-      weight: 10
-    - name: Features
-      url: https://vikunja.io/features
-      weight: 20
-    - name: Download
-      url: https://vikunja.io/download
-      weight: 30
-    - name: Blog
-      url: https://vikunja.io/blog/
-      weight: 35
-    - 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: Stickers
-      url: https://vikunja.cloud/stickers?utm_source=io&utm_medium=io&utm_campaign=menu
-      weight: 65
-    - name: Get it Hosted
-      url: https://vikunja.cloud/?utm_source=io&utm_medium=io&utm_campaign=menu
-      weight: 70
-  sidebar:
-    - name: setup
-      weight: 10
-    - name: usage
-      weight: 20
-    - name: development
-      weight: 30

docs/content/doc/_index.md

@@ -1,25 +0,0 @@
----
-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

@@ -1,34 +0,0 @@
----
-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 information about how to use flags etc.
-
-To add a new cli command, add something like the following:
-
-```go
-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
-	},
-}
-```

docs/content/doc/development/config.md

@@ -1,41 +0,0 @@
----
-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 retrieve a configured value call the key with a getter for the type you need.
-For example:
-
-```go
-if config.CacheEnabled.GetBool() {
-	// Do something with enabled caches
-}
-```
-
-Take a look at the methods declared on the type to see what's available.

docs/content/doc/development/cron.md

@@ -1,33 +0,0 @@
----
-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:
-
-```go
-func RegisterSomeCronTask() {
-	err := cron.Schedule("0 * * * *", func() {
-		// Do something every hour
-	}
-}
-```
-
-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

@@ -1,38 +0,0 @@
----
-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

@@ -1,78 +0,0 @@
----
-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:
-
-```
-date +%Y%m%d%H%M%S
-```
-
-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
-
-```go
-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{})
-		},
-	})
-}
-```
-
-You should always copy the changed parts of the struct you're changing when adding migrations.

docs/content/doc/development/development.md

@@ -1,97 +0,0 @@
----
-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 [on our Gitea instance](https://kolaente.dev/vikunja).
-We cannot accept PRs on mirror sites.
-
-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.
-
-The main repo is [`vikunja/vikunja`](https://kolaente.dev/vikunja/vikunja), it contains all code for the api, frontend and desktop applications.
-
-## API
-
-You'll need at least Go 1.21 to build Vikunja's api.
-
-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 in the `frontend` sub folder of the main repo.
-More instructions can be found in the repo's README.
-
-You need to have [pnpm](https://pnpm.io/) and Node.JS in version 20 or higher installed.
-
-## Pull Requests
-
-All Pull Requests must be made [on our Gitea instance](https://kolaente.dev/vikunja).
-We cannot accept PRs on mirror sites.
-
-Please try to make your pull request easy to review.
-For that, please read the [*Best Practices for Faster Reviews*](https://github.com/kubernetes/community/blob/261cb0fd089b64002c91e8eddceebf032462ccd6/contributors/guide/pull-requests.md#best-practices-for-faster-reviews) guide.
-It has lots of useful tips for any project you may want to contribute to.
-Some of the key points:
-
-- Make small pull requests.
-  The smaller, the faster to review and the more likely it will be merged soon.
-- Don't make changes unrelated to your PR.
-  Maybe there are typos on some comments, maybe refactoring would be welcome on a function…
-  but if that is not related to your PR, please make *another* PR for that.
-- Split big pull requests into multiple small ones.
-  An incremental change will be faster to review than a huge PR.
-- Allow edits by maintainers. This way, the maintainers will take care of merging the PR later on instead of you.
-
-### PR title and summary
-
-In the PR title, describe the problem you are fixing, not how you are fixing it.
-Use the first comment as a summary of your PR.
-In the PR summary, you can describe exactly how you are fixing this problem.
-Keep this summary up-to-date as the PR evolves.
-
-If your PR changes the UI, you must add **after** screenshots in the PR summary.
-If your PR closes an issue, you must note that in a way that both GitHub and Gitea understand, i.e. by appending a paragraph like
-
-```text
-Fixes/Closes/Resolves #<ISSUE_NR_X>.
-Fixes/Closes/Resolves #<ISSUE_NR_Y>.
-```
-
-to your summary.
-Each issue that will be closed must stand on a separate line.
-
-If your PR is related to a discussion in the forum, you must add a link to the forum discussion.
-
-### Git flow
-
-The `main` branch is the latest and bleeding edge branch with all changes. Unstable releases are automatically created from this branch.
-New Pull-Requests should be made against the `main` 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 simplify generating release notes a lot.
-
-It is not required to use them when creating a PR, but appreciated.

docs/content/doc/development/errors.md

@@ -1,72 +0,0 @@
----
-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:
-
-```go
-// This struct holds any information about this specific error.
-// In this case, it contains the user ID of a nonexistent 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 
-//   project 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 deprecated 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.",
-    }
-}
-```

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

@@ -1,211 +0,0 @@
----
-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:
-
-```go
-type Event interface {
-    Name() string
-}
-```
-
-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 specific 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:
-
-```go
-// 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"
-}
-```
-
-It is dispatched in the `createTask` function of the `models` package:
-
-```go
-func createTask(s *xorm.Session, t *Task, a web.Auth, updateAssignees bool) (err error) {
-
-    // ...
-    
-    err = events.Dispatch(&TaskCreatedEvent{
-        Task: t,
-        Doer: a,
-    })
-    
-    // ...
-}
-```
-
-As you can see, the current 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:
-
-```go
-// Listener represents something that listens to events
-type Listener interface {
-    Handle(msg *message.Message) error
-    Name() string
-}
-```
-
-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 exponential 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>/listeners.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>/listeners.go` which is called at start up.
-
-The listener will never be executed if it hasn't been registered.
-
-See the example below.
-
-### Example
-
-```go
-// 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"
-}
-
-// Handle 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)
-}
-```
-
-## 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:
-
-```go
-events.AssertDispatched(t, &TaskCreatedEvent{})
-```
-
-### Testing a listener
-
-You can call an event listener manually with the `events.TestListener` method like so:
-
-```go
-ev := &TaskCommentCreatedEvent{
-	Task:    &task,
-	Doer:    u,
-	Comment: tc,
-}
-
-events.TestListener(t, ev, &SendTaskCommentNotification{})
-```
-
-This will call the listener's `Handle` method and assert it did not return an error when calling.

docs/content/doc/development/feature.md

@@ -1,33 +0,0 @@
----
-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:
-
-```go
-projects := []*Project{}
-err := x.Limit(getLimitFromPageIndex(pageIndex, itemsPerPage)).Find(&projects)
-```
-
-// 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

@@ -1,174 +0,0 @@
----
-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 lint`
-* `mage build:build`
-
-## Build
-
-### Build Vikunja
-
-```
-mage build
-```
-
-Builds a `vikunja`-binary in the root directory of the repo for the platform it is run on.
-
-### clean
-
-```
-mage build:clean
-```
-
-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 golangci and swagger documentation check
-* `mage lint`: Checks if the code follows the rules as defined in the `.golangci.yml` config file.
-* `mage lint:fix`: Fixes all code style issues which are easily fixable.
-
-## Release
-
-### Build Releases
-
-```
-mage release
-```
-
-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` packages a zip file for the files created by `release:os-package`
-
-### Build os packages
-
-```
-mage release:packages
-```
-
-Will build `.deb`, `.rpm` and `.apk` packages to `dist/os-packages`.
-
-### Make a debian repo
-
-```
-mage release:reprepro
-```
-
-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
-
-```
-mage test:unit
-```
-
-Runs all tests except integration tests.
-
-### coverage
-
-```
-mage test:coverage
-```
-
-Runs all tests except integration tests and generates a `coverage.html` file to inspect the code coverage.
-
-### integration
-
-```
-mage test:integration
-```
-
-Runs all integration tests.
-
-## Dev
-
-### Create a new migration 
-
-```
-mage dev:create-migration
-```
-
-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
-
-```
-mage fmt
-```
-
-Formats all source code using `go fmt`.
-
-### Generate swagger definitions from code comments
-
-```
-mage do-the-swag
-```
-
-Generates swagger definitions from the comment annotations in the code.

docs/content/doc/development/metrics.md

@@ -1,47 +0,0 @@
----
-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:
-
-```go
-// 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)
-})
-```
-
-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 change 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

@@ -1,131 +0,0 @@
----
-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 projects, 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, projects 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 project, then add projects inside that project, then tasks in the lists and so on.
-In general, it is reccommended to have one root project with all projects of the other service as child projects.
-
-The root structure must be present as `[]*models.ProjectWithTasksAndBuckets`. It allows to represent all of Vikunja's hierarchy as a single data structure.
-
-Then call the method like so:
-
-```go
-fullVikunjaHierarchy, err := convertWunderlistToVikunja(wContent)
-if err != nil {
-    return
-}
-
-err = migration.InsertFromStructure(fullVikunjaHierarchy, 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

@@ -1,119 +0,0 @@
----
-date: 2021-02-07T19:26:34+02:00
-title: "Notifications"
-toc: true
-draft: false
-menu:
-  sidebar:
-    parent: "development"
----
-
-# Notifications
-
-Vikunja provides a simple abstraction to send notifications per mail and in the database.
-
-{{< table_of_contents >}}
-
-## Definition
-
-Each notification has to implement this interface:
-
-```go
-type Notification interface {
-    ToMail() *Mail
-    ToDB() interface{}
-    Name() string
-}
-```
-
-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:
-
-```go
-mail := NewMail(). 
-    // The optional sender of the mail message.
-    From("test@example.com").
-	// The optional recipient 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 appear 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").
-```
-
-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:
-
-```go
-type Notifiable interface {
-    // Should return the email address this notifiable has.
-    RouteForMail() string
-    // Should return the id of the notifiable entity
-    RouteForDB() int64
-}
-```
-
-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:
-
-```go
-n := &EmailConfirmNotification{
-    User:  update.User,
-    IsNew: false,
-}
-
-err = notifications.Notify(update.User, n)
-return
-```
-
-## 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:
-
-```go
-notifications.AssertSent(t, &ReminderDueNotification{})
-```
-
-## 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

@@ -1,33 +0,0 @@
----
-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 happened so that it now looks different from the existing screenshot, a new one is required.
-* Generate changelogs (with git-cliff)
-* Tag a new version: Include the changelog for that version as the tag message
-	* Once built: Prune the cloudflare cache so that the new versions show up at [dl.vikunja.io](https://dl.vikunja.io/)
-    * Update the [Flathub desktop package](https://github.com/flathub/io.vikunja.Vikunja)
-* 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 mentioning.
-* 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

@@ -1,170 +0,0 @@
----
-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 different 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 project 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 initialization 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 purpose 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 separate package to avoid import cycles with other packages.

docs/content/doc/development/swagger-docs.md

@@ -1,96 +0,0 @@
----
-date: "2019-02-12:00:00+02:00"
-title: "Modifying Swagger API Docs"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "development"
----
-
-# Modifying swagger api docs
-
-The api documentation is generated using [swaggo](https://github.com/swaggo/swag) from comments.
-
-{{< table_of_contents >}}
-
-## Documenting structs
-
-You should always comment every field which will be exposed as a json in the api.
-These comments will show up in the documentation, it'll make it easier for developers using the api.
-
-As an example, this is the definition of a project with all comments:
-
-```go
-type Project struct {
-	// The unique, numeric id of this project.
-	ID int64 `xorm:"bigint autoincr not null unique pk" json:"id" param:"project"`
-	// The title of the project. You'll see this in the overview.
-	Title string `xorm:"varchar(250) not null" json:"title" valid:"required,runelength(1|250)" minLength:"1" maxLength:"250"`
-	// The description of the project.
-	Description string `xorm:"longtext null" json:"description"`
-	// The unique project short identifier. Used to build task identifiers.
-	Identifier string `xorm:"varchar(10) null" json:"identifier" valid:"runelength(0|10)" minLength:"0" maxLength:"10"`
-	// The hex color of this project
-	HexColor string `xorm:"varchar(6) null" json:"hex_color" valid:"runelength(0|6)" maxLength:"6"`
-
-	OwnerID         int64    `xorm:"bigint INDEX not null" json:"-"`
-	ParentProjectID int64    `xorm:"bigint INDEX null" json:"parent_project_id"`
-	ParentProject   *Project `xorm:"-" json:"-"`
-
-	// The user who created this project.
-	Owner *user.User `xorm:"-" json:"owner" valid:"-"`
-
-	// Whether a project is archived.
-	IsArchived bool `xorm:"not null default false" json:"is_archived" query:"is_archived"`
-
-	// The id of the file this project has set as background
-	BackgroundFileID int64 `xorm:"null" json:"-"`
-	// Holds extra information about the background set since some background providers require attribution or similar. If not null, the background can be accessed at /projects/{projectID}/background
-	BackgroundInformation interface{} `xorm:"-" json:"background_information"`
-	// Contains a very small version of the project background to use as a blurry preview until the actual background is loaded. Check out https://blurha.sh/ to learn how it works.
-	BackgroundBlurHash string `xorm:"varchar(50) null" json:"background_blur_hash"`
-
-	// True if a project is a favorite. Favorite projects show up in a separate parent project. This value depends on the user making the call to the api.
-	IsFavorite bool `xorm:"-" json:"is_favorite"`
-
-	// The subscription status for the user reading this project. You can only read this property, use the subscription endpoints to modify it.
-	// Will only returned when retrieving one project.
-	Subscription *Subscription `xorm:"-" json:"subscription,omitempty"`
-
-	// The position this project has when querying all projects. See the tasks.position property on how to use this.
-	Position float64 `xorm:"double null" json:"position"`
-
-	// A timestamp when this project was created. You cannot change this value.
-	Created time.Time `xorm:"created not null" json:"created"`
-	// A timestamp when this project was last updated. You cannot change this value.
-	Updated time.Time `xorm:"updated not null" json:"updated"`
-
-	web.CRUDable `xorm:"-" json:"-"`
-	web.Rights   `xorm:"-" json:"-"`
-}
-```
-
-## Documenting api Endpoints
-
-All api routes should be documented with a comment above the handler function.
-When generating the api docs with mage, the swagger cli will pick these up and put them in a neat document.
-
-A comment looks like this:
-
-```go
-// @Summary Login
-// @Description Logs a user in. Returns a JWT-Token to authenticate further requests.
-// @tags user
-// @Accept json
-// @Produce json
-// @Param credentials body user.Login true "The login credentials"
-// @Success 200 {object} auth.Token
-// @Failure 400 {object} models.Message "Invalid user password model."
-// @Failure 412 {object} models.Message "Invalid totp passcode."
-// @Failure 403 {object} models.Message "Invalid username or password."
-// @Router /login [post]
-func Login(c echo.Context) error {
-	// Handler logic
-}
-```

docs/content/doc/development/test.md

@@ -1,109 +0,0 @@
----
-date: "2019-02-12:00:00+02:00"
-title: "Testing"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "development"
----
-
-# Testing
-
-{{< table_of_contents >}}
-
-## API Tests
-
-The following parts are about the kinds of tests in the API package and how to run them.
-
-### Prerequesites
-
-To run any kind of test, you need to specify Vikunja's [root path](https://vikunja.io/docs/config-options/#rootpath).
-This is required to make sure all test fixtures are correctly loaded.
-
-The easies way to do that is to set the environment variable `VIKUNJA_SERVICE_ROOTPATH` to the path where you cloned the working directory.
-
-### Unit tests
-
-To run unit tests with [mage]({{< ref "mage.md">}}), execute
-
-```
-mage test:unit
-```
-
-In Vikunja, everything that is not an integration test counts as unit test - even if it accesses the db.
-This definition is a bit blurry, but we haven't found a better one yet.
-
-### Integration tests
-
-All integration tests live in `pkg/integrations`.
-You can run them by executing `mage test:integration`.
-
-The integration tests use the same config and fixtures as the unit tests and therefor have the same options available,
-see at the beginning of this document.
-
-To run integration tests, use `mage test:integration`.
-
-### Running tests with config
-
-You can run tests with all available config variables if you want, enabling you to run tests for a lot of scenarios.
-We use this in CI to run all tests with different databases.
-
-To use the normal config set the environment variable `VIKUNJA_TESTS_USE_CONFIG=1`.
-
-### Showing sql queries
-
-When the environment variable `UNIT_TESTS_VERBOSE=1` is set, all sql queries will be shown during the test run.
-
-### Fixtures
-
-All tests are run against a set of db fixtures.
-These fixtures are defined in `pkg/models/fixtures` in YAML-Files which represent the database structure.
-
-When you add a new test case which requires new database entries to test against, update these files.
-
-#### Initializing db fixtures when writing tests
-
-All db fixtures for all tests live in the `pkg/db/fixtures/` folder as yaml files.
-Each file has the same name as the table the fixtures are for.
-You should put new fixtures in this folder.
-
-When initializing db fixtures, you are responsible for defining which tables your package needs in your test init function.
-Usually, this is done as follows (this code snippet is taken from the `user` package):
-
-```go
-err = db.InitTestFixtures("users")
-if err != nil {
-	log.Fatal(err)
-}
-```
-
-In your actual tests, you then load the fixtures into the in-memory db like so:
-
-```go
-db.LoadAndAssertFixtures(t)
-```
-
-This will load all fixtures you defined in your test init method.
-You should always use this method to load fixtures, the only exception is when your package tests require extra test 
-fixtures other than db fixtures (like files).
-
-## Frontend tests
-
-The frontend has end to end tests with Cypress that use a Vikunja instance and drive a browser against it.
-Check out the docs [in the frontend repo](https://kolaente.dev/vikunja/vikunja/src/branch/main/frontend/cypress/README.md) about how they work and how to get them running.
-
-### Unit Tests
-
-To run the frontend unit tests, run
-
-```
-pnpm run test:unit
-```
-
-The frontend also has a watcher available that re-runs all unit tests every time you change something.
-To use it, simply run
-
-```
-pnpm run test:unit-watch
-```

docs/content/doc/development/translation-instructions-german.md

@@ -1,75 +0,0 @@
----
-title: "German Translation Instructions"
-date: 2021-06-23T23:47:34+02:00
-draft: false
----
-
-# German Translation Instructions
-
-<div class="notification is-warning">
-<b>NOTE:</b> This document contains translation instructions specific to the german translation of Vikunja.
-For instructions applicable to all languages, check out the <a href="{{< ref "./translations.md">}}">general translation instructions</a>.
-</div>
-
-{{< table_of_contents >}}
-
-## Allgemein
-
-Anrede: Wenig förmlich:
-
-* “Du”-Form
-* Keine “Amtsdeusch“-Umschreibungen, einfach so als ob man den Nutzer direkt persönlich ansprechen würde
-
-Genauer definiert:
-
-* “falsch” anstatt “nicht korrekt/inkorrekt”
-* “Wende dich an …” anstatt “kontaktiere …”
-* In derselben Zeit übersetzen (sonst wird aus dem englischen “is“ das deutsche “war”)
-* Richtige Anführungszeichen verwenden. Also `„“` statt `''` oder `'` oder ` oder ´
-	* `„` für beginnende Anführungszeichen, `“` für schließende Anführungszeichen
-
-Es gelten Artikel und Worttrennungen aus dem [Duden](https://duden.de).
-
-## Formulierungen
-
-* `Account` statt `Konto`.
-* `TOTP` immer als ein Wort und Groß.
-* `CalDAV` immer so.
-* `löschen` oder `entfernen` je nach Kontext. Wenn etwas *gelöscht* wird, existiert das gelöschte Objekt und danach
-  nicht mehr und hat evtl. andere Objekte mitgelöscht (z.B. eine Aufgabe). Wird etwas *entfernt*, bezieht sich das
-  meistens auf die Beziehung zu einem anderen Objekt. Das entfernte Objekt existiert danach immernoch, z.B. beim
-  Entfernen eine:r Nutzer:in aus einem Team.
-* Analog zu `löschen` oder `entfernen` gilt ähnliches für `hinzufügen` oder `erstellen`. Eine Aufgabe wird *erstellt*,
-  aber ein:e Nutzer:in nur zu einem Team *hinzugefügt*.
-* `Anmeldename` anstatt `Benutzer:innenname`
-
-## Formulierungen in Modals und Buttons
-
-Es sollten die gleichen Formulierungen auf Buttons und Modals verwendet werden.
-
-Beispiel: Wenn der Button mit `löschen` beschriftet ist, sollte im Modal die Frage
-lauten `Willst du das wirklich löschen?` und nicht `Willst du das wirklich entfernen?`. Gleiches gilt für
-Erfolgs/Fehlermeldungen nach der Aktion.
-
-## Gendern
-
-Wo möglich, sollte eine geschlechtsneutrale Anrede verwendet werden. Falls diese sehr umständlich würden (siehe oben
-„Amtsdeutsch-Umschreibungen“), soll mit *Doppelpunkt* gegendert werden.
-
-Beispiel: „Benutzer:in“
-
-## Trennungen
-
-* E-Mail-Adresse (siehe Duden)
-
-## Wörter und Ausdrücke
-
-| Englisches Original | Verwendung in deutscher Übersetzung |
-| ------------------- | -------------------- |
-| Bucket | Spalte |
-| Link Share | Linkfreigabe |
-| Username | Anmeldename |
-
-## Weiterführende Links
-
-* https://docs.translatehouse.org/projects/localization-guide/en/latest/guide/translation_guidelines_german.html

docs/content/doc/development/translations.md

@@ -1,54 +0,0 @@
----
-title: "Translations"
-date: 2021-06-23T22:52:06+02:00
-draft: false
-menu:
-  sidebar:
-    parent: "development"
----
-
-# Translations
-
-This document provides documentation about how to translate Vikunja.
-
-{{< table_of_contents >}}
-
-## Where to translate
-
-Translation happens at [crowdin](https://crowdin.com/project/vikunja).
-
-Currently, only the frontend (and by extension, the desktop app) is translatable.
-
-## Translation Instructions
-
-> These are the instructions for translating Vikunja in another language.
-> For information about how to add new translation strings, see below.
-
-For all languages these translation guidelines should be applied when translating:
-
-* Use a less-formal style, as if you were talking to a friend.
-* If the source string contains characters like `&` or `…`, the translated string should contain them as well.
-
-More specific instructions for some languages can be found below.
-
-### Wrong translation strings
-
-If you encounter a wrong original translation string while translating, please don't correct it in the translation.
-Instead, translate it to reflect the original meaning in the translated string but add a comment under the source string to discuss potential changes.
-
-### Language-specific instructions
-
-* [German]({{< ref "./translation-instructions-german.md">}})
-
-## How to add new translation strings
-
-All translation strings are stored in `src/i18n/lang/`.
-New strings should be added only in the `en.json` file.
-Strings in other languages will be synced through [crowdin](https://crowdin.com/project/vikunja) and should not be added directly as a PR/commit in the frontend repo.
-
-## Requesting a new language
-
-If you want to start translating Vikunja in a language not yet available in Vikunja, please request the language through the crowdin interface.
-If you have issues with this or need a discussion before doing so, please [contact us](https://vikunja.io/contact/) or [start a discussion in the forum](https://community.vikunja.io).
-
-Once at least 50% of all translation strings are translated and approved, they will be added and distributed with the Vikunja frontend for users to select and use Vikunja with them.

docs/content/doc/setup/backups.md

@@ -1,59 +0,0 @@
----
-date: "2019-02-12:00:00+02:00"
-title: "What to backup"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# What to backup
-
-There are two parts you need to back up: The database and attachment files.
-
-{{< table_of_contents >}}
-
-## Files
-
-To back up attachments and other files, it is enough to copy them [from the attachments folder]({{< ref "config.md" >}}#basepath) to some other place.
-
-## Database
-
-### MySQL
-
-To create a backup from mysql use the `mysqldump` command:
-
-```
-mysqldump -u <user> -p -h <db-host> <database> > vkunja-backup.sql
-```
-
-You will be prompted for the password of the mysql user.
-
-To restore it, simply pipe it back into the `mysql` command:
-
-```
-mysql -u <user> -p -h <db-host> <database> < vkunja-backup.sql
-```
-
-### PostgreSQL
-
-To create a backup from PostgreSQL use the `pg_dump` command:
-
-```
-pg_dump -U <user> -h <db-host> <database> > vikunja-backup.sql
-```
-
-You might be prompted for the password of the database user.
-
-To restore it, simply pipe it back into the `psql` command:
-
-```
-psql -U <user> -h <db-host> <database> < vikunja-backup.sql
-```
-
-For more information, please visit the [relevant PostgreSQL documentation](https://www.postgresql.org/docs/12/backup-dump.html).
-
-### SQLite
-
-To back up sqllite databases, it is enough to copy the [database file]({{< ref "config.md" >}}#path) to somewhere else.

docs/content/doc/setup/build-from-source.md

@@ -1,45 +0,0 @@
----
-date: "2022-09-21:00:00+02:00"
-title: "Build from sources"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# Build Vikunja from source
-
-To fully build Vikunja from source files, you need to build the api and frontend.
-
-{{< table_of_contents >}}
-
-## General Preparations
-
-1. Make sure you have git installed
-2. Clone the repo with `git clone https://code.vikunja.io/vikunja` and switch into the directory.
-
-## Frontend
-
-The code for the frontend is located in the `frontend/` sub folder of the main repo.
-
-1. Make sure you have [pnpm](https://pnpm.io/installation) properly installed on your system.
-2. Install all dependencies with `pnpm install`
-3. Build the frontend with `pnpm run build`. This will result in a static js bundle in the `dist/` folder.
-4. You can either deploy that static js bundle directly, or read on to learn how to bundle it all up in a static binary with the api.
-
-## API
-
-The Vikunja API has no other dependencies than go itself.
-That means compiling it boils down to these steps:
-
-1. Make sure [Go](https://golang.org/doc/install) is properly installed on your system. You'll need at least Go `1.21`.
-2. Make sure [Mage](https://magefile.org) is properly installed on your system.
-3. If you did not build the frontend in the steps before, you need to either do that or create a dummy index file with `mkdir -p frontend/dist && touch index.html`.
-4. Run `mage build` in the source of the main repo. This will build a binary in the root of the repo which will be able to run on your system.
-
-### Build for different architectures
-
-To build for other platforms and architectures than the one you're currently on, simply run `mage release` or `mage release:{linux|windows|darwin}`.
-
-More options are available, please refer to the [magefile docs]({{< ref "../development/mage.md">}}) for more details.

docs/content/doc/setup/desktop.md

@@ -1,30 +0,0 @@
----
-title: "Desktop Packages"
-date: 2024-02-11T15:58:18+01:00
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# Desktop Packages
-
-Vikunja is available as an electron-based desktop application for Linux and Windows.
-
-## Installation
-
-1. Download the latest release for your platform from [the download page](https://dl.vikunja.io/desktop/).
-  * For Windows, choose the file with the `.exe` or `.msi` file ending
-  * For a Linux-based operating system, choose a file with an ending for your operating system - we have builds for Alpine, AppImage, Arch Linux, Debian-based systems, FreeBSD, Fedora and Snap.
-2. Run the downloaded package in the same way you would normally install a package for your OS.
-
-## Flatpack
-
-Vikunja Desktop can be installed via the [Flathub](https://flathub.org/apps/io.vikunja.Vikunja).
-
-To install it, run the following command:
-
-```
-flatpak install flathub io.vikunja.Vikunja
-```

docs/content/doc/setup/docker-start-to-finish.md

@@ -1,226 +0,0 @@
----
-date: "2020-05-24:00:00+02:00"
-title: "Docker Walkthrough"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# Setup with docker from start to finish
-
-This tutorial assumes basic knowledge of docker.
-It is aimed at beginners and should get you up and running quickly.
-
-We'll use [docker compose](https://docs.docker.com/compose/) to make handling the bunch of containers easier.
-
-> If you have any issues setting up vikunja, please don't hesitate to reach out to us via [matrix](https://riot.im/app/#/room/!dCRiCiLaCCFVNlDnYs:matrix.org?via=matrix.org), the [community forum](https://community.vikunja.io/) or even [email](mailto:hello@vikunja.io).
-
-{{< table_of_contents >}}
-
-## Preparations (optional)
-
-Create a directory for the project where all data and the compose file will live in.
-
-## Create all necessary files
-
-Create a `docker-compose.yml` file with the following contents in your directory:
-
-```yaml
-version: '3'
-
-services:
-    vikunja:
-        image: vikunja/vikunja
-        environment:
-            VIKUNJA_SERVICE_PUBLICURL: http://<the public url where vikunja is reachable>
-            VIKUNJA_DATABASE_HOST: db
-            VIKUNJA_DATABASE_PASSWORD: changeme
-            VIKUNJA_DATABASE_TYPE: mysql
-            VIKUNJA_DATABASE_USER: vikunja
-            VIKUNJA_DATABASE_DATABASE: vikunja
-            VIKUNJA_SERVICE_JWTSECRET: <a super secure random secret>
-        ports:
-            - 3456:3456
-        volumes:
-            - ./files:/app/vikunja/files
-        depends_on:
-            db:
-                condition: service_healthy
-        restart: unless-stopped
-    db:
-        image: mariadb:10
-        command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
-        environment:
-            MYSQL_ROOT_PASSWORD: supersecret
-            MYSQL_USER: vikunja
-            MYSQL_PASSWORD: changeme
-            MYSQL_DATABASE: vikunja
-        volumes:
-            - ./db:/var/lib/mysql
-        restart: unless-stopped
-        healthcheck:
-            test: ["CMD-SHELL", "mysqladmin ping -h localhost -u $$MYSQL_USER --password=$$MYSQL_PASSWORD"]
-            interval: 2s
-			start_period: 30s
-```
-
-This defines two services, each with their own container:
-
-* A Vikunja service which runs the vikunja api and hosts its frontend.
-* A database container which will store all projects, tasks, etc. We're using mariadb here, but you're free to use mysql or postgres if you want.
-
-If you already have a proxy on your host, you may want to check out the [reverse proxy examples]({{< ref "reverse-proxies.md" >}}) to use that.
-By default, Vikunja will be exposed on port 3456 on the host.
-
-To change to something different, you'll need to change the `ports` section in the service definition.
-The number before the colon is the host port - This is where you can reach vikunja from the outside once all is up and running.
-
-You'll need to change the value of the `VIKUNJA_SERVICE_PUBLICURL` environment variable to the public port or hostname where Vikunja is reachable.
-
-## Ensure adequate file permissions
-
-Vikunja runs as user `1000` and no group by default.
-
-To be able to upload task attachments or change the background of project, Vikunja must be able to write into the `files` directory.
-To do this, create the folder and chown it before starting the stack:
-
-```
-mkdir $PWD/files
-chown 1000 $PWD/files
-```
-
-## Run it
-
-Run `sudo docker-compose up` in your directory and take a look at the output you get.
-When first started, Vikunja will set up the database and run all migrations etc.
-Once it is ready, you should see a message like this one in your console:
-
-```
-vikunja_1       | 2024-02-09T14:44:06.990677157+01:00: INFO       ▶ cmd/func29 05d Vikunja version 0.23.0
-vikunja_1       | ⇨ http server started on [::]:3456
-```
-
-This indicates all setup has been successful.
-If you get any errors, see below:
-
-### Troubleshooting
-
-Vikunja might not run on the first try.
-There are a few potential issues that could be causing this.
-
-#### No connection to the database
-
-Indicated by an error message like this one from the api container:
-
-```
-2020/05/23 15:37:59 Config File "config" Not Found in "[/app/vikunja /etc/vikunja /app/vikunja/.config/vikunja]"
-2020/05/23 15:37:59 Using default config.
-2020-05-23T15:37:59.974435725Z: CRITICAL	▶ migration/Migrate 002 Migration failed: dial tcp 172.19.0.2:3306: connect: connection refused
-```
-
-Especially when using mysql, this can happen on first start, because the mysql database container will take a few seconds to start.
-Vikunja does not know the container is not ready, therefore it will just try to connect to the db, fail since it is not ready and exit.
-
-If you're using the docker compose example from above, you may notice the `restart: unless-stopped` option at the api service.
-This tells docker to restart the api container if it exits, unless you explicitly stop it.
-Therefore, it should "magically fix itself" by automatically restarting the container.
-
-After a few seconds (or minutes) you should see a log message like this one from the mariadb container:
-
-```
-2020-05-24 11:42:15 0 [Note] mysqld: ready for connections.
-Version: '10.4.12-MariaDB-1:10.4.12+maria~bionic'  socket: '/var/run/mysqld/mysqld.sock'  port: 3306  mariadb.org binary distribution
-```
-
-The next restart of Vikunja should be successful.
-If not, there might be a different error or a bug with Vikunja, please reach out to us in that case.
-
-(If you have an idea about how we could improve this, we'd like to hear it!)
-
-#### Migration failed: commands out of sync
-
-If you get an error like this one:
-
-```
-2020/05/23 15:53:38 Config File "config" Not Found in "[/app/vikunja /etc/vikunja /app/vikunja/.config/vikunja]"
-2020/05/23 15:53:38 Using default config.
-2020-05-23T15:53:38.762747276Z: CRITICAL	▶ migration/Migrate 002 Migration failed: commands out of sync. Did you run multiple statements at once?
-```
-
-This is a mysql issue.
-Currently, we don't have a better solution than to completely wipe the database files and start over.
-To do this, first stop everything by running `sudo docker-compose down`, then remove the `db/` folder in your current folder with `sudo rm -rf db` and start the whole stack again with `sudo docker-compose up -d`.
-
-## Try it
-
-Head over to `http://<host-ip or url>/api/v1/info` in a browser.
-You should see something like this:
-
-```json
-{
-	"version": "v0.23.0",
-	"frontend_url": "https://try.vikunja.io/",
-	"motd": "",
-	"link_sharing_enabled": true,
-	"max_file_size": "20MB",
-	"registration_enabled": true,
-	"available_migrators": [
-		"vikunja-file",
-		"ticktick",
-		"todoist"
-	],
-	"task_attachments_enabled": true,
-	"enabled_background_providers": [
-		"upload",
-		"unsplash"
-	],
-	"totp_enabled": false,
-	"legal": {
-		"imprint_url": "",
-		"privacy_policy_url": ""
-	},
-	"caldav_enabled": true,
-	"auth": {
-		"local": {
-			"enabled": true
-		},
-		"openid_connect": {
-			"enabled": false,
-			"providers": null
-		}
-	},
-	"email_reminders_enabled": true,
-	"user_deletion_enabled": true,
-	"task_comments_enabled": true,
-	"demo_mode_enabled": true,
-	"webhooks_enabled": true
-}
-```
-
-This shows you can reach the api through the api proxy.
-
-Now head over to `http://<host-ip or url>/` which should show the login mask.
-
-## Make it persistent
-
-Currently, Vikunja runs in foreground in your terminal.
-For a real-world scenario this is not the best way.
-
-Back in your terminal, stop the stack by pressing `CTRL-C` on your keyboard.
-Then run `sudo docker-compose up -d` in your again.
-The `-d` flag at the end of the command will tell docker to run the containers in the background.
-If you need to check the logs after that, you can run `sudo docker-compose logs`.
-
-Vikunja does not have any default users, you'll need to register and account.
-After that, you can use it.
-
-## Tear it all down
-
-If you want to completely stop all containers run `sudo docker-compose down` in your terminal.
-
-## Improve this guide
-
-We'll happily accept suggestions and improvements for this guide.
-Please [reach out to us](https://vikunja.io/contact/) if you have any.

docs/content/doc/setup/full-docker-example.md

@@ -1,354 +0,0 @@
----
-date: "2019-02-12:00:00+02:00"
-title: "Full docker example"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# Full docker example
-
-This docker compose configuration will run Vikunja with a mariadb database.
-It uses a proxy configuration to make it available under a domain.
-
-For all available configuration options, see [configuration]({{< ref "config.md">}}).
-
-After registering all your users, you might also want to [disable the user registration]({{<ref "config.md">}}#enableregistration).
-
-<div class="notification is-warning">
-<b>NOTE:</b> If you intend to run Vikunja with mysql and/or to use non-latin characters
-<a href="{{< ref "utf-8.md">}}">make sure your db is utf-8 compatible</a>.<br/>
-All examples on this page already reflect this and do not require additional work.
-</div>
-
-{{< table_of_contents >}}
-
-## File permissions
-
-Vikunja runs as user `1000` and no group by default.
-You can use Docker's [`--user`](https://docs.docker.com/engine/reference/run/#user) flag to change that.
-
-You must ensure Vikunja is able to write into the `files` directory.
-To do this, create the folder and chown it before starting the stack:
-
-```
-mkdir $PWD/files
-chown 1000 $PWD/files
-```
-
-You'll need to do this before running any of the examples on this page.
-
-Vikunja will not try to aquire ownership of the files folder, as that would mean it had to run as root.
-
-## PostgreSQL
-
-Vikunja supports postgres, mysql and sqlite as a database backend. The examples on this page use mysql with a mariadb container.
-To use postgres as a database backend, change the `db` section of the examples to this:
-
-```yaml
-db:
-  image: postgres:16
-  environment:
-    POSTGRES_PASSWORD: changeme
-    POSTGRES_USER: vikunja
-  volumes:
-    - ./db:/var/lib/postgresql/data
-  restart: unless-stopped
-  healthcheck:
-    test: ["CMD-SHELL", "pg_isready -h localhost -U $$POSTGRES_USER"]
-    interval: 2s
-```
-
-You'll also need to change the `VIKUNJA_DATABASE_TYPE` to `postgres` on the api container declaration.
-
-## Sqlite
-
-Vikunja supports postgres, mysql and sqlite as a database backend. The examples on this page use mysql with a mariadb container.
-To use sqlite as a database backend, change the `api` section of the examples to this:
-
-```yaml
-vikunja:
-  image: vikunja/vikunja
-  environment:
-    VIKUNJA_SERVICE_JWTSECRET: <a super secure random secret>
-    VIKUNJA_SERVICE_PUBLICURL: http://<your public frontend url with slash>/
-    # Note the default path is /app/vikunja/vikunja.db.
-    # This config variable moves it to a different folder so you can use a volume and 
-    # store the database file outside the container so state is persisted even if the container is destroyed.
-    VIKUNJA_DATABASE_PATH: /db/vikunja.db
-  ports:
-    - 3456:3456
-  volumes:
-    - ./files:/app/vikunja/files
-    - ./db:/db
-  restart: unless-stopped
-```
-
-The default path Vikunja uses for sqlite is relative to the binary, which in the docker container would be `/app/vikunja/vikunja.db`.
-The `VIKUNJA_DATABASE_PATH` environment variable moves changes it so that the database file is stored in a volume at `/db`, to persist state across restarts.
-
-You'll also need to remove or change the `VIKUNJA_DATABASE_TYPE` to `sqlite` on the container declaration.
-
-You can also remove the db section.
-
-To run the container, you need to create the directories first and make sure they have all required permissions:
-
-```
-mkdir $PWD/files $PWD/db
-chown 1000 $PWD/files $PWD/db
-```
-
-<div class="notification is-warning">
-<b>NOTE:</b> If you'll use your instance with more than a handful of users, we recommend using mysql or postgres.
-</div>
-
-## Example without any proxy
-
-This example lets you host Vikunja without any reverse proxy in front of it. 
-This is the absolute minimum configuration you need to get something up and running. 
-If you want to make Vikunja available on a domain or need tls termination, check out one of the other examples.
-
-Note that you need to change the [`VIKUNJA_SERVICE_PUBLICURL`]({{< ref "config.md" >}}#publicurl) environment variable to the public ip or hostname including the port (the docker host you're running this on) is reachable at, prefixed with `http://`.
-Because the browser you'll use to access the Vikunja frontend uses that url to make the requests, it has to be able to reach it from the outside. 
-
-<div class="notification is-warning">
-<b>NOTE:</b> You must ensure Vikunja has write permissions on the `files` directory before starting the stack.
-To do this, <a href="#file-permissions">check out the related commands here</a>.
-</div>
-
-```yaml
-version: '3'
-
-services:
-  vikunja:
-    image: vikunja/vikunja
-    environment:
-      VIKUNJA_SERVICE_PUBLICURL: http://<the public ip or host where vikunja is reachable>
-      VIKUNJA_DATABASE_HOST: db
-      VIKUNJA_DATABASE_PASSWORD: changeme
-      VIKUNJA_DATABASE_TYPE: mysql
-      VIKUNJA_DATABASE_USER: vikunja
-      VIKUNJA_DATABASE_DATABASE: vikunja
-      VIKUNJA_SERVICE_JWTSECRET: <a super secure random secret>
-    ports:
-      - 3456:3456
-    volumes:
-      - ./files:/app/vikunja/files
-    depends_on:
-      db:
-        condition: service_healthy
-    restart: unless-stopped
-  db:
-    image: mariadb:10
-    command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
-    environment:
-      MYSQL_ROOT_PASSWORD: supersecret
-      MYSQL_USER: vikunja
-      MYSQL_PASSWORD: changeme
-      MYSQL_DATABASE: vikunja
-    volumes:
-      - ./db:/var/lib/mysql
-    restart: unless-stopped
-    healthcheck:
-      test: ["CMD-SHELL", "mysqladmin ping -h localhost -u $$MYSQL_USER --password=$$MYSQL_PASSWORD"]
-      interval: 2s
-      start_period: 30s
-```
-
-## Example with Traefik 2
-
-This example assumes [traefik](https://traefik.io) version 2 installed and configured to [use docker as a configuration provider](https://docs.traefik.io/providers/docker/).
-
-We also make a few assumptions here which you'll most likely need to adjust for your traefik setup:
-
-* Your domain is `vikunja.example.com`
-* The entrypoint you want to make vikunja available from is called `https`
-* The tls cert resolver is called `acme`
-
-<div class="notification is-warning">
-<b>NOTE:</b> You must ensure Vikunja has write permissions on the `files` directory before starting the stack.
-To do this, <a href="#file-permissions">check out the related commands here</a>.
-</div>
-
-```yaml
-version: '3'
-
-services:
-  vikunja:
-    image: vikunja/vikunja
-    environment:
-      VIKUNJA_SERVICE_PUBLICURL: http://<the public url where vikunja is reachable>
-      VIKUNJA_DATABASE_HOST: db
-      VIKUNJA_DATABASE_PASSWORD: changeme
-      VIKUNJA_DATABASE_TYPE: mysql
-      VIKUNJA_DATABASE_USER: vikunja
-      VIKUNJA_DATABASE_DATABASE: vikunja
-      VIKUNJA_SERVICE_JWTSECRET: <a super secure random secret>
-    volumes: 
-      - ./files:/app/vikunja/files
-    networks:
-      - web
-      - default
-    depends_on:
-      db:
-        condition: service_healthy
-    restart: unless-stopped
-    labels:
-      - "traefik.enable=true"
-      - "traefik.docker.network=web"
-      - "traefik.http.routers.vikunja.rule=Host(`vikunja.example.com`)"
-      - "traefik.http.routers.vikunja.entrypoints=https"
-      - "traefik.http.routers.vikunja.tls.certResolver=acme"
-  db:
-    image: mariadb:10
-    command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
-    environment:
-      MYSQL_ROOT_PASSWORD: supersupersecret 
-      MYSQL_USER: vikunja
-      MYSQL_PASSWORD: changeme
-      MYSQL_DATABASE: vikunja
-    volumes:
-      - ./db:/var/lib/mysql
-    restart: unless-stopped
-    healthcheck:
-      test: ["CMD-SHELL", "mysqladmin ping -h localhost -u $$MYSQL_USER --password=$$MYSQL_PASSWORD"]
-      interval: 2s
-      start_period: 30s
-
-networks:
-  web:
-    external: true
-```
-
-## Example with Caddy v2 as proxy
-
-You will need the following `Caddyfile` on your host (or elsewhere, but then you'd need to adjust the proxy mount at the bottom of the compose file):
-
-```conf
-vikunja.example.com {
-    reverse_proxy api:3456
-}
-```
-
-Note that you need to change the [`VIKUNJA_SERVICE_PUBLICURL`]({{< ref "config.md" >}}#publicurl) environment variable to the ip (the docker host you're running this on) is reachable at.
-Because the browser you'll use to access the Vikunja frontend uses that url to make the requests, it has to be able to reach that ip + port from the outside.
-
-<div class="notification is-warning">
-<b>NOTE:</b> You must ensure Vikunja has write permissions on the `files` directory before starting the stack.
-To do this, <a href="#file-permissions">check out the related commands here</a>.
-</div>
-
-Docker Compose config:
-
-```yaml
-version: '3'
-
-services:
-  vikunja:
-    image: vikunja/vikunja
-    environment:
-      VIKUNJA_SERVICE_PUBLICURL: http://<the public url where vikunja is reachable>
-      VIKUNJA_DATABASE_HOST: db
-      VIKUNJA_DATABASE_PASSWORD: changeme
-      VIKUNJA_DATABASE_TYPE: mysql
-      VIKUNJA_DATABASE_USER: vikunja
-      VIKUNJA_DATABASE_DATABASE: vikunja
-      VIKUNJA_SERVICE_JWTSECRET: <a super secure random secret>
-    ports:
-      - 3456:3456
-    volumes:
-      - ./files:/app/vikunja/files
-    depends_on:
-      db:
-        condition: service_healthy
-    restart: unless-stopped
-  db:
-    image: mariadb:10
-    command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
-    environment:
-      MYSQL_ROOT_PASSWORD: supersecret
-      MYSQL_USER: vikunja
-      MYSQL_PASSWORD: changeme
-      MYSQL_DATABASE: vikunja
-    volumes:
-      - ./db:/var/lib/mysql
-    restart: unless-stopped
-    healthcheck:
-      test: ["CMD-SHELL", "mysqladmin ping -h localhost -u $$MYSQL_USER --password=$$MYSQL_PASSWORD"]
-      interval: 2s
-      start_period: 30s
-  caddy:
-    image: caddy
-    restart: unless-stopped
-    ports:
-      - "80:80"
-      - "443:443"
-    depends_on:
-      - api
-      - frontend
-    volumes:
-      - ./Caddyfile:/etc/caddy/Caddyfile:ro
-```
-
-## Setup on a Synology NAS
-
-There is a proxy preinstalled in DSM, so if you want to access Vikunja from outside,
-you need to prepare a proxy rule the Vikunja Service.
-
-![Synology Proxy Settings](/docs/synology-proxy-1.png)
-
-You should also add 2 empty folders for mariadb and vikunja inside Synology's
-docker main folders:
-
-* Docker
-  * vikunja
-  * mariadb
-
-Synology has its own GUI for managing Docker containers, but it's easier via docker compose.
-
-To do that, you can
-
-* Either activate SSH and paste the adapted compose file in a terminal (using Putty or similar)
-* Without activating SSH as a "custom script" (go to Control Panel / Task Scheduler / Create / Scheduled Task / User-defined script)
-* Without activating SSH, by using Portainer (you have to install first, check out [this tutorial](https://www.portainer.io/blog/how-to-install-portainer-on-a-synology-nas) for exmple):
-  1. Go to **Dashboard / Stacks** click the button **"Add Stack"**
-  2. Give it the name Vikunja and paste the adapted docker compose file
-  3. Deploy the Stack with the "Deploy Stack" button:
-
-![Portainer Stack deploy](/docs/synology-proxy-2.png)
-
-The docker-compose file we're going to use is exactly the same from the [example without any proxy](#example-without-any-proxy) above.
-
-You may want to change the volumes to match the rest of your setup.
-
-After registering all your users, you might also want to [disable the user registration]({{<ref "config.md">}}#enableregistration).
-
-<div class="notification is-warning">
-<b>NOTE:</b> You must ensure Vikunja has write permissions on the `files` directory before starting the stack.
-To do this, <a href="#file-permissions">check out the related commands here</a>.
-</div>
-
-## Redis
-
-While Vikunja has support to use redis as a caching backend, you'll probably not need it unless you're using Vikunja with more than a handful of users.
-
-To use redis, you'll need to add this to the config examples below:
-
-```yaml
-version: '3'
-
-services:
-  vikunja:
-    image: vikunja/vikunja
-    environment:
-      VIKUNJA_REDIS_ENABLED: 1
-      VIKUNJA_REDIS_HOST: 'redis:6379'
-      VIKUNJA_CACHE_ENABLED: 1
-      VIKUNJA_CACHE_TYPE: redis
-    volumes:
-      - ./files:/app/vikunja/files
-  redis:
-    image: redis
-```

docs/content/doc/setup/install.md

@@ -1,315 +0,0 @@
----
-date: "2019-02-12:00:00+02:00"
-title: "Installing"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "setup"
-    weight: 10
----
-
-# Installing
-
-Architecturally, Vikunja is made up of two parts: [API](https://code.vikunja.io/api) and [frontend](https://code.vikunja.io/api/frontend).
-
-Both are bundled into one single deployable binary (or docker container).
-That means you only need to install one thing to be able to use Vikunja.
-
-You can also:
-
-* Use the desktop app, which is essentially the web frontend packaged for easy installation on desktop devices
-* Use the mobile app only, but as of right now it only supports the very basic features of Vikunja
-
-<div class="notification is-warning">
-<b>NOTE:</b> If you intend to run Vikunja with mysql and/or to use non-latin characters 
-<a href="{{< ref "utf-8.md">}}">make sure your db is utf-8 compatible</a>.
-</div>
-
-Vikunja can be installed in various ways.
-This document provides an overview and instructions for the different methods:
-
-* [Installing from binary (manual)](#install-from-binary)
-* [Build from source]({{< ref "build-from-source.md">}})
-* [Docker](#docker)
-* [Debian](#debian-packages)
-* [RPM](#rpm)
-* [FreeBSD](#freebsd--freenas)
-* [Kubernetes]({{< ref "k8s.md" >}})
-
-And after you installed Vikunja, you may want to check out these other ressources:
-
-* [Configuration]({{< ref "config.md">}})
-* [UTF-8 Settings]({{< ref "utf-8.md">}})
-* [Reverse proxies]({{< ref "reverse-proxies.md">}})
-* [Full docker example]({{< ref "full-docker-example.md">}})
-* [Backups]({{< ref "backups.md">}})
-
-## Install from binary
-
-Download a copy of Vikunja from the [download page](https://dl.vikunja.io/vikunja) for your architecture.
-
-```
-wget <download-url>
-```
-
-### Verify the GPG signature
-
-All releases are signed using GPG.
-
-To validate the downloaded zip file use the signiture file `.asc` and the key `FF054DACD908493A`:
-
-```
-gpg --keyserver keyserver.ubuntu.com --recv FF054DACD908493A
-gpg --verify vikunja-<vikunja version>-linux-amd64-full.zip.asc vikunja-<vikunja version>-linux-amd64-full.zip
-```
-
-### Set it up
-
-Once you've verified the signature, you need to unzip and make it executable.
-You'll also need to create a symlink to the binary, so that you can execute Vikunja by typing `vikunja` on your system.
-We'll install vikunja to `/opt/vikunja`, change the path where needed if you want to install it elsewhere.
-
-Run these commands to install it:
-
-```
-mkdir -p /opt/vikunja
-unzip <vikunja-zip-file> -d /opt/vikunja
-chmod +x /opt/vikunja
-sudo ln -s /opt/vikunja/vikunja /usr/bin/vikunja
-```
-
-### Systemd service
-
-To automatically start Vikunja when your system boots and to ensure all dependent services are met, you want to use an init system like systemd.
-
-Save the following service file to `/etc/systemd/system/vikunja.service` and adapt it to your needs:
-
-```unit file (systemd)
-[Unit]
-Description=Vikunja
-After=syslog.target
-After=network.target
-# Depending on how you configured Vikunja, you may want to uncomment these:
-#Requires=mysql.service
-#Requires=mariadb.service
-#Requires=postgresql.service
-#Requires=redis.service
-
-[Service]
-RestartSec=2s
-Type=simple
-WorkingDirectory=/opt/vikunja
-ExecStart=/usr/bin/vikunja
-Restart=always
-# If you want to bind Vikunja to a port below 1024 uncomment
-# the two values below
-###
-#CapabilityBoundingSet=CAP_NET_BIND_SERVICE
-#AmbientCapabilities=CAP_NET_BIND_SERVICE
-
-[Install]
-WantedBy=multi-user.target
-```
-
-If you've installed Vikunja to a directory other than `/opt/vikunja`, you need to adapt `WorkingDirectory` accordingly.
-
-After you made all necessary modifications, it's time to start the service:
-
-```
-sudo systemctl enable vikunja
-sudo systemctl start vikunja
-```
-
-### Build from source
-
-To build vikunja from source, see [building from source]({{< ref "build-from-source.md">}}).
-
-### Updating
-
-[Make a backup first]({{< ref "backups.md" >}}).
-
-Simply replace the binary with the new version, then restart Vikunja.
-It will automatically run all necessary database migrations.
-**Make sure to take a look at the changelog for the new version to not miss any manual steps the update may involve!**
-
-## Docker
-
-(Note: this assumes some familiarity with docker)
-
-To get up and running quickly, use this command:
-
-```
-mkdir $PWD/files $PWD/db
-chown 1000 $PWD/files $PWD/db
-docker run -p 3456:3456 -v $PWD/files:/app/vikunja/files -v $PWD/db:/db vikunja/vikunja
-```
-
-This will expose vikunja on port `3456` on the host running the container and use sqlite as database backend.
-
-**Note**: The container runs as the user `1000` and no group by default. 
-You can use Docker's [`--user`](https://docs.docker.com/engine/reference/run/#user) flag to change that.
-Make sure the new user has required permissions on the `db` and `files` folder.
-
-You can mount a local configuration like so:
-
-```
-mkdir $PWD/files $PWD/db
-chown 1000 $PWD/files $PWD/db
-docker run -p 3456:3456 -v /path/to/config/on/host.yml:/app/vikunja/config.yml:ro -v $PWD/files:/app/vikunja/files -v $PWD/db:/db vikunja/vikunja
-```
-
-Though it is recommended to use environment variables or `.env` files to configure Vikunja in docker.
-See [config]({{< ref "config.md">}}) for a list of available configuration options.
-
-Check out the [docker examples]({{<ref "full-docker-example.md">}}) for more advanced configuration using mysql / postgres and a reverse proxy.
-
-### Files volume
-
-By default, the container stores all files uploaded and used through vikunja inside of `/app/vikunja/files` which is created as a docker volume.
-You should mount the volume somewhere to the host to permanently store the files and don't lose them if the container restarts.
-
-### Docker compose
-
-Check out the [docker examples]({{<ref "full-docker-example.md">}}) for more advanced configuration using docker compose.
-
-## Debian packages
-
-Vikunja is available as deb package for installation on debian-like systems.
-
-To install these, grab a `.deb` file from [the download page](https://dl.vikunja.io/vikunja) and run
-
-```
-dpkg -i vikunja.deb
-```
-
-This will install Vikunja to `/opt/vikunja`.
-To configure it, use the config file in `/etc/vikunja/config.yml`.
-
-## RPM
-
-Vikunja is available as rpm package for installation on Fedora, CentOS and others.
-
-To install these, grab a `.rpm` file from [the download page](https://dl.vikunja.io/vikunja) and run
-
-```
-rpm -i vikunja.rpm
-```
-
-To configure Vikunja, use the config file in `/etc/vikunja/config.yml`.
-
-## FreeBSD / FreeNAS
-
-Unfortunately, we currently can't provide pre-built binaries for FreeBSD.
-As a workaround, it is possible to compile vikunja for FreeBSD directly on a FreeBSD machine, a guide is available below:
-
-*Thanks to HungrySkeleton who originally created this guide [in the forum](https://community.vikunja.io/t/freebsd-support/69/11).*
-
-### Jail Setup
-
-1. Create a jail named `vikunja`
-2. Set jail properties to 'auto start'
-3. Mount storage (`/mnt` to `jailData/vikunja`)
-4. Start jail & SSH into it
-
-### Installing packages
-
-```
-pkg update && pkg upgrade -y
-pkg install nano git go gmake
-go install github.com/magefile/mage
-```
-
-### Clone vikunja repo
-
-```
-mkdir /mnt/GO/code.vikunja.io
-cd /mnt/GO/code.vikunja.io
-git clone https://code.vikunja.io/api
-cd /mnt/GO/code.vikunja.io/api
-```
-
-### Compile binaries
-
-```
-cd frontend
-pnpm install
-pnpm run build
-cd ..
-mage build
-```
-
-### Create folder to install Vikunja into
-
-```
-mkdir /mnt/vikunja
-cp /mnt/GO/code.vikunja.io/api/vikunja /mnt/vikunja
-cd /mnt/vikunja
-chmod +x /mnt/vikunja
-```
-
-### Set vikunja to boot on startup
-
-```
-nano /etc/rc.d/vikunja
-```
-
-Then paste into the file:
-
-```
-#!/bin/sh
-
-. /etc/rc.subr
-
-name=vikunja
-rcvar=vikunja_enable
-
-command="/mnt/vikunja/${name}"
-
-load_rc_config $name
-run_rc_command "$1"
-```
-
-Save and exit.  Then execute:
-
-```
-chmod +x /etc/rc.d/vikunja
-nano /etc/rc.conf
-```
-
-Then add line to bottom of file:
-
-```
-vikunja_enable="YES"
-```
-
-Test vikunja now works with
-
-```
-service vikunja start
-```
-
-Vikunja is now available through IP:
-
-```
-192.168.1.XXX:3456
-```
-
-## Other installation resources
-
-* [Docker Compose is MUCH Easier Than you Think - Let's Install Vikunja](https://www.youtube.com/watch?v=fGlz2PkXjuo) (Youtube)
-* [Setup Vikunja using Docker Compose - Homelab Wiki](https://thehomelab.wiki/books/docker/page/setup-vikunja-using-docker-compose)
-* [A Closer look at Vikunja - Email Notifications - Enable or Disable Registrations - Allow Attachments](https://www.youtube.com/watch?v=47wj9pRT6Gw) (Youtube)
-* [Install Vikunja in Docker for self-hosted Task Tracking](https://smarthomepursuits.com/install-vikunja-in-docker-for-self-hosted-task-tracking/)
-* [Self-Hosted To-Do List with Vikunja in Docker](https://www.youtube.com/watch?v=DqyqDWpEvKI) (Youtube)
-* [Vikunja self-hosted (step by step)](https://nguyenminhhung.com/vikunja-self-hosted-step-by-step/)
-* [How to Install Vikunja on Your Synology NAS](https://mariushosting.com/how-to-install-vikunja-on-your-synology-nas/)
-
-## Configuration
-
-See [available configuration options]({{< ref "config.md">}}).
-
-## Default Password
-
-After successfully installing Vikunja, there is no default user or password.
-You only need to register a new account and set all the details when creating it.

docs/content/doc/setup/k8s.md

@@ -1,22 +0,0 @@
----
-title: "Hosting Vikunja with k8s"
-date: 2022-08-12T13:41:48+02:00
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# Hosting Vikunja with k8s
-
-We have an official Helm Chart for Vikunja.
-
-Check out [the repo](https://kolaente.dev/vikunja/helm-chart/) for more information about how to use it.
-
-## Third-party Helm Charts
-
-There are two third-party Helm-Charts which can be used to host Vikunja with k8s:
-
-* [Truecharts](https://truecharts.org/charts/stable/vikunja/)
-* [k8s at Home](https://github.com/k8s-at-home/charts)

docs/content/doc/setup/openid-examples.md

@@ -1,117 +0,0 @@
----
-date: "2022-08-09:00:00+02:00"
-title: "OpenID example configurations"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# OpenID example configurations
-
-On this page you will find examples about how to set up Vikunja with a third-party OAuth 2.0 provider using OpenID Connect.
-To add another example, please [edit this document](https://kolaente.dev/vikunja/vikunja/src/branch/main/docs/content/doc/setup/openid-examples.md) and send a PR.
-
-{{< table_of_contents >}}
-
-## Authelia
-
-Vikunja Config:
-
-```yaml
-openid:
-    enabled: true
-    redirecturl: https://vikunja.mydomain.com/auth/openid/  <---- slash at the end is important
-    providers:
-      - name: Authelia
-        authurl: https://login.mydomain.com
-        clientid: <vikunja-id>
-        clientsecret: <vikunja secret>
-```
-
-Authelia config:
-
-```yaml
-- id: <vikunja-id>
-description: Vikunja
-secret: <vikunja secret>
-redirect_uris:
-  - https://vikunja.mydomain.com/auth/openid/authelia
-scopes:
-  - openid
-  - email
-  - profile
-```
-
-## Google / Google Workspace
-
-Vikunja Config:
-
-```yaml
-openid:
-    enabled: true
-    redirecturl: https://vikunja.mydomain.com/auth/openid/  <---- slash at the end is important
-    providers:
-      - name: Google
-        authurl: https://accounts.google.com
-        clientid: <google-oauth-client-id>
-        clientsecret: <google-oauth-client-secret>
-```
-
-Google config:
-
-- Navigate to `https://console.cloud.google.com/apis/credentials` in the target project
-- Create a new OAuth client ID
-- Configure an authorized redirect URI of `https://vikunja.mydomain.com/auth/openid/google`
-
-Note that there currently seems to be no way to stop creation of new users, even when `enableregistration` is `false` in the configuration. This means that this approach works well only with an "Internal Organization" app for Google Workspace, which limits the allowed users to organizational accounts only. External / public applications will potentially allow every Google user to register.
-
-## Keycloak
-
-Vikunja Config:
-```yaml
-openid:
-    enabled: true
-    redirecturl: https://vikunja.mydomain.com/auth/openid/  <---- slash at the end is important
-    providers:
-      - name: Keycloak
-        authurl: https://keycloak.mydomain.com/realms/<relam-name>
-        logouturl: https://keycloak.mydomain.com/realms/<relam-name>/protocol/openid-connect/logout
-        clientid: <vikunja-id>
-        clientsecret: <vikunja secret>
-```
-Keycloak Config:
-- Navigate to the keycloak instance
-- Create a new client with the type `OpenID Connect` and a unique ID.
-- Set `Client authentication` to On
-- Set `Root Url` to `https://vikunja.mydomain.com`
-- Set `Valid redirect URIs` to `/auth/openid/keycloak`
-- Create the client the navigate to the credentials tab and copy the `Client secret`
-
-## Authentik
-
-Authentik Config:
-- Create a new Provider called "Vikunja" in Authentik
-- Set the `Redirect URIs/Origins (RegEx)` to `https://vikunja.mydomain.com/auth/openid/authentik`
-- Copy the Client ID and Client Secret
-
-Vikunja Config:
-
-```yaml
-auth:
-  openid:
-    enabled: true
-    redirecturl: "https://vikunja.mydomain.com/auth/openid/"
-    providers:
-      - name: authentik
-        authurl: "https://authentik.mydomain.com/application/o/vikunja"
-        logouturl: "https://authentik.mydomain.com/application/o/vikunja/end-session/"
-        clientid: "" # copy from Authetik
-        clientsecret: "" # copy from Authentik
-```
-
-**Note:** The `authurl` that Vikunja requires is not the `Authorize URL` that you can see in the Provider.
-OpenID Discovery is used to find the correct endpoint to use automatically, by accessing the `OpenID Configuration URL` (usually `https://authentik.mydomain.com/application/o/vikunja/.well-known/openid-configuration`).
-Use this URL without the `.well-known/openid-configuration` as the `authurl`.
-Typically this URL can be found in the metadata section within your identity provider.

docs/content/doc/setup/openid.md

@@ -1,180 +0,0 @@
----
-date: "2022-08-09:00:00+02:00"
-title: "OpenID"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# OpenID
-
-Vikunja allows for authentication with an external identity source such as Authentik, Keycloak or similar via the
-[OpenID Connect](https://openid.net/developers/specs/) standard.
-
-{{< table_of_contents >}}
-
-## OpenID Connect Overview
-
-OpenID Connect is a standardized identity layer built on top of the more generic OAuth 2.0 specification, simplying interaction between the involved parties significantly.
-While the [OpenID specification](https://openid.net/specs/openid-connect-core-1_0.html#Overview) is worth a read, we summarize the most important basics here.
-
-The involved parties are:
-
-- **Resource Owner:** typically the end-user
-- **Resource Server:** the application server handling requests from the client, the Vikunja API in our case
-- **Client:** the application or client accessing the RS on behalf of the RO. Vikunja web frontend or any of the apps
-- **Authorization Server:** the server verifying the user identity and issuing tokens. These docs also use the words `OAuth 2.0 provider`, `Identity Provider` interchangeably.
-
-After the user is authenticated, the provider issues a token to the user, containing various claims.
-There's different types of tokens (ID token, access token, refresh token), and all of them are created as [JSON Web Token](https://www.rfc-editor.org/info/rfc7519).
-Claims in turn are assertions containing information about the token bearer, usually the user.
-
-**Scopes** are requested by the client when redirecting the end-user to the Authorization Server for authentication, and indirectly control which claims are included in the resulting tokens.
-There's certain default scopes, but its also possible to define custom scopes, which are used by the feature assigning users to Teams automatically.
-
-## Configuring OIDC Authentication
-
-To achieve authentication via an external provider, it is required to (a) configure a confidential Client on your OAuth 2.0 provider and (b) configure Vikunja to authenticate against this provider. 
-[Example configurations]({{< ref "openid-examples.md">}}) are provided for various different identity providers, below you can find generic guides though.
-
-OpenID Connect defines various flow types indicating how exactly the interaction between the involved parties work, Vikunja makes use of the standard **Authorization Code Flow**.
-
-### Step 1: Configure your Authorization Server
-
-The first step is to configure the Authorization Server to correctly handle requests coming from Vikunja.
-In general, this involves the following steps at a minimum:
-
-- Create a confidential client and obtain the client ID and client secret
-- Configure (whitelist) redirect URLs that can be used by Vikunja
-- Make sure the required scopes (`openid profile email` are the default scopes used by Vikunja) are supported
-- Optional: configure an additional scope for automatic team assignment, see below for details
-
-More detailled instructions for various different identity providers can be [found here]({{< ref "openid-examples.md">}})
-
-### Step 2: Configure Vikunja
-
-Vikunja has to be configured to use the identity provider. Please note that there is currently no option to configure these settings via environment variables, they have to be defined using the configuration file. The configuration schema is as follows:
-
-```yaml
-auth:
-  openid:
-    enabled: true
-    redirecturl: https://vikunja.mydomain.com/auth/openid/  <---- slash at the end is important
-    providers:
-      - name: <provider-name>
-        authurl: <auth-url>
-        clientid: <vikunja client-id>
-        clientsecret: <vikunja client-secret>
-        scope: openid profile email
-```
-
-The values for `authurl` can be obtained from the Metadata of your provider, while `clientid` and `clientsecret` are obtained when configuring the client.
-The scope usually doesn't need to be specified or changed, unless you want to configure the automatic team assignment.
-
-Optionally it is possible to disable local authentication and therefore forcing users to login via OpenID connect:
-
-```yaml
-auth:
-  local:
-    enabled: false
-```
-
-## Automatically assign users to teams
-
-Vikunja is capable of automatically adding users to a team based on OIDC claims added by the identity provider.
-If configured, Vikunja will sync teams, automatically create new ones and make sure the members are part of the configured teams.
-Teams which exist only because they were created from oidc attributes are not editable in Vikunja.
-
-To distinguish between teams created in Vikunja and teams generated automatically via oidc, generated teams have an `oidcID` assigned internally.
-Within the UI, the teams created through OIDC get a `(OIDC)` suffix to make them distinguishable from locally created teams.
-
-On a high level, you need to make sure that the **ID token** issued by your identity provider contains a `vikunja_groups` claim, following the structure defined below.
-It depends on the provider being used as well as the preferences of the administrator how this is achieved.
-Typically you'd want to request an additional scope (e.g. `vikunja_scope`) which then triggers the identity provider to add the claim.
-If the `vikunja_groups` is part of the **ID token**, Vikunja will  start the procedure and import teams and team memberships.
-
-The claim structure expexted by Vikunja is as follows:
-
-```json
-{
-    "vikunja_groups": [
-        {
-            "name": "team 1",
-            "oidcID": 33349
-        },
-        {
-            "name": "team 2",
-            "oidcID": 35933
-        }
-    ]
-}
-```
-
-For each team, you need to define a team `name` and an `oidcID`, where the `oidcID` can be any string with a length of less than 250 characters.
-The `oidcID` is used to uniquely identify the team, so please make sure to keep this unique.
-
-Below you'll find two example implementations for Authentik and Keycloak.
-If you've successfully implemented this with another identity provider, please let us know and submit a PR to improve the docs.
-
-### Setup in Authentik
-
-To configure automatic team management through Authentik, we assume you have already [set up Authentik]({{< ref "openid-examples.md">}}#authentik) as an OIDC provider for authentication with Vikunja.
-
-To use Authentik's group assignment feature, follow these steps:
-
-1. Edit [your config]({{< ref "config.md">}}) to include the following scopes: `openid profile email vikunja_scope`
-2. Open `<your authentik url>/if/admin/#/core/property-mappings`
-3. Create a new property mapping called `vikunja_scope` as scope mapping. There is a field `expression` to enter python expressions that will be delivered with the oidc token.
-4. Write a small script like the following to add group information to `vikunja_scope`:
-
-```python
-groupsDict = {"vikunja_groups": []}
-for group in request.user.ak_groups.all():
-  groupsDict["vikunja_groups"].append({"name": group.name, "oidcID": group.num_pk})
-return groupsDict
-```
-
-5. In Authentik's menu on the left, go to Applications > Providers > Select the Vikunja provider. Then click on "Edit", on the bottom open "Advanced protocol settings", select the newly created property mapping under "Scopes". Save the provider.
-
-Now when you log into Vikunja via Authentik it will show you a list of scopes you are claiming.
-You should see the description you entered on the OIDC provider's admin area.
-
-Proceed to vikunja and open the teams page in the sidebar menu.
-You should see "(OIDC)" written next to each team you were assigned through OIDC.
-
-### Setup in Keycloak
-
-The kind people from Makerspace Darmstadt e.V. have written [a guide on how to create a mapper for Vikunja here](https://github.com/makerspace-darmstadt/keycloak-vikunja-mapper).
-
-## Use cases
-
-All examples assume one team called "Team 1" to be configured within your provider.
-
-* *Token delivers team.name +team.oidcID and Vikunja team does not exist:* \
-New team will be created called "Team 1" with attribute oidcID: "33929"
-
-2. *In Vikunja Team with name "team 1" already exists in vikunja, but has no oidcID set:* \
-new team will be created called "team 1" with attribute oidcID: "33929"
-
-3. *In Vikunja Team with name "team 1" already exists in vikunja, but has different oidcID set:* \
-new team will be created called "team 1" with attribute oidcID: "33929"
-
-4. *In Vikunja Team with oidcID "33929" already exists in vikunja, but has different name than "team1":* \
-new team will be created called "team 1" with attribute oidcID: "33929"
-
-5. *Scope vikunja_scope is not set:* \
-nothing happens
-
-6. *oidcID is not set:* \
-You'll get error.
-Custom Scope malformed
-"The custom scope set by the OIDC provider is malformed. Please make sure the openid provider sets the data correctly for your scope. Check especially to have set an oidcID."
-
-7. *In Vikunja I am in "team 3" with oidcID "", but the token does not deliver any data for "team 3":* \
-You will stay in team 3 since it was not set by the oidc provider
-
-8. *In Vikunja I am in "team 3" with oidcID "12345", but the token does not deliver any data for "team 3"*:\
-You will be signed out of all teams, which have an oidcID set and are not contained in the token.
-Especially if you've been the last team member, the team will be deleted.

docs/content/doc/setup/reverse-proxies.md

@@ -1,152 +0,0 @@
----
-date: "2019-02-12:00:00+02:00"
-title: "Reverse Proxy"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# Setup behind a reverse proxy
-
-These examples assume you have an instance of Vikunja running on your server listening on port `3456`.
-If you've changed this setting, you need to update the server configurations accordingly.
-
-{{< table_of_contents >}}
-
-## NGINX
-
-You may need to adjust `server_name` and `root` accordingly.
-
-```conf
-server {
-    listen       80;
-    server_name  localhost;
-
-    location / {
-        proxy_pass http://localhost:3456;
-        client_max_body_size 20M;
-    }
-}
-```
-
-<div class="notification is-warning">
-<b>NOTE:</b> If you change the max upload size in Vikunja's settings, you'll need to also change the <code>client_max_body_size</code> in the nginx proxy config.
-</div>
-
-## NGINX Proxy Manager (NPM)
-
-Following the [Docker Walkthrough]({{< ref "docker-start-to-finish.md" >}}) guide, you should be able to get Vikunja to work via HTTP connection to your server IP.
-
-From there, all you have to do is adjust the following things:
-
-### In `docker-compose.yml`
-
-1. Change `VIKUNJA_SERVICE_PUBLICURL:` to your desired domain with `https://` and `/`.
-2. Expose your desired port on host under `ports:`.
-
-example:
-
-```yaml
-  vikunja:
-    image: vikunja/vikunja
-    environment:
-      VIKUNJA_SERVICE_PUBLICURL: https://vikunja.your-domain.com/ # change vikunja.your-domain.com to your desired domain/subdomain.
-      VIKUNJA_DATABASE_HOST: db
-      VIKUNJA_DATABASE_PASSWORD: secret
-      VIKUNJA_DATABASE_TYPE: mysql
-      VIKUNJA_DATABASE_USER: vikunja
-      VIKUNJA_DATABASE_DATABASE: vikunja
-      VIKUNJA_SERVICE_JWTSECRET: <your-random-secret>
-    ports:
-      - 3456:3456 # Change 3456 on the left to the port of your choice.
-    volumes: 
-      - ./files:/app/vikunja/files
-    depends_on:
-      - db
-    restart: unless-stopped
-```
-
-### In your DNS provider
-
-Add an `A` records that points to your server IP.
-
-You are of course free to change them to whatever domain/subdomain you desire and modify the `docker-compose.yml` accordingly.
-
-(Tested on Cloudflare DNS. Settings are different for different DNS provider, in this case the end result should be `vikunja.your-domain.com`)
-
-### In Nginx Proxy Manager
-
-Add a Proxy Host as you normally would, and you don't have to add anything extra in Advanced.
-
-Under `Details`:
-
-```
-Domain Names:
-    vikunja.your-domain.com
-Scheme:
-    http
-Forward Hostname/IP:
-    your-server-ip
-Forward Port:
-    3456
-Cached Assets:
-    Optional.
-Block Common Exploits:
-    Toggled.
-Websockets Support:
-    Toggled.
-```
-
-Under `SSL`:
-
-```
-SSL Certificate:
-    However you prefer.
-Force SSL:
-    Toggled.
-HTTP/2 Support:
-    Toggled.
-HSTS Enabled:
-    Toggled.
-HSTS Subdomains:
-    Toggled.
-Use a DNS Challenge:
-    Not toggled.
-Email Address for Let's Encrypt:
-    your-email@email.com
-```
-
-Your Vikunja service should now work and your HTTPS frontend should be able to reach the API after `docker-compose`.
-
-## Apache
-
-Put the following config in `cat /etc/apache2/sites-available/vikunja.conf`:
-
-```aconf
-<VirtualHost *:80>
-    ServerName localhost
-   
-    <Proxy *>
-      Order Deny,Allow
-      Allow from all
-    </Proxy>
-    ProxyPass / http://localhost:3456/
-    ProxyPassReverse / http://localhost:3456/
-</VirtualHost>
-```
-
-**Note:** The apache modules `proxy`, `proxy_http` and `rewrite` must be enabled for this.
-
-## Caddy
-
-Use the following Caddyfile to get Vikunja up and running:
-
-```conf
-vikunja.domainname.tld {
-	handle /* {
-		reverse_proxy 127.0.0.1:3456
-	}
-}
-```

docs/content/doc/setup/subdirectory.md

@@ -1,49 +0,0 @@
----
-title: "Running Vikunja in a subdirectory"
-date: 2022-09-23T12:15:04+02:00
-draft: false
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# Running Vikunja in a subdirectory
-
-Running Vikunja in a subdirectory is not supported out of the box.
-However, you can still run it in a subdirectory but need to build the frontend yourself.
-
-## Frontend
-
-First, make sure you're able to build the frontend from source.
-Check [the guide about building from source]({{< ref "build-from-source.md">}}#frontend) about that.
-
-### Dynamicly set with build command
-
-Run the build with the `VIKUNJA_FRONTEND_BASE` variable specified.
-
-```
-VIKUNJA_FRONTEND_BASE=/SUBPATH/ pnpm run build
-```
-
-Where `SUBPATH` is the subdirectory you want to run Vikunja on.
-
-### Set via .env.local
-
-* Copy `.env.local.example` to `.env.local`
-* Uncomment `VIKUNJA_FRONTEND_BASE` and set `/subpath/` to the desired path.
-
-After saving, build Vikunja as normal.
-
-```
-pnpm run build
-```
-
-Once you have the frontend built, you can proceed to build the binary as outlined in [building from source]({{< ref "build-from-source.md">}}#api).
-
-## API
-
-If you're not using a reverse proxy you're good to go.
-Simply configure the api url in the frontend as you normally would.
-
-If you're using a reverse proxy you'll need to adjust the paths so that the api is available at `/SUBPATH/api/v1`.
-You can check if everything is working correctly by opening `/SUBPATH/api/v1/info` in a browser.

docs/content/doc/setup/typesense.md

@@ -1,23 +0,0 @@
----
-title: "Typesense"
-date: 2023-09-29T12:23:55+02:00
-draft: false
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# Use Typesense for enhanced search capabilities
-
-Vikunja supports using [Typesense](https://typesense.org/) for a better search experience.
-Typesense allows fast fulltext search including fuzzy matching support. 
-It may return different results than what you'd get with a database-only search, but generally, the results are more relevant to what you're looking for.
-
-This document explains how to set up and use Typesense with Vikunja.
-
-## Setup
-
-1. First, install Typesense on your system. Refer to [their documentation](https://typesense.org/docs/guide/install-typesense.html) for specific instructions.
-2. Once Typesense is available on your system and reachable by Vikunja, add the relevant configuration keys to your Vikunja config. [Check out the docs article about this]({{< ref "config.md#typesense">}}).
-3. Index all tasks currently in Vikunja. To do that, run the `vikunja index` command with the api binary. This may take a while, depending on the size of your instance.
-4. Restart the api. From now on, all task changes will be automatically indexed in Typesense.

docs/content/doc/setup/utf-8.md

@@ -1,105 +0,0 @@
----
-date: "2020-07-06:00:00+02:00"
-title: "UTF-8 Settings"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# UTF-8 Settings
-
-Vikunja itself is always fully capable of handling utf-8 characters.
-However, your database might be not. Vikunja itself will work just fine until you want to use non-latin characters in your tasks/projects/etc.
-
-On this page, you will find information about how to fully ensure non-latin characters like *aüäß* or emojis work with your installation.
-
-{{< table_of_contents >}}
-
-## Postgresql & SQLite
-
-Postgresql and SQLite should handle utf-8 just fine - If you discover any issues nonetheless, please 
-[drop us a message](https://vikunja.io/contact/).
-
-## MySQL
-
-MySQL is not able to handle utf-8 by default.
-To fix this, follow the steps below.
-
-To find out if your db supports utf-8, run the following in a shell or similar, assuming the database 
-you're using for vikunja is called `vikunja`:
-
-```sql
-SELECT default_character_set_name FROM information_schema.SCHEMATA WHERE schema_name = 'vikunja';
-```
-
-This will get you a result like the following:
-
-```
-+----------------------------+
-| default_character_set_name |
-+----------------------------+
-| latin1                     |
-+----------------------------+
-1 row in set (0.001 sec)
-```
-
-The charset `latin1` means the db is encoded in the `latin1` encoding which does not support utf-8 characters.
-
-(The following guide is based on [this thread from stackoverflow](https://dba.stackexchange.com/a/104866))
-
-### 0. Backup your database
-
-Before attempting any conversion, please [back up your database]({{< ref "backups.md">}}).
-
-### 1. Create a pre-conversion script
-
-Copy the following sql statements in a file called `preAlterTables.sql` and replace all occurrences of `vikunja` with the name of your database:
-
-```sql
-use information_schema;
-SELECT concat("ALTER DATABASE `",table_schema,"` CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;") as _sql 
-FROM `TABLES` where table_schema like 'vikunja' and TABLE_TYPE='BASE TABLE' group by table_schema;
-SELECT concat("ALTER TABLE `",table_schema,"`.`",table_name,"` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;") as _sql  
-FROM `TABLES` where table_schema like 'vikunja' and TABLE_TYPE='BASE TABLE' group by table_schema, table_name;
-SELECT concat("ALTER TABLE `",table_schema,"`.`",table_name, "` CHANGE `",column_name,"` `",column_name,"` ",data_type,"(",character_maximum_length,") CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci",IF(is_nullable="YES"," NULL"," NOT NULL"),";") as _sql 
-FROM `COLUMNS` where table_schema like 'vikunja' and data_type in ('varchar','char');
-SELECT concat("ALTER TABLE `",table_schema,"`.`",table_name, "` CHANGE `",column_name,"` `",column_name,"` ",data_type," CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci",IF(is_nullable="YES"," NULL"," NOT NULL"),";") as _sql 
-FROM `COLUMNS` where table_schema like 'vikunja' and data_type in ('text','tinytext','mediumtext','longtext');
-```
-
-### 2. Run the pre-conversion script
-
-Running this will create the actual migration script for your particular database structure and save it in a file called `alterTables.sql`:
-
-```
-mysql -uroot < preAlterTables.sql | egrep '^ALTER' > alterTables.sql
-```
-
-### 3. Convert the database
-
-At this point converting is just a matter of executing the previously generated sql script:
-
-```
-mysql -uroot < alterTables.sql
-```
-
-### 4. Verify it was successfully converted
-
-If everything worked as intended, your db collation should now look like this:
-
-```sql
-SELECT default_character_set_name FROM information_schema.SCHEMATA WHERE schema_name = 'vikunja';
-```
-
-Should get you:
-
-```
-+----------------------------+
-| default_character_set_name |
-+----------------------------+
-| utf8mb4                    |
-+----------------------------+
-1 row in set (0.001 sec)
-```

docs/content/doc/setup/versions.md

@@ -1,45 +0,0 @@
----
-date: "2022-07-07:00:00+02:00"
-title: "Versions"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "setup"
----
-
-# Vikunja Versions
-
-The Vikunja api and frontend are available in two different release flavors.
-
-{{< table_of_contents >}}
-
-## Stable
-
-Stable releases have a fixed version number like `0.18.2` and are published at irregular intervals whenever a new version is ready.
-They receive few bugfixes and security patches.
-
-We use [Semantic Versioning](https://semver.org) for these releases.
-
-## Unstable
-
-Unstable versions are build every time a PR is merged or a commit to the main development branch is made.
-As such, they contain the current development code and are more likely to have bugs.
-There might be multiple new such builds a day.
-
-Versions contain the last stable version, the number of commits since then and the commit the currently running binary was built from.
-They look like this: `v0.18.1+269-5cc4927b9e`
-
-The demo instance at [try.vikunja.io](https://try.vikunja.io) automatically updates and always runs the last unstable build.
-
-## Switching between versions
-
-First you should create a backup of your current setup!
-
-Switching between versions is the same process as [upgrading]({{< ref install.md >}}#updating).
-Simply replace the stable binary with an unstable one or vice-versa.
-
-For installations using docker, it is as simple as using the `unstable` or `latest` tag to switch between versions.
-
-**Note:** While switching from stable to unstable should work without any problem, switching back might work but is not recommended and might break your instance.
-To switch from unstable back to stable the best way is to wait for the next stable release after the used unstable build and then upgrade to that.

docs/content/doc/usage/api.md

@@ -1,19 +0,0 @@
----
-date: "2019-02-12:00:00+02:00"
-title: "API Documentation"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "usage"
----
-
-# API Documentation
-
-You can find the api docs under `http://vikunja.tld/api/v1/docs` of your instance.<br  />
-A public instance is available on [try.vikunja.io](https://try.vikunja.io/api/v1/docs).
-
-These docs are autogenerated from annotations in the code with swagger.
-
-The specification is hosted at `http://vikunja.tld/api/v1/docs.json`.
-You can use this to embed it into other OpenAPI compatible applications if you want.

docs/content/doc/usage/caldav.md

@@ -1,144 +0,0 @@
----
-date: "2019-05-12:00:00+01:00"
-title: "CalDAV"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "usage"
----
-
-# CalDAV
-
-> **Warning:** The CalDAV integration is in an early alpha stage and has bugs.
-> It works well with some clients while having issues with others.
-> If you encounter issues, please [report them](https://code.vikunja.io/api/issues/new?body=[caldav])
-
-Vikunja supports managing tasks via the [caldav VTODO](https://tools.ietf.org/html/rfc5545#section-3.6.2) extension.
-
-{{< table_of_contents >}}
-
-## URLs
-
-All urls are located under the `/dav` subspace.
-
-Urls are:
-
-* `/principals/<username>/`: Returns urls for project discovery. *Use this url to initially make connections to new clients.*
-* `/projects/`: Used to manage projects
-* `/projects/<Project ID>/`: Used to manage a single project
-* `/projects/<Project ID>/<Task UID>`: Used to manage a task on a project
-
-## Supported properties
-
-Vikunja currently supports the following properties:
-
-* `UID`
-* `SUMMARY`
-* `DESCRIPTION`
-* `PRIORITY`
-* `CATEGORIES`
-* `COMPLETED`
-* `CREATED` (only Vikunja → Client)
-* `DUE`
-* `DURATION`
-* `DTSTAMP`
-* `DTSTART`
-* `LAST-MODIFIED` (only Vikunja → Client)
-* `RRULE` (Recurrence) (only Vikunja → Client)
-* `VALARM` (Reminders)
-
-Vikunja **currently does not** support these properties:
-
-* `ATTACH`
-* `CLASS`
-* `COMMENT`
-* `CONTACT`
-* `GEO`
-* `LOCATION`
-* `ORGANIZER` (disabled)
-* `PERCENT-COMPLETE`
-* `RECURRENCE-ID`
-* `RELATED-TO`
-* `RESOURCES`
-* `SEQUENCE`
-* `STATUS`
-* `URL`
-
-## Tested Clients
-
-### Working
-
-* [Evolution](https://wiki.gnome.org/Apps/Evolution/)
-* [OpenTasks](https://opentasks.app/) & [DAVx⁵](https://www.davx5.com/)
-* [Tasks (Android)](https://tasks.org/)
-
-### Not working
-
-* [Thunderbird (68)](https://www.thunderbird.net/)
-* iOS CalDAV Sync (See [#753](https://kolaente.dev/vikunja/vikunja/issues/753))
-
-## Dev logs
-
-The whole thing is not optimized at all and probably pretty inefficient.
-
-Request body and headers are logged if the debug output is enabled.
-
-```
-Creating a new task:
-PUT /dav/lists/1/cd4dd0e1b3c19cc9d787829b6e08be536e3df3a4.ics
-
-Body:
-
-BEGIN:VCALENDAR
-CALSCALE:GREGORIAN
-PRODID:-//Ximian//NONSGML Evolution Calendar//EN
-VERSION:2.0
-BEGIN:VTODO
-UID:cd4dd0e1b3c19cc9d787829b6e08be536e3df3a4
-DTSTAMP:20190508T134538Z
-SUMMARY:test2000
-PRIORITY:0
-CLASS:PUBLIC
-CREATED:20190508T134710Z
-LAST-MODIFIED:20190508T134710Z
-END:VTODO
-END:VCALENDAR
-
-
-Marking a task as done:
-
-BEGIN:VCALENDAR
-CALSCALE:GREGORIAN
-PRODID:-//Ximian//NONSGML Evolution Calendar//EN
-VERSION:2.0
-BEGIN:VTODO
-UID:3ada92f28b4ceda38562ebf047c6ff05400d4c572352a
-DTSTAMP:20190511T183631
-DTSTART:19700101T000000
-DTEND:19700101T000000
-SUMMARY:sdgs
-ORGANIZER;CN=:user
-CREATED:20190511T183631
-PRIORITY:0
-LAST-MODIFIED:20190512T193428Z
-COMPLETED:20190512T193428Z
-PERCENT-COMPLETE:100
-STATUS:COMPLETED
-END:VTODO
-END:VCALENDAR
-
-Requests from the app:::
-
-[CALDAV] Request Body: <?xml version="1.0" encoding="UTF-8" ?><propfind xmlns="DAV:" xmlns:CAL="urn:ietf:params:xml:ns:caldav" xmlns:CARD="urn:ietf:params:xml:ns:carddav"><prop><current-user-principal /></prop></propfind>
-[CALDAV] GetResources: rpath: /dav/
-2019-05-18T23:25:49.971140654+02:00: WEB 	▶ 192.168.1.134  PROPFIND 207 /dav/ 1.021705664s - okhttp/3.12.2
-
-[CALDAV] Request Body: <?xml version="1.0" encoding="UTF-8" ?><propfind xmlns="DAV:" xmlns:CAL="urn:ietf:params:xml:ns:caldav" xmlns:CARD="urn:ietf:params:xml:ns:carddav"><prop><CAL:calendar-home-set /></prop></propfind>
-[CALDAV] GetResources: rpath: /dav/
-2019-05-18T23:25:52.166996113+02:00: WEB 	▶ 192.168.1.134  PROPFIND 207 /dav/ 1.042834467s - okhttp/3.12.2
-
-And then it just stops.
-... and complains about not being able to find the home set
-... without even requesting it...
-```

docs/content/doc/usage/cli.md

@@ -1,207 +0,0 @@
----
-date: "2019-03-31:00:00+01:00"
-title: "CLI"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "usage"
----
-
-# Command line interface
-
-You can interact with Vikunja using its `cli` interface.<br />
-The following commands are available:
-
-* [dump](#dump)
-* [help](#help)
-* [migrate](#migrate)
-* [restore](#restore)
-* [testmail](#testmail)
-* [user](#user)
-* [version](#version)
-* [web](#web)
-
-If you don't specify a command, the [`web`](#web) command will be executed.
-
-All commands use the same standard [config file]({{< ref "../setup/config.md">}}).
-
-## Using the cli in docker
-
-When running Vikunja in docker, you'll need to execute all commands in the `api` container.
-Instead of running the `vikunja` binary directly, run it like this:
-
-```sh
-docker exec <name of the vikunja api container> /app/vikunja/vikunja <subcommand>
-```
-
-### `dump`
-
-Creates a zip file with all vikunja-related files.
-This includes config, version, all files and the full database.
-
-Usage:
-```
-$ vikunja dump
-```
-
-### `help`
-
-Shows more detailed help about any command.
-
-Usage:
-
-```
-$ vikunja help [command]
-```
-
-### `migrate`
-
-Run all database migrations which didn't already run.
-
-Usage:
-```
-$ vikunja migrate [flags]
-$ vikunja migrate [command]
-```
-
-#### `migrate list`
-
-Shows a list with all database migrations.
-
-Usage:
-```
-$ vikunja migrate list
-```
-
-#### `migrate rollback`
-
-Roll migrations back until a certain point.
-
-Usage:
-```
-$ vikunja migrate rollback [flags]
-```
-
-Flags:
-* `-n`, `--name` string: The id of the migration you want to roll back until.
-
-### `restore`
-
-Restores a previously created dump from a zip file, see `dump`.
-
-Usage:
-```
-$ vikunja restore <path to dump zip file>
-```
-
-### `testmail`
-
-Sends a test mail using the configured smtp connection.
-
-Usage:
-```
-$ vikunja testmail <email to send the test mail to>
-```
-
-### `user`
-
-Bundles a few commands to manage users.
-
-#### `user change-status`
-
-Enable or disable a user. Will toggle the current status if no flag (`--enable` or `--disable`) is provided.
-
-Usage:
-```
-$ vikunja user change-status <user id> <flags>
-```
-
-Flags:
-* `-d`, `--disable`: Disable the user.
-* `-e`, `--enable`: Enable the user.
-
-#### `user create`
-
-Create a new user.
-
-Usage:
-```
-$ vikunja user create <flags>
-```
-
-Flags:
-* `-a`, `--avatar-provider`: The avatar provider of the new user. Optional.
-* `-e`, `--email`: The email address of the new user.
-* `-p`, `--password`: The password of the new user. You will be asked to enter it if not provided through the flag.
-* `-u`, `--username`: The username of the new user.
-
-#### `user delete`
-
-Start the user deletion process.
-If called without the `--now` flag, this command will only trigger an email to the user in order for them to confirm and start the deletion process (this is the same behavoir as if the user requested their deletion via the web interface).
-With the flag the user is deleted **immediately**.
-
-**USE WITH CAUTION.**
-
-```
-$ vikunja user delete <id> <flags>
-```
-
-Flags:
-* `-n`, `--now` If provided, deletes the user immediately instead of emailing them first.
-
-#### `user list`
-
-Shows a list of all users.
-
-Usage:
-```
-$ vikunja user list
-```
-
-#### `user reset-password`
-
-Reset a users password, either through mailing them a reset link or directly.
-
-Usage:
-```
-$ vikunja user reset-password <flags>
-```
-
-Flags:
-* `-d`, `--direct`: If provided, reset the password directly instead of sending the user a reset mail.
-* `-p`, `--password`: The new password of the user. Only used in combination with --direct. You will be asked to enter it if not provided through the flag.
-
-#### `user update`
-
-Update an existing user.
-
-Usage:
-```
-$ vikunja user update <user id>
-```
-
-Flags:
-* `-a`, `--avatar-provider`: The new avatar provider of the new user.
-* `-e`, `--email`: The new email address of the user.
-* `-u`, `--username`: The new username of the user.
-
-### `version`
-
-Prints the version of Vikunja.
-This is either the semantic version (something like `0.7`) or version + git commit hash.
-
-Usage:
-```
-$ vikunja version
-```
-
-### `web`
-
-Starts Vikunja's REST api server.
-
-Usage:
-```
-$ vikunja web
-```

docs/content/doc/usage/errors.md

@@ -1,165 +0,0 @@
----
-date: "2019-02-12:00:00+02:00"
-title: "Errors"
-draft: false
-type: "doc"
-menu:
-sidebar:
-parent: "usage"
----
-
-# Errors
-
-This document describes the different errors Vikunja can return.
-
-{{< table_of_contents >}}
-
-## Generic
-
-| ErrorCode | HTTP Status Code | Description |
-|-----------|------------------|-------------|
-| 0001 | 403 | Generic forbidden error. |
-
-## User
-
-| ErrorCode | HTTP Status Code | Description |
-|-----------|------------------|-------------|
-| 1001      | 400 | A user with this username already exists. |
-| 1002      | 400 | A user with this email address already exists. |
-| 1004      | 400 | No username and password specified. |
-| 1005      | 404 | The user does not exist. |
-| 1006      | 400 | Could not get the user id. |
-| 1008      | 412 | No password reset token provided. |
-| 1009      | 412 | Invalid password reset token. |
-| 1010      | 412 | Invalid email confirm token. |
-| 1011      | 412 | Wrong username or password. |
-| 1012      | 412 | Email address of the user not confirmed. |
-| 1013      | 412 | New password is empty. |
-| 1014      | 412 | Old password is empty. |
-| 1015      | 412 | Totp is already enabled for this user. |
-| 1016      | 412 | Totp is not enabled for this user. |
-| 1017      | 412 | The provided Totp passcode is invalid. |
-| 1018      | 412 | The provided user avatar provider type setting is invalid. |
-| 1019      | 412 | No openid email address was provided. |
-| 1020      | 412 | This user account is disabled. |
-| 1021      | 412 | This account is managed by a third-party authentication provider. |
-| 1021      | 412 | The username must not contain spaces. |
-| 1022      | 412 | The custom scope set by the OIDC provider is malformed. Please make sure the openid provider sets the data correctly for your scope. Check especially to have set an oidcID. |
-
-## Validation
-
-| ErrorCode | HTTP Status Code | Description |
-|-----------|------------------|-------------|
-| 2001 | 400 | ID cannot be empty or 0. |
-| 2002 | 400 | Some of the request data was invalid. The response contains an aditional array with all invalid fields. |
-
-## Project
-
-| ErrorCode | HTTP Status Code | Description                                                                                                                         |
-|-----------|------------------|-------------------------------------------------------------------------------------------------------------------------------------|
-| 3001      | 404 | The project does not exist.                                                                                                         |
-| 3004      | 403 | The user needs to have read permissions on that project to perform that action.                                                     |
-| 3005      | 400 | The project title cannot be empty.                                                                                                  |
-| 3006      | 404 | The project share does not exist.                                                                                                   |
-| 3007      | 400 | A project with this identifier already exists.                                                                                      |
-| 3008      | 412 | The project is archived and can therefore only be accessed read only. This is also true for all tasks associated with this project. |
-| 3009      | 412 | The project cannot belong to a dynamically generated parent project like "Favorites".                                               |
-| 3010      | 412 | This project cannot be a child of itself.                                                                                           |
-| 3011      | 412 | This project cannot have a cyclic relationship to a parent project.                                                                 |
-| 3012      | 412 | This project cannot be deleted because a user has set it as their default project.                                                  |
-| 3013      | 412 | This project cannot be archived because a user has set it as their default project.                                                 |
-
-## Task
-
-| ErrorCode | HTTP Status Code | Description                                                                |
-|-----------|------------------|----------------------------------------------------------------------------|
-| 4001 | 400 | The project task text cannot be empty.                                     |
-| 4002 | 404 | The project task does not exist.                                           |
-| 4003 | 403 | All bulk editing tasks must belong to the same project.                    |
-| 4004 | 403 | Need at least one task when bulk editing tasks.                            |
-| 4005 | 403 | The user does not have the right to see the task.                          |
-| 4006 | 403 | The user tried to set a parent task as the task itself.                    |
-| 4007 | 400 | The user tried to create a task relation with an invalid kind of relation. |
-| 4008 | 409 | The user tried to create a task relation which already exists.             |
-| 4009 | 404 | The task relation does not exist.                                          |
-| 4010 | 400 | Cannot relate a task with itself.                                          |
-| 4011 | 404 | The task attachment does not exist.                                        |
-| 4012 | 400 | The task attachment is too large.                                          |
-| 4013 | 400 | The task sort param is invalid.                                            |
-| 4014 | 400 | The task sort order is invalid.                                            |
-| 4015 | 404 | The task comment does not exist.                                           |
-| 4016 | 400 | Invalid task field.                                                        |
-| 4017 | 400 | Invalid task filter comparator.                                            |
-| 4018 | 400 | Invalid task filter concatinator.                                          |
-| 4019 | 400 | Invalid task filter value.                                                 |
-| 4020 | 400 | The provided attachment does not belong to that task.                      |
-| 4021 | 400 | This user is already assigned to that task.                                |
-| 4022 | 400 | The task has a relative reminder which does not specify relative to what.  |
-| 4023 | 409 | Tried to create a task relation which would create a cycle.                |
-
-## Team
-
-| ErrorCode | HTTP Status Code | Description                                                          |
-|-----------|------------------|----------------------------------------------------------------------|
-| 6001 | 400 | The team name cannot be empty.                                       |
-| 6002 | 404 | The team does not exist.                                             |
-| 6004 | 409 | The team already has access to that project.                         |
-| 6005 | 409 | The user is already a member of that team.                           |
-| 6006 | 400 | Cannot delete the last team member.                                  |
-| 6007 | 403 | The team does not have access to the project to perform that action. |
-| 6008 | 400 | There are no teams found with that team name. |
-| 6009 | 400 | There is no oidc team with that team name and oidcId. |
-| 6010 | 400 | There are no oidc teams found for the user. |
-
-## User Project Access
-
-| ErrorCode | HTTP Status Code | Description |
-|-----------|------------------|-------------|
-| 7002 | 409 | The user already has access to that project. |
-| 7003 | 403 | The user does not have access to that project. |
-
-## Label
-
-| ErrorCode | HTTP Status Code | Description |
-|-----------|------------------|-------------|
-| 8001 | 403 | This label already exists on that task. |
-| 8002 | 404 | The label does not exist. |
-| 8003 | 403 | The user does not have access to this label. |
-
-## Right
-
-| ErrorCode | HTTP Status Code | Description |
-|-----------|------------------|-------------|
-| 9001 | 403 | The right is invalid. |
-
-## Kanban
-
-| ErrorCode | HTTP Status Code | Description |
-|-----------|------------------|-------------|
-| 10001 | 404 | The bucket does not exist. |
-| 10002 | 400 | The bucket does not belong to that project. |
-| 10003 | 412 | You cannot remove the last bucket on a project. |
-| 10004 | 412 | You cannot add the task to this bucket as it already exceeded the limit of tasks it can hold. |
-| 10005 | 412 | There can be only one done bucket per project. |
-
-## Saved Filters
-
-| ErrorCode | HTTP Status Code | Description |
-|-----------|------------------|-------------|
-| 11001 | 404 | The saved filter does not exist. |
-| 11002 | 412 | Saved filters are not available for link shares. |
-
-## Subscriptions
-
-| ErrorCode | HTTP Status Code | Description |
-|-----------|------------------|-------------|
-| 12001 | 412 | The subscription entity type is invalid. |
-| 12002 | 412 | The user is already subscribed to the entity itself or a parent entity. |
-
-## Link Shares
-
-| ErrorCode | HTTP Status Code | Description                                                                    |
-|-----------|------------------|--------------------------------------------------------------------------------|
-| 13001 | 412 | This link share requires a password for authentication, but none was provided. |
-| 13002 | 403 | The provided link share password is invalid.                                   |
-| 13003 | 400 | The provided link share token is invalid.                                      |

docs/content/doc/usage/n8n.md

@@ -1,43 +0,0 @@
----
-title: "n8n"
-date: 2023-10-24T19:31:35+02:00
-draft: false
-menu:
-    sidebar:
-        parent: "usage"
----
-
-# Using Vikunja with n8n
-
-Vikunja maintains a [community node](https://github.com/go-vikunja/n8n-vikunja-nodes) for [n8n](https://n8n.io),
-allowing you to easily integrate Vikunja with all kinds of other tools and services.
-
-{{< table_of_contents >}}
-
-## Installation
-
-To install the node in your n8n installation:
-
-1. In your n8n instance, go to **Settings > Community Nodes**.
-2. Select Install.
-3. Enter `n8n-nodes-vikunja` as the npm Package Name
-4. Agree to the risks of using community nodes: select I understand the risks of installing unverified code from a
-   public source.
-5. Select Install. n8n installs the node, and returns to the Community Nodes list in Settings.
-6. Vikunja actions and triggers are now available in n8n.
-
-[Official n8n docs about the installation](https://docs.n8n.io/integrations/community-nodes/installation/)
-
-## Authentication
-
-To authenticate your automation against Vikunja:
-
-1. In Vikunja, go to **Settings > API Tokens** and create a new token. Use all scopes for the kind of task you want to
-   do. \
-   *Note:* If you want to use the webhook trigger node, the api token should have permissions to create, read and delete
-   webhooks.
-2. Now in n8n, go to **Credentials** and then click on **Add Credential**.
-3. Search for `Vikunja API` and click *Continue*
-4. Enter the API key you created in step 1.
-5. Enter the API URL of your Vikunja instance, with `/api/v1` suffix.
-6. When you now create a Vikunja node, select the created credentials.

docs/content/doc/usage/relation_kinds.md

@@ -1,25 +0,0 @@
----
-date: "2019-09-25:00:00+02:00"
-title: "Task Relation kinds"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "usage"
----
-
-# Available task relation kinds
-
-| Code | Description | Opposite of |
-|------|-------------|-------------|
-| `subtask` | Task is a subtask of the other task.       | `parenttask` |
-| `parenttask` | Task is a parent task of the other task. | `subtask` |
-| `related` | Both tasks are related to each other.<br  /> How is not more specified. | ⸺ |
-| `duplicateof` | Task is a duplicate of the other task. | `duplicates` |
-| `duplicates` | Task duplicates the other task. | `duplicateof` |
-| `blocking` | Task is blocking the other task. | `blocked` |
-| `blocked` | Task is blocked by the other task. | `blocking` |
-| `precedes` | Task precedes the other task. | `follows` |
-| `follows` | Task follows the other task. | `precedes` |
-| `copiedfrom` | Task is copied from the other task. | `copiedto` |
-| `copiedto` | Task is copied to the other task. | `copiedfrom` |

docs/content/doc/usage/rights.md

@@ -1,29 +0,0 @@
----
-date: "2019-02-12:00:00+02:00"
-title: "Rights"
-draft: false
-type: "doc"
-menu:
-  sidebar:
-    parent: "usage"
----
-
-# Project rights for teams and users
-
-Whenever you share a project with a user or team, you can specify a `rights` parameter.
-This parameter controls the rights that team or user is going to have (or has, if you request the current sharing status).
-
-Rights are being specified using integers.
-
-The following values are possible:
-
-| Right (int) | Meaning                                                                                         |
-|-------------|-------------------------------------------------------------------------------------------------|
-| 0 (Default) | Read only. Anything which is shared with this right cannot be edited.                           |
-| 1           | Read and write. Projects shared with this right can be read and written to by the team or user. |
-| 2           | Admin. Can do anything like read and write, but can additionally manage sharing options.        |
-
-## Team admins
-
-When adding or querying a team, every member has an additional boolean value stating if it is admin or not.
-A team admin can also add and remove team members and also change whether a user in the team is admin or not.

docs/content/doc/usage/webhooks.md

@@ -1,58 +0,0 @@
----
-title: "Webhooks"
-date: 2023-10-17T19:51:32+02:00
-draft: false
-type: doc
-menu:
-  sidebar:
-    parent: "usage"
----
-
-# Webhooks
-
-Starting with version 0.22.0, Vikunja allows you to define webhooks to notify other services of events happening within Vikunja.
-
-{{< table_of_contents >}}
-
-## How to create webhooks
-
-To create a webhook, in the project options select "Webhooks". The form will allow you to create and modify webhooks.
-
-Check out [the api docs](https://try.vikunja.io/api/v1/docs#tag/webhooks) for information about how to create webhooks programatically.
-
-## Available events and their payload
-
-All events registered as webhook events in [the event listeners definition](https://kolaente.dev/vikunja/vikunja/src/branch/main/pkg/models/listeners.go#L69) can be used as webhook target.
-
-A webhook payload will look similar to this:
-
-```json
-{
-	"event_name": "task.created",
-	"time": "2023-10-17T19:39:32.924194436+02:00",
-	"data": {}
-}
-```
-
-The `data` property will contain the raw event data as it was registered in the `listeners.go` file.
-
-The `time` property holds the time when the webhook payload data was sent.
-It always uses the ISO 8601 format with date, time and time zone offset.
-
-## Security considerations
-
-### Signing
-
-Vikunja allows you to provide a secret when creating the webhook.
-If you set a secret, all outgoing webhook requests will contain an `X-Vikunja-Signature` header with an HMAC signature over the webhook json payload.
-
-Check out [webhooks.fyi](https://webhooks.fyi/security/hmac) for more information about how to validate the HMAC signature.
-
-### Hosting webhook infrastructure
-
-Vikunja has support to use [mole](https://github.com/frain-dev/mole) as a proxy for outgoing webhook requests.
-This allows you to prevent SSRF attacts on your own infrastructure.
-
-You should use this and [configure it appropriately]({{< ref "../setup/config.md">}}#webhooks) if you're not the only one using your Vikunja instance.
-
-Check out [webhooks.fyi](https://webhooks.fyi/best-practices/webhook-providers#implement-security-on-egress-communication) for more information about the attack vector and reasoning to prevent this.

docs/nginx.conf

@@ -1,33 +0,0 @@
-server {
-    listen       80;
-    server_name  localhost;
-
-    charset utf-8;
-
-    location / {
-        root   /usr/share/nginx/html;
-        index  index.html index.htm;
-    }
-
-    error_page 404 /docs/404.html;
-    error_page 500 502 503 504  /50x.html;
-    location = /50x.html {
-        root   /usr/share/nginx/html;
-    }
-
-    location /docs/contact {
-        return 301 $scheme://vikunja.io/en/contact;
-    }
-    
-    location /docs/docs {
-        return 301 $scheme://vikunja.io/docs;
-    }
-    
-    location /docs/install-backend {
-        return 301 $scheme://vikunja.io/docs/installing;
-    }
-
-    location /docs/install-frontend {
-        return 301 $scheme://vikunja.io/docs/installing;
-    }
-}

frontend/.envrc

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

frontend/.eslintrc.cjs

@@ -1,60 +0,0 @@
-/* eslint-env node */
-require('@rushstack/eslint-patch/modern-module-resolution')
-
-module.exports = {
-	'root': true,
-	'env': {
-		'browser': true,
-		'es2022': true,
-		'node': true,
-	},
-	'extends': [
-		'eslint:recommended',
-		'plugin:vue/vue3-recommended',
-		'@vue/eslint-config-typescript/recommended',
-	],
-	'rules': {
-		'quotes': ['error', 'single'],
-		'comma-dangle': ['error', 'always-multiline'],
-		'semi': ['error', 'never'],
-
-		'vue/v-on-event-hyphenation': ['warn', 'never', { 'autofix': true }],
-		'vue/multi-word-component-names': 'off',
-
-		// uncategorized rules:
-		'vue/component-api-style': ['error', ['script-setup']],
-		'vue/component-name-in-template-casing': ['warn', 'PascalCase'],
-		'vue/custom-event-name-casing': ['error', 'camelCase'],
-		'vue/define-macros-order': 'error',
-		'vue/match-component-file-name': ['error', {
-			'extensions': ['.js', '.jsx', '.ts', '.tsx', '.vue'],
-			'shouldMatchCase': true,
-		}],
-		'vue/no-boolean-default': ['warn', 'default-false'],
-		'vue/match-component-import-name': 'error',
-		'vue/prefer-separate-static-class': 'warn',
-
-		'vue/padding-line-between-blocks': 'error',
-		'vue/next-tick-style': ['error', 'promise'],
-		'vue/block-lang': [
-			'error',
-			{ 'script': { 'lang': 'ts' } },
-		],
-		'vue/no-required-prop-with-default': ['error', { 'autofix': true }],
-		'vue/no-duplicate-attr-inheritance': 'error',
-		'vue/no-empty-component-block': 'error',
-		'vue/html-indent': ['error', 'tab'],
-
-		// vue3
-		'vue/no-ref-object-destructure': 'error',
-	},
-	'parser': 'vue-eslint-parser',
-	'parserOptions': {
-		'parser': '@typescript-eslint/parser',
-		'ecmaVersion': 'latest',
-	},
-	'ignorePatterns': [
-		'*.test.*',
-		'cypress/*',
-	],
-}

frontend/.gitignore

@@ -10,10 +10,10 @@ stats.html
 
 node_modules
 .DS_Store
-/dist*
+dist
 coverage
 *.zip
-.direnv/
+.vite/
 
 # Test files
 cypress/screenshots

frontend/.npmrc

@@ -1,14 +0,0 @@
-fetch-timeout=100000
-
-# pnpm settings
-# The following settings prepare for the new default value of pnpm 8
-# they can be removed directly after having moved to pnpm 8
-auto-install-peers=true
-dedupe-peer-dependents=true
-resolve-peers-from-workspace-root=true
-save-workspace-protocol=rolling
-resolution-mode=lowest-direct
-publishConfig.linkDirectory=true
-
-# remove some time after having moved to pnpm 8
-use-lockfile-v6=true

frontend/.nvmrc

@@ -1 +1 @@
-20.11.0
+22.11.0

frontend/cypress/e2e/project/prepareProjects.ts

@@ -1,15 +1,50 @@
 import {ProjectFactory} from '../../factories/project'
 import {TaskFactory} from '../../factories/task'
+import {ProjectViewFactory} from "../../factories/project_view";
+
+export function createDefaultViews(projectId) {
+	ProjectViewFactory.truncate()
+	const list = ProjectViewFactory.create(1, {
+		id: 1,
+		project_id: projectId,
+		view_kind: 0,
+	}, false)
+	const gantt = ProjectViewFactory.create(1, {
+		id: 2,
+		project_id: projectId,
+		view_kind: 1,
+	}, false)
+	const table = ProjectViewFactory.create(1, {
+		id: 3,
+		project_id: projectId,
+		view_kind: 2,
+	}, false)
+	const kanban = ProjectViewFactory.create(1, {
+		id: 4,
+		project_id: projectId,
+		view_kind: 3,
+		bucket_configuration_mode: 1,
+	}, false)
+
+	return [
+		list[0],
+		gantt[0],
+		table[0],
+		kanban[0],
+	]
+}
 
 export function createProjects() {
 	const projects = ProjectFactory.create(1, {
 		title: 'First Project'
 	})
 	TaskFactory.truncate()
+	projects.views = createDefaultViews(projects[0].id)
 	return projects
 }
 
-export function prepareProjects(setProjects = (...args: any[]) => {}) {
+export function prepareProjects(setProjects = (...args: any[]) => {
+}) {
 	beforeEach(() => {
 		const projects = createProjects()
 		setProjects(projects)

frontend/cypress/e2e/project/project-history.spec.ts

@@ -2,6 +2,7 @@ import {createFakeUserAndLogin} from '../../support/authenticateUser'
 
 import {ProjectFactory} from '../../factories/project'
 import {prepareProjects} from './prepareProjects'
+import {ProjectViewFactory} from '../../factories/project_view'
 
 describe('Project History', () => {
 	createFakeUserAndLogin()
@@ -11,24 +12,31 @@ describe('Project History', () => {
 		cy.intercept(Cypress.env('API_URL') + '/projects*').as('loadProjectArray')
 		cy.intercept(Cypress.env('API_URL') + '/projects/*').as('loadProject')
 		
-		const projects = ProjectFactory.create(6)
+		const projects = ProjectFactory.create(7)
+		ProjectViewFactory.truncate()
+		projects.forEach(p => ProjectViewFactory.create(1, {
+			id: p.id,
+			project_id: p.id,
+		}, false))
 
 		cy.visit('/')
 		cy.wait('@loadProjectArray')
 		cy.get('body')
 			.should('not.contain', 'Last viewed')
 
-		cy.visit(`/projects/${projects[0].id}`)
+		cy.visit(`/projects/${projects[0].id}/${projects[0].id}`)
 		cy.wait('@loadProject')
-		cy.visit(`/projects/${projects[1].id}`)
+		cy.visit(`/projects/${projects[1].id}/${projects[1].id}`)
 		cy.wait('@loadProject')
-		cy.visit(`/projects/${projects[2].id}`)
+		cy.visit(`/projects/${projects[2].id}/${projects[2].id}`)
 		cy.wait('@loadProject')
-		cy.visit(`/projects/${projects[3].id}`)
+		cy.visit(`/projects/${projects[3].id}/${projects[3].id}`)
 		cy.wait('@loadProject')
-		cy.visit(`/projects/${projects[4].id}`)
+		cy.visit(`/projects/${projects[4].id}/${projects[4].id}`)
 		cy.wait('@loadProject')
-		cy.visit(`/projects/${projects[5].id}`)
+		cy.visit(`/projects/${projects[5].id}/${projects[5].id}`)
+		cy.wait('@loadProject')
+		cy.visit(`/projects/${projects[6].id}/${projects[6].id}`)
 		cy.wait('@loadProject')
 
 		// cy.visit('/')
@@ -46,5 +54,6 @@ describe('Project History', () => {
 			.should('contain', projects[3].title)
 			.should('contain', projects[4].title)
 			.should('contain', projects[5].title)
+			.should('contain', projects[6].title)
 	})
 })

frontend/cypress/e2e/project/project-view-gantt.spec.ts

@@ -11,7 +11,7 @@ describe('Project View Gantt', () => {
 
 	it('Hides tasks with no dates', () => {
 		const tasks = TaskFactory.create(1)
-		cy.visit('/projects/1/gantt')
+		cy.visit('/projects/1/2')
 
 		cy.get('.g-gantt-rows-container')
 			.should('not.contain', tasks[0].title)
@@ -25,7 +25,7 @@ describe('Project View Gantt', () => {
 		nextMonth.setDate(1)
 		nextMonth.setMonth(9)
 
-		cy.visit('/projects/1/gantt')
+		cy.visit('/projects/1/2')
 
 		cy.get('.g-timeunits-container')
 			.should('contain', format(now, 'MMMM'))
@@ -38,7 +38,7 @@ describe('Project View Gantt', () => {
 			start_date: now.toISOString(),
 			end_date: new Date(new Date(now).setDate(now.getDate() + 4)).toISOString(),
 		})
-		cy.visit('/projects/1/gantt')
+		cy.visit('/projects/1/2')
 
 		cy.get('.g-gantt-rows-container')
 			.should('not.be.empty')
@@ -50,10 +50,10 @@ describe('Project View Gantt', () => {
 			start_date: null,
 			end_date: null,
 		})
-		cy.visit('/projects/1/gantt')
+		cy.visit('/projects/1/2')
 
-		cy.get('.gantt-options .fancycheckbox')
-			.contains('Show tasks which don\'t have dates set')
+		cy.get('.gantt-options .fancy-checkbox')
+			.contains('Show tasks without dates')
 			.click()
 
 		cy.get('.g-gantt-rows-container')
@@ -69,7 +69,7 @@ describe('Project View Gantt', () => {
 			start_date: now.toISOString(),
 			end_date: new Date(new Date(now).setDate(now.getDate() + 4)).toISOString(),
 		})
-		cy.visit('/projects/1/gantt')
+		cy.visit('/projects/1/2')
 
 		cy.get('.g-gantt-rows-container .g-gantt-row .g-gantt-row-bars-container div .g-gantt-bar')
 			.first()
@@ -83,7 +83,7 @@ describe('Project View Gantt', () => {
 		const now = Date.UTC(2022, 10, 9)
 		cy.clock(now, ['Date'])
 
-		cy.visit('/projects/1/gantt')
+		cy.visit('/projects/1/2')
 
 		cy.get('.project-gantt .gantt-options .field .control input.input.form-control')
 			.click()
@@ -99,7 +99,7 @@ describe('Project View Gantt', () => {
 	})
 
 	it('Should change the date range based on date query parameters', () => {
-		cy.visit('/projects/1/gantt?dateFrom=2022-09-25&dateTo=2022-11-05')
+		cy.visit('/projects/1/2?dateFrom=2022-09-25&dateTo=2022-11-05')
 
 		cy.get('.g-timeunits-container')
 			.should('contain', 'September 2022')
@@ -115,7 +115,7 @@ describe('Project View Gantt', () => {
 			start_date: formatISO(now),
 			end_date: formatISO(now.setDate(now.getDate() + 4)),
 		})
-		cy.visit('/projects/1/gantt')
+		cy.visit('/projects/1/2')
 
 		cy.get('.gantt-container .g-gantt-chart .g-gantt-row-bars-container .g-gantt-bar')
 			.dblclick()

frontend/cypress/e2e/project/project-view-kanban.spec.ts

@@ -4,35 +4,64 @@ import {BucketFactory} from '../../factories/bucket'
 import {ProjectFactory} from '../../factories/project'
 import {TaskFactory} from '../../factories/task'
 import {prepareProjects} from './prepareProjects'
+import {ProjectViewFactory} from "../../factories/project_view";
+import {TaskBucketFactory} from "../../factories/task_buckets";
 
 function createSingleTaskInBucket(count = 1, attrs = {}) {
 	const projects = ProjectFactory.create(1)
-	const buckets = BucketFactory.create(2, {
+	const views = ProjectViewFactory.create(1, {
+		id: 1,
 		project_id: projects[0].id,
+		view_kind: 3,
+		bucket_configuration_mode: 1,
+	})
+	const buckets = BucketFactory.create(2, {
+		project_view_id: views[0].id,
 	})
 	const tasks = TaskFactory.create(count, {
 		project_id: projects[0].id,
-		bucket_id: buckets[0].id,
 		...attrs,
 	})
-	return tasks[0]
+	TaskBucketFactory.create(1, {
+		task_id: tasks[0].id,
+		bucket_id: buckets[0].id,
+		project_view_id: views[0].id,
+	})
+	return {
+		task: tasks[0],
+		view: views[0],
+		project: projects[0],
+	}
+}
+
+function createTaskWithBuckets(buckets, count = 1) {
+	const data = TaskFactory.create(10, {
+		project_id: 1,
+	})
+	TaskBucketFactory.truncate()
+	data.forEach(t => TaskBucketFactory.create(count, {
+		task_id: t.id,
+		bucket_id: buckets[0].id,
+		project_view_id: buckets[0].project_view_id,
+	}, false))
+
+	return data
 }
 
 describe('Project View Kanban', () => {
 	createFakeUserAndLogin()
 	prepareProjects()
-	
+
 	let buckets
 	beforeEach(() => {
-		buckets = BucketFactory.create(2)
+		buckets = BucketFactory.create(2, {
+			project_view_id: 4,
+		})
 	})
 
 	it('Shows all buckets with their tasks', () => {
-		const data = TaskFactory.create(10, {
-			project_id: 1,
-			bucket_id: 1,
-		})
-		cy.visit('/projects/1/kanban')
+		const data = createTaskWithBuckets(buckets, 10)
+		cy.visit('/projects/1/4')
 
 		cy.get('.kanban .bucket .title')
 			.contains(buckets[0].title)
@@ -46,11 +75,8 @@ describe('Project View Kanban', () => {
 	})
 
 	it('Can add a new task to a bucket', () => {
-		TaskFactory.create(2, {
-			project_id: 1,
-			bucket_id: 1,
-		})
-		cy.visit('/projects/1/kanban')
+		createTaskWithBuckets(buckets, 2)
+		cy.visit('/projects/1/4')
 
 		cy.get('.kanban .bucket')
 			.contains(buckets[0].title)
@@ -68,7 +94,7 @@ describe('Project View Kanban', () => {
 	})
 
 	it('Can create a new bucket', () => {
-		cy.visit('/projects/1/kanban')
+		cy.visit('/projects/1/4')
 
 		cy.get('.kanban .bucket.new-bucket .button')
 			.click()
@@ -82,7 +108,7 @@ describe('Project View Kanban', () => {
 	})
 
 	it('Can set a bucket limit', () => {
-		cy.visit('/projects/1/kanban')
+		cy.visit('/projects/1/4')
 
 		cy.get('.kanban .bucket .bucket-header .dropdown.options .dropdown-trigger')
 			.first()
@@ -90,9 +116,9 @@ describe('Project View Kanban', () => {
 		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')
+		cy.get('.kanban .bucket .bucket-header .dropdown.options .dropdown-menu .field input.input')
 			.first()
-			.type(3)
+			.type('3')
 		cy.get('[data-cy="setBucketLimit"]')
 			.first()
 			.click()
@@ -103,7 +129,7 @@ describe('Project View Kanban', () => {
 	})
 
 	it('Can rename a bucket', () => {
-		cy.visit('/projects/1/kanban')
+		cy.visit('/projects/1/4')
 
 		cy.get('.kanban .bucket .bucket-header .title')
 			.first()
@@ -114,7 +140,7 @@ describe('Project View Kanban', () => {
 	})
 
 	it('Can delete a bucket', () => {
-		cy.visit('/projects/1/kanban')
+		cy.visit('/projects/1/4')
 
 		cy.get('.kanban .bucket .bucket-header .dropdown.options .dropdown-trigger')
 			.first()
@@ -122,7 +148,7 @@ describe('Project View Kanban', () => {
 		cy.get('.kanban .bucket .bucket-header .dropdown.options .dropdown-menu .dropdown-item')
 			.contains('Delete')
 			.click()
-		cy.get('.modal-mask .modal-container .modal-content .header')
+		cy.get('.modal-mask .modal-container .modal-content .modal-header')
 			.should('contain', 'Delete the bucket')
 		cy.get('.modal-mask .modal-container .modal-content .actions .button')
 			.contains('Do it!')
@@ -137,17 +163,14 @@ describe('Project View Kanban', () => {
 	})
 
 	it('Can drag tasks around', () => {
-		const tasks = TaskFactory.create(2, {
-			project_id: 1,
-			bucket_id: 1,
-		})
-		cy.visit('/projects/1/kanban')
+		const tasks = createTaskWithBuckets(buckets, 2)
+		cy.visit('/projects/1/4')
 
 		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')
@@ -155,12 +178,8 @@ describe('Project View Kanban', () => {
 	})
 
 	it('Should navigate to the task when the task card is clicked', () => {
-		const tasks = TaskFactory.create(5, {
-			id: '{increment}',
-			project_id: 1,
-			bucket_id: 1,
-		})
-		cy.visit('/projects/1/kanban')
+		const tasks = createTaskWithBuckets(buckets, 5)
+		cy.visit('/projects/1/4')
 
 		cy.get('.kanban .bucket .tasks .task')
 			.contains(tasks[0].title)
@@ -168,28 +187,33 @@ describe('Project View Kanban', () => {
 			.click()
 
 		cy.url()
-			.should('contain', `/tasks/${tasks[0].id}`, { timeout: 1000 })
+			.should('contain', `/tasks/${tasks[0].id}`, {timeout: 1000})
 	})
 
 	it('Should remove a task from the kanban board when moving it to another project', () => {
 		const projects = ProjectFactory.create(2)
-		BucketFactory.create(2, {
+		const views = ProjectViewFactory.create(2, {
 			project_id: '{increment}',
+			view_kind: 3,
+			bucket_configuration_mode: 1,
 		})
+		BucketFactory.create(2)
 		const tasks = TaskFactory.create(5, {
 			id: '{increment}',
 			project_id: 1,
-			bucket_id: 1,
+		})
+		TaskBucketFactory.create(5, {
+			project_view_id: 1,
 		})
 		const task = tasks[0]
-		cy.visit('/projects/1/kanban')
+		cy.visit('/projects/1/'+views[0].id)
 
 		cy.get('.kanban .bucket .tasks .task')
 			.contains(task.title)
 			.should('be.visible')
 			.click()
 
-		cy.get('.task-view .action-buttons .button', { timeout: 3000 })
+		cy.get('.task-view .action-buttons .button', {timeout: 3000})
 			.contains('Move')
 			.click()
 		cy.get('.task-view .content.details .field .multiselect.control .input-wrapper input')
@@ -201,27 +225,23 @@ describe('Project View Kanban', () => {
 			.first()
 			.click()
 
-		cy.get('.global-notification', { timeout: 1000 })
+		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, {
-			project_id: 1,
-			bucket_id: 1,
-		})
-		cy.visit('/projects/1/kanban')
-		
+		cy.visit('/projects/1/4')
+
 		cy.get('.project-kanban .filter-container .base-button')
 			.should('exist')
 	})
-	
+
 	it('Should remove a task from the board when deleting it', () => {
-		const task = createSingleTaskInBucket(5)
-		cy.visit('/projects/1/kanban')
+		const {task, view} = createSingleTaskInBucket(5)
+		cy.visit(`/projects/1/${view.id}`)
 
 		cy.get('.kanban .bucket .tasks .task')
 			.contains(task.title)
@@ -231,7 +251,7 @@ describe('Project View Kanban', () => {
 			.should('be.visible')
 			.contains('Delete')
 			.click()
-		cy.get('.modal-mask .modal-container .modal-content .header')
+		cy.get('.modal-mask .modal-container .modal-content .modal-header')
 			.should('contain', 'Delete this task')
 		cy.get('.modal-mask .modal-container .modal-content .actions .button')
 			.contains('Do it!')
@@ -239,18 +259,18 @@ describe('Project View Kanban', () => {
 
 		cy.get('.global-notification')
 			.should('contain', 'Success')
-		
+
 		cy.get('.kanban .bucket .tasks')
 			.should('not.contain', task.title)
 	})
 
 	it('Should show a task description icon if the task has a description', () => {
-		cy.intercept(Cypress.env('API_URL') + '/projects/1/buckets**').as('loadTasks')
-		const task = createSingleTaskInBucket(1, {
+		cy.intercept(Cypress.env('API_URL') + '/projects/1/views/*/tasks**').as('loadTasks')
+		const {task, view} = createSingleTaskInBucket(1, {
 			description: 'Lorem Ipsum',
 		})
 
-		cy.visit(`/projects/${task.project_id}/kanban`)
+		cy.visit(`/projects/${task.project_id}/${view.id}`)
 		cy.wait('@loadTasks')
 
 		cy.get('.bucket .tasks .task .footer .icon svg')
@@ -258,12 +278,12 @@ describe('Project View Kanban', () => {
 	})
 
 	it('Should not show a task description icon if the task has an empty description', () => {
-		cy.intercept(Cypress.env('API_URL') + '/projects/1/buckets**').as('loadTasks')
-		const task = createSingleTaskInBucket(1, {
+		cy.intercept(Cypress.env('API_URL') + '/projects/1/views/*/tasks**').as('loadTasks')
+		const {task, view} = createSingleTaskInBucket(1, {
 			description: '',
 		})
 
-		cy.visit(`/projects/${task.project_id}/kanban`)
+		cy.visit(`/projects/${task.project_id}/${view.id}`)
 		cy.wait('@loadTasks')
 
 		cy.get('.bucket .tasks .task .footer .icon svg')
@@ -271,15 +291,15 @@ describe('Project View Kanban', () => {
 	})
 
 	it('Should not show a task description icon if the task has a description containing only an empty p tag', () => {
-		cy.intercept(Cypress.env('API_URL') + '/projects/1/buckets**').as('loadTasks')
-		const task = createSingleTaskInBucket(1, {
+		cy.intercept(Cypress.env('API_URL') + '/projects/1/views/*/tasks**').as('loadTasks')
+		const {task, view} = createSingleTaskInBucket(1, {
 			description: '<p></p>',
 		})
 
-		cy.visit(`/projects/${task.project_id}/kanban`)
+		cy.visit(`/projects/${task.project_id}/${view.id}`)
 		cy.wait('@loadTasks')
 
 		cy.get('.bucket .tasks .task .footer .icon svg')
 			.should('not.exist')
 	})
-})
+})

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

@@ -5,15 +5,16 @@ import {TaskFactory} from '../../factories/task'
 import {UserFactory} from '../../factories/user'
 import {ProjectFactory} from '../../factories/project'
 import {prepareProjects} from './prepareProjects'
+import {BucketFactory} from '../../factories/bucket'
 
-describe('Project View Project', () => {
+describe('Project View List', () => {
 	createFakeUserAndLogin()
 	prepareProjects()
 
 	it('Should be an empty project', () => {
 		cy.visit('/projects/1')
 		cy.url()
-			.should('contain', '/projects/1/list')
+			.should('contain', '/projects/1/1')
 		cy.get('.project-title')
 			.should('contain', 'First Project')
 		cy.get('.project-title-dropdown')
@@ -24,6 +25,10 @@ describe('Project View Project', () => {
 	})
 	
 	it('Should create a new task', () => {
+		BucketFactory.create(2, {
+			project_view_id: 4,
+		})
+		
 		const newTaskTitle = 'New task'
 		
 		cy.visit('/projects/1')
@@ -38,7 +43,7 @@ describe('Project View Project', () => {
 			id: '{increment}',
 			project_id: 1,
 		})
-		cy.visit('/projects/1/list')
+		cy.visit('/projects/1/1')
 
 		cy.get('.tasks .task .tasktext')
 			.contains(tasks[0].title)
@@ -63,7 +68,7 @@ describe('Project View Project', () => {
 
 		cy.get('.project-title-wrapper .icon')
 			.should('not.exist')
-		cy.get('input.input[placeholder="Add a new task..."')
+		cy.get('input.input[placeholder="Add a task..."')
 			.should('not.exist')
 	})
 
@@ -88,10 +93,10 @@ describe('Project View Project', () => {
 			title: i => `task${i}`,
 			project_id: 1,
 		})
-		cy.visit('/projects/1/list')
+		cy.visit('/projects/1/1')
 
 		cy.get('.tasks')
-			.should('contain', tasks[1].title)
+			.should('contain', tasks[20].title)
 		cy.get('.tasks')
 			.should('not.contain', tasks[99].title)
 
@@ -104,6 +109,6 @@ describe('Project View Project', () => {
 		cy.get('.tasks')
 			.should('contain', tasks[99].title)
 		cy.get('.tasks')
-			.should('not.contain', tasks[1].title)
+			.should('not.contain', tasks[20].title)
 	})
 })

frontend/cypress/e2e/project/project-view-table.spec.ts

@@ -1,13 +1,15 @@
 import {createFakeUserAndLogin} from '../../support/authenticateUser'
 
 import {TaskFactory} from '../../factories/task'
+import {prepareProjects} from './prepareProjects'
 
 describe('Project View Table', () => {
 	createFakeUserAndLogin()
+	prepareProjects()
 
 	it('Should show a table with tasks', () => {
 		const tasks = TaskFactory.create(1)
-		cy.visit('/projects/1/table')
+		cy.visit('/projects/1/3')
 
 		cy.get('.project-table table.table')
 			.should('exist')
@@ -17,15 +19,15 @@ describe('Project View Table', () => {
 
 	it('Should have working column switches', () => {
 		TaskFactory.create(1)
-		cy.visit('/projects/1/table')
+		cy.visit('/projects/1/3')
 
-		cy.get('.project-table .filter-container .items .button')
+		cy.get('.project-table .filter-container .button')
 			.contains('Columns')
 			.click()
-		cy.get('.project-table .filter-container .card.columns-filter .card-content .fancycheckbox')
+		cy.get('.project-table .filter-container .card.columns-filter .card-content .fancy-checkbox')
 			.contains('Priority')
 			.click()
-		cy.get('.project-table .filter-container .card.columns-filter .card-content .fancycheckbox')
+		cy.get('.project-table .filter-container .card.columns-filter .card-content .fancy-checkbox')
 			.contains('Done')
 			.click()
 
@@ -42,7 +44,7 @@ describe('Project View Table', () => {
 			id: '{increment}',
 			project_id: 1,
 		})
-		cy.visit('/projects/1/table')
+		cy.visit('/projects/1/3')
 
 		cy.get('.project-table table.table')
 			.contains(tasks[0].title)

frontend/cypress/e2e/project/project.spec.ts

@@ -33,14 +33,14 @@ describe('Projects', () => {
 	})
 
 	it('Should redirect to a specific project view after visited', () => {
-		cy.intercept(Cypress.env('API_URL') + '/projects/*/buckets*').as('loadBuckets')
-		cy.visit('/projects/1/kanban')
+		cy.intercept(Cypress.env('API_URL') + '/projects/*/views/*/tasks**').as('loadBuckets')
+		cy.visit('/projects/1/4')
 		cy.url()
-			.should('contain', '/projects/1/kanban')
+			.should('contain', '/projects/1/4')
 		cy.wait('@loadBuckets')
 		cy.visit('/projects/1')
 		cy.url()
-			.should('contain', '/projects/1/kanban')
+			.should('contain', '/projects/1/4')
 	})
 
 	it('Should rename the project in all places', () => {

frontend/cypress/e2e/sharing/linkShare.spec.ts

@@ -1,9 +1,9 @@
 import {LinkShareFactory} from '../../factories/link_sharing'
-import {ProjectFactory} from '../../factories/project'
 import {TaskFactory} from '../../factories/task'
+import {createProjects} from '../project/prepareProjects'
 
 function prepareLinkShare() {
-	const projects = ProjectFactory.create(1)
+	const projects = createProjects()
 	const tasks = TaskFactory.create(10, {
 		project_id: projects[0].id
 	})
@@ -27,22 +27,22 @@ describe('Link shares', () => {
 
 		cy.get('h1.title')
 			.should('contain', project.title)
-		cy.get('input.input[placeholder="Add a new task..."')
+		cy.get('input.input[placeholder="Add a task..."')
 			.should('not.exist')
 		cy.get('.tasks')
 			.should('contain', tasks[0].title)
 		
-		cy.url().should('contain', `/projects/${project.id}/list#share-auth-token=${share.hash}`)
+		cy.url().should('contain', `/projects/${project.id}/1#share-auth-token=${share.hash}`)
 	})
 
 	it('Should work when directly viewing a project with share hash present', () => {
 		const {share, project, tasks} = prepareLinkShare()
 
-		cy.visit(`/projects/${project.id}/list#share-auth-token=${share.hash}`)
+		cy.visit(`/projects/${project.id}/1#share-auth-token=${share.hash}`)
 
 		cy.get('h1.title')
 			.should('contain', project.title)
-		cy.get('input.input[placeholder="Add a new task..."')
+		cy.get('input.input[placeholder="Add a task..."')
 			.should('not.exist')
 		cy.get('.tasks')
 			.should('contain', tasks[0].title)

frontend/cypress/e2e/sharing/team.spec.ts

@@ -14,12 +14,12 @@ describe('Team', () => {
         const newTeamName = 'New Team'
 
         cy.get('a.button')
-            .contains('Create a new team')
+            .contains('Create a team')
             .click()
 		cy.url()
 			.should('contain', '/teams/new')
 		cy.get('.card-header-title')
-			.contains('Create a new team')
+			.contains('Create a team')
 		cy.get('input.input')
 			.type(newTeamName)
 		cy.get('.button')

frontend/cypress/e2e/task/overview.spec.ts

@@ -5,11 +5,13 @@ import {seed} from '../../support/seed'
 import {TaskFactory} from '../../factories/task'
 import {BucketFactory} from '../../factories/bucket'
 import {updateUserSettings} from '../../support/updateUserSettings'
+import {createDefaultViews} from "../project/prepareProjects";
 
 function seedTasks(numberOfTasks = 50, startDueDate = new Date()) {
 	const project = ProjectFactory.create()[0]
+	const views = createDefaultViews(project.id)
 	BucketFactory.create(1, {
-		project_id: project.id,
+		project_view_id: views[3].id,
 	})
 	const tasks = []
 	let dueDate = startDueDate
@@ -60,7 +62,7 @@ describe('Home Page Task Overview', () => {
 	})
 
 	it('Should show a new task with a very soon due date at the top', () => {
-		const {tasks} = seedTasks()
+		const {tasks} = seedTasks(49)
 		const newTaskTitle = 'New Task'
 		
 		cy.visit('/')
@@ -71,9 +73,8 @@ describe('Home Page Task Overview', () => {
 			due_date: new Date().toISOString(),
 		}, false)
 		
-		cy.visit(`/projects/${tasks[0].project_id}/list`)
+		cy.visit(`/projects/${tasks[0].project_id}/1`)
 		cy.get('.tasks .task')
-			.first()
 			.should('contain.text', newTaskTitle)
 		cy.visit('/')
 		cy.get('[data-cy="showTasks"] .card .task')
@@ -88,7 +89,7 @@ describe('Home Page Task Overview', () => {
 
 		cy.visit('/')
 
-		cy.visit(`/projects/${tasks[0].project_id}/list`)
+		cy.visit(`/projects/${tasks[0].project_id}/1`)
 		cy.get('.task-add textarea')
 			.type(newTaskTitle+'{enter}')
 		cy.visit('/')

frontend/cypress/e2e/task/task.spec.ts

@@ -12,6 +12,8 @@ import {BucketFactory} from '../../factories/bucket'
 
 import {TaskAttachmentFactory} from '../../factories/task_attachments'
 import {TaskReminderFactory} from '../../factories/task_reminders'
+import {createDefaultViews} from "../project/prepareProjects";
+import { TaskBucketFactory } from '../../factories/task_buckets'
 
 function addLabelToTaskAndVerify(labelTitle: string) {
 	cy.get('.task-view .action-buttons .button')
@@ -40,29 +42,30 @@ function uploadAttachmentAndVerify(taskId: number) {
 		.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')
+	cy.get('.attachments .attachments .files button.attachment')
 		.should('exist')
 }
 
 describe('Task', () => {
 	createFakeUserAndLogin()
 
-	let projects
+	let projects: {}[]
 	let buckets
 
 	beforeEach(() => {
 		// UserFactory.create(1)
 		projects = ProjectFactory.create(1)
+		const views = createDefaultViews(projects[0].id)
 		buckets = BucketFactory.create(1, {
-			project_id: projects[0].id,
+			project_view_id: views[3].id,
 		})
 		TaskFactory.truncate()
 		UserProjectFactory.truncate()
 	})
 
 	it('Should be created new', () => {
-		cy.visit('/projects/1/list')
-		cy.get('.input[placeholder="Add a new task…"')
+		cy.visit('/projects/1/1')
+		cy.get('.input[placeholder="Add a task…"')
 			.type('New Task')
 		cy.get('.button')
 			.contains('Add')
@@ -75,10 +78,10 @@ describe('Task', () => {
 	it('Inserts new tasks at the top of the project', () => {
 		TaskFactory.create(1)
 
-		cy.visit('/projects/1/list')
+		cy.visit('/projects/1/1')
 		cy.get('.project-is-empty-notice')
 			.should('not.exist')
-		cy.get('.input[placeholder="Add a new task…"')
+		cy.get('.input[placeholder="Add a task…"')
 			.type('New Task')
 		cy.get('.button')
 			.contains('Add')
@@ -93,8 +96,8 @@ describe('Task', () => {
 	it('Marks a task as done', () => {
 		TaskFactory.create(1)
 
-		cy.visit('/projects/1/list')
-		cy.get('.tasks .task .fancycheckbox')
+		cy.visit('/projects/1/1')
+		cy.get('.tasks .task .fancy-checkbox')
 			.first()
 			.click()
 		cy.get('.global-notification')
@@ -104,7 +107,7 @@ describe('Task', () => {
 	it('Can add a task to favorites', () => {
 		TaskFactory.create(1)
 
-		cy.visit('/projects/1/list')
+		cy.visit('/projects/1/1')
 		cy.get('.tasks .task .favorite')
 			.first()
 			.click()
@@ -113,12 +116,12 @@ describe('Task', () => {
 	})
 
 	it('Should show a task description icon if the task has a description', () => {
-		cy.intercept(Cypress.env('API_URL') + '/projects/1/tasks**').as('loadTasks')
+		cy.intercept(Cypress.env('API_URL') + '/projects/1/views/*/tasks**').as('loadTasks')
 		TaskFactory.create(1, {
 			description: 'Lorem Ipsum',
 		})
 
-		cy.visit('/projects/1/list')
+		cy.visit('/projects/1/1')
 		cy.wait('@loadTasks')
 
 		cy.get('.tasks .task .project-task-icon')
@@ -126,12 +129,12 @@ describe('Task', () => {
 	})
 
 	it('Should not show a task description icon if the task has an empty description', () => {
-		cy.intercept(Cypress.env('API_URL') + '/projects/1/tasks**').as('loadTasks')
+		cy.intercept(Cypress.env('API_URL') + '/projects/1/views/*/tasks**').as('loadTasks')
 		TaskFactory.create(1, {
 			description: '',
 		})
 
-		cy.visit('/projects/1/list')
+		cy.visit('/projects/1/1')
 		cy.wait('@loadTasks')
 
 		cy.get('.tasks .task .project-task-icon')
@@ -139,12 +142,12 @@ describe('Task', () => {
 	})
 
 	it('Should not show a task description icon if the task has a description containing only an empty p tag', () => {
-		cy.intercept(Cypress.env('API_URL') + '/projects/1/tasks**').as('loadTasks')
+		cy.intercept(Cypress.env('API_URL') + '/projects/1/views/*/tasks**').as('loadTasks')
 		TaskFactory.create(1, {
 			description: '<p></p>',
 		})
 
-		cy.visit('/projects/1/list')
+		cy.visit('/projects/1/1')
 		cy.wait('@loadTasks')
 
 		cy.get('.tasks .task .project-task-icon')
@@ -314,8 +317,9 @@ describe('Task', () => {
 
 		it('Can move a task to another project', () => {
 			const projects = ProjectFactory.create(2)
+			const views = createDefaultViews(projects[0].id)
 			BucketFactory.create(2, {
-				project_id: '{increment}',
+				project_view_id: views[3].id,
 			})
 			const tasks = TaskFactory.create(1, {
 				id: 1,
@@ -352,7 +356,7 @@ describe('Task', () => {
 				.should('be.visible')
 				.contains('Delete')
 				.click()
-			cy.get('.modal-mask .modal-container .modal-content .header')
+			cy.get('.modal-mask .modal-container .modal-content .modal-header')
 				.should('contain', 'Delete this task')
 			cy.get('.modal-mask .modal-container .modal-content .actions .button')
 				.contains('Do it!')
@@ -464,12 +468,15 @@ describe('Task', () => {
 			const tasks = TaskFactory.create(1, {
 				id: 1,
 				project_id: projects[0].id,
-				bucket_id: buckets[0].id,
 			})
 			const labels = LabelFactory.create(1)
 			LabelTaskFactory.truncate()
+			TaskBucketFactory.create(1, {
+				task_id: tasks[0].id,
+				bucket_id: buckets[0].id,
+			})
 
-			cy.visit(`/projects/${projects[0].id}/kanban`)
+			cy.visit(`/projects/${projects[0].id}/4`)
 
 			cy.get('.bucket .task')
 				.contains(tasks[0].title)
@@ -477,7 +484,7 @@ describe('Task', () => {
 
 			addLabelToTaskAndVerify(labels[0].title)
 
-			cy.get('.modal-content .close')
+			cy.get('.modal-container > .close')
 				.click()
 
 			cy.get('.bucket .task')
@@ -633,7 +640,7 @@ describe('Task', () => {
 				.contains('Set Reminders')
 				.click()
 			cy.get('.task-view .columns.details .column button')
-				.contains('Add a new reminder')
+				.contains('Add a reminder')
 				.click()
 			cy.get('.datepicker__quick-select-date')
 				.contains('Tomorrow')
@@ -658,7 +665,7 @@ describe('Task', () => {
 				.contains('Set Reminders')
 				.click()
 			cy.get('.task-view .columns.details .column button')
-				.contains('Add a new reminder')
+				.contains('Add a reminder')
 				.click()
 			cy.get('.datepicker__quick-select-date')
 				.should('not.exist')
@@ -687,7 +694,7 @@ describe('Task', () => {
 				.contains('Set Reminders')
 				.click()
 			cy.get('.task-view .columns.details .column button')
-				.contains('Add a new reminder')
+				.contains('Add a reminder')
 				.click()
 			cy.get('.datepicker__quick-select-date')
 				.should('not.exist')
@@ -716,7 +723,7 @@ describe('Task', () => {
 				.contains('Set Reminders')
 				.click()
 			cy.get('.task-view .columns.details .column button')
-				.contains('Add a new reminder')
+				.contains('Add a reminder')
 				.click()
 			cy.get('.datepicker__quick-select-date')
 				.should('not.exist')
@@ -752,7 +759,7 @@ describe('Task', () => {
 				.contains('Set Reminders')
 				.click()
 			cy.get('.task-view .columns.details .column button')
-				.contains('Add a new reminder')
+				.contains('Add a reminder')
 				.click()
 			cy.get('.datepicker__quick-select-date')
 				.should('not.exist')
@@ -831,12 +838,11 @@ describe('Task', () => {
 			const tasks = TaskFactory.create(1, {
 				id: 1,
 				project_id: projects[0].id,
-				bucket_id: buckets[0].id,
 			})
 			const labels = LabelFactory.create(1)
 			LabelTaskFactory.truncate()
 
-			cy.visit(`/projects/${projects[0].id}/kanban`)
+			cy.visit(`/projects/${projects[0].id}/4`)
 
 			cy.get('.bucket .task')
 				.contains(tasks[0].title)
@@ -844,7 +850,7 @@ describe('Task', () => {
 
 			uploadAttachmentAndVerify(tasks[0].id)
 
-			cy.get('.modal-content .close')
+			cy.get('.modal-container > .close')
 				.click()
 
 			cy.get('.bucket .task .footer .icon svg.fa-paperclip')

frontend/cypress/e2e/tsconfig.json

@@ -7,6 +7,5 @@
     "target": "ES2015",
     "lib": ["ESNext", "dom"],
     "types": ["cypress"],
-    "ignoreDeprecations": "5.0"
   }
 }

frontend/cypress/factories/bucket.ts

@@ -10,7 +10,7 @@ export class BucketFactory extends Factory {
 		return {
 			id: '{increment}',
 			title: faker.lorem.words(3),
-			project_id: 1,
+			project_view_id: '{increment}',
 			created_by_id: 1,
 			created: now.toISOString(),
 			updated: now.toISOString(),

frontend/cypress/factories/link_sharing.ts

@@ -9,7 +9,7 @@ export class LinkShareFactory extends Factory {
 
 		return {
 			id: '{increment}',
-			hash: faker.random.word(32),
+			hash: faker.lorem.word(32),
 			project_id: 1,
 			right: 0,
 			sharing_type: 0,

frontend/cypress/factories/project_view.ts

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

frontend/cypress/factories/task.ts

@@ -14,7 +14,6 @@ export class TaskFactory extends Factory {
 			project_id: 1,
 			created_by_id: 1,
 			index: '{increment}',
-			position: '{increment}',
 			created: now.toISOString(),
 			updated: now.toISOString()
 		}

frontend/cypress/factories/task_buckets.ts

@@ -0,0 +1,13 @@
+import {Factory} from '../support/factory'
+
+export class TaskBucketFactory extends Factory {
+	static table = 'task_buckets'
+
+	static factory() {
+		return {
+			task_id: '{increment}',
+			bucket_id: '{increment}',
+			project_view_id: '{increment}',
+		}
+	}
+}

frontend/cypress/factories/user.ts

@@ -10,7 +10,7 @@ export class UserFactory extends Factory {
 
 		return {
             id: '{increment}',
-            username: faker.lorem.word(10) + faker.datatype.uuid(),
+            username: faker.lorem.word(10) + faker.string.uuid(),
             password: '$2a$14$dcadBoMBL9jQoOcZK8Fju.cy0Ptx2oZECkKLnaa8ekRoTFe1w7To.', // 1234
 			status: 0,
 			issuer: 'local',

frontend/env.d.ts

@@ -3,16 +3,6 @@
 /// <reference types="cypress" />
 /// <reference types="@histoire/plugin-vue/components" />
 
-declare module 'postcss-focus-within/browser' {
-	import focusWithinInit from 'postcss-focus-within/browser'
-	export default focusWithinInit
-}
-
-declare module 'css-has-pseudo/browser' {
-	import cssHasPseudo from 'css-has-pseudo/browser'
-	export default cssHasPseudo
-}
-
 interface ImportMetaEnv {
 	readonly VIKUNJA_API_URL?: string
 	readonly VIKUNJA_HTTP_PORT?: number

frontend/eslint.config.js

@@ -0,0 +1,88 @@
+import pluginVue from 'eslint-plugin-vue'
+import js from '@eslint/js'
+import vueTsEslintConfig from '@vue/eslint-config-typescript'
+
+export default [
+	js.configs.recommended,
+	...pluginVue.configs['flat/recommended'],
+	...vueTsEslintConfig(),
+	{
+		ignores: [
+			'**/*.test.ts',
+			'./cypress',
+		],
+	},
+	{
+		rules: {
+			'quotes': ['error', 'single'],
+			'comma-dangle': ['error', 'always-multiline'],
+			'semi': ['error', 'never'],
+
+			'vue/v-on-event-hyphenation': ['warn', 'never', {'autofix': true}],
+			'vue/multi-word-component-names': 'off',
+
+			// uncategorized rules:
+			'vue/component-api-style': ['error', ['script-setup']],
+			'vue/component-name-in-template-casing': ['error', 'PascalCase', {
+				'globals': ['RouterView', 'RouterLink', 'Icon', 'Notifications', 'Modal', 'Card'],
+			}],
+			'vue/custom-event-name-casing': ['error', 'camelCase'],
+			'vue/define-macros-order': 'error',
+			'vue/match-component-file-name': ['error', {
+				'extensions': ['.js', '.jsx', '.ts', '.tsx', '.vue'],
+				'shouldMatchCase': true,
+			}],
+			'vue/no-boolean-default': ['warn', 'default-false'],
+			'vue/match-component-import-name': 'error',
+			'vue/prefer-separate-static-class': 'warn',
+
+			'vue/padding-line-between-blocks': 'error',
+			'vue/next-tick-style': ['error', 'promise'],
+			'vue/block-lang': [
+				'error',
+				{'script': {'lang': 'ts'}},
+			],
+			'vue/no-duplicate-attr-inheritance': 'error',
+			'vue/no-empty-component-block': 'error',
+			'vue/html-indent': ['error', 'tab'],
+
+			// vue3
+			'vue/no-ref-object-reactivity-loss': 'error',
+			'vue/no-setup-props-reactivity-loss': 'warn', // TODO: switch to error after vite `propsDestructure` is removed
+
+			'@typescript-eslint/no-unused-vars': [
+				'error',
+				{
+					// 'args': 'all',
+					// 'argsIgnorePattern': '^_',
+					'caughtErrors': 'all',
+					'caughtErrorsIgnorePattern': '^_',
+					// 'destructuredArrayIgnorePattern': '^_',
+					'varsIgnorePattern': '^_',
+					'ignoreRestSiblings': true,
+				},
+			],
+		},
+
+		// files: ['*.vue', '**/*.vue'],
+		languageOptions: {
+			parserOptions: {
+				parser: '@typescript-eslint/parser',
+				ecmaVersion: 'latest',
+				tsconfigRootDir: '.',
+			},
+		},
+
+
+		// 'parser': 'vue-eslint-parser',
+		// 'parserOptions': {
+		// 	'parser': '@typescript-eslint/parser',
+		// 	'ecmaVersion': 'latest',
+		// 	'tsconfigRootDir': __dirname,
+		// },
+		// 'ignorePatterns': [
+		// 	'cypress/*',
+		// ],
+	},
+
+]

frontend/flake.lock

@@ -1,25 +0,0 @@
-{
-  "nodes": {
-    "nixpkgs": {
-      "locked": {
-        "lastModified": 1701336116,
-        "narHash": "sha256-kEmpezCR/FpITc6yMbAh4WrOCiT2zg5pSjnKrq51h5Y=",
-        "owner": "NixOS",
-        "repo": "nixpkgs",
-        "rev": "f5c27c6136db4d76c30e533c20517df6864c46ee",
-        "type": "github"
-      },
-      "original": {
-        "id": "nixpkgs",
-        "type": "indirect"
-      }
-    },
-    "root": {
-      "inputs": {
-        "nixpkgs": "nixpkgs"
-      }
-    }
-  },
-  "root": "root",
-  "version": 7
-}

frontend/flake.nix

@@ -1,10 +0,0 @@
-{
-  description = "Vikunja frontend dev environment";
-
-  outputs = { self, nixpkgs }:
-    let pkgs = nixpkgs.legacyPackages.x86_64-linux;
-    in {
-      defaultPackage.x86_64-linux =
-        pkgs.mkShell { buildInputs = [ pkgs.nodePackages.pnpm pkgs.cypress pkgs.git-cliff ]; };
-    };
-}

frontend/package.json

@@ -13,7 +13,7 @@
   },
   "homepage": "https://vikunja.io/",
   "funding": "https://opencollective.com/vikunja",
-  "packageManager": "pnpm@8.15.4",
+  "packageManager": "pnpm@9.13.2",
   "keywords": [
     "todo",
     "productivity",
@@ -40,7 +40,7 @@
     "test:e2e-dev-dev": "start-server-and-test preview:dev http://127.0.0.1:4173 'cypress open --e2e'",
     "test:e2e-dev": "start-server-and-test preview http://127.0.0.1:4173 'cypress open --e2e'",
     "test:unit": "vitest --dir ./src",
-    "typecheck": "vue-tsc --noEmit && vue-tsc --noEmit -p tsconfig.vitest.json --composite false",
+    "typecheck": "vue-tsc --build --force",
     "browserslist:update": "pnpm dlx browserslist@latest --update-db",
     "fonts:update": "pnpm fonts:download && pnpm fonts:subset",
     "fonts:download": "./scripts/fonts-download.sh",
@@ -50,141 +50,135 @@
     "story:preview": "histoire preview"
   },
   "dependencies": {
-    "@fortawesome/fontawesome-svg-core": "6.5.1",
-    "@fortawesome/free-regular-svg-icons": "6.5.1",
-    "@fortawesome/free-solid-svg-icons": "6.5.1",
-    "@fortawesome/vue-fontawesome": "3.0.6",
-    "@github/hotkey": "3.1.0",
-    "@infectoone/vue-ganttastic": "2.2.0",
-    "@intlify/unplugin-vue-i18n": "2.0.0",
-    "@kyvg/vue3-notification": "3.2.0",
-    "@sentry/tracing": "7.105.0",
-    "@sentry/vue": "7.105.0",
-    "@tiptap/core": "2.2.4",
-    "@tiptap/extension-blockquote": "2.2.4",
-    "@tiptap/extension-bold": "2.2.4",
-    "@tiptap/extension-bullet-list": "2.2.4",
-    "@tiptap/extension-code": "2.2.4",
-    "@tiptap/extension-code-block-lowlight": "2.2.4",
-    "@tiptap/extension-document": "2.2.4",
-    "@tiptap/extension-dropcursor": "2.2.4",
-    "@tiptap/extension-gapcursor": "2.2.4",
-    "@tiptap/extension-hard-break": "2.2.4",
-    "@tiptap/extension-heading": "2.2.4",
-    "@tiptap/extension-history": "2.2.4",
-    "@tiptap/extension-horizontal-rule": "2.2.4",
-    "@tiptap/extension-image": "2.2.4",
-    "@tiptap/extension-italic": "2.2.4",
-    "@tiptap/extension-link": "2.2.4",
-    "@tiptap/extension-list-item": "2.2.4",
-    "@tiptap/extension-ordered-list": "2.2.4",
-    "@tiptap/extension-paragraph": "2.2.4",
-    "@tiptap/extension-placeholder": "2.2.4",
-    "@tiptap/extension-strike": "2.2.4",
-    "@tiptap/extension-table": "2.2.4",
-    "@tiptap/extension-table-cell": "2.2.4",
-    "@tiptap/extension-table-header": "2.2.4",
-    "@tiptap/extension-table-row": "2.2.4",
-    "@tiptap/extension-task-item": "2.2.4",
-    "@tiptap/extension-task-list": "2.2.4",
-    "@tiptap/extension-text": "2.2.4",
-    "@tiptap/extension-typography": "2.2.4",
-    "@tiptap/extension-underline": "2.2.4",
-    "@tiptap/pm": "2.2.4",
-    "@tiptap/suggestion": "2.2.4",
-    "@tiptap/vue-3": "2.2.4",
-    "@types/is-touch-device": "1.0.2",
-    "@types/lodash.clonedeep": "4.5.9",
-    "@vueuse/core": "10.9.0",
-    "@vueuse/router": "10.9.0",
-    "axios": "1.6.7",
+    "@fortawesome/fontawesome-svg-core": "6.6.0",
+    "@fortawesome/free-regular-svg-icons": "6.6.0",
+    "@fortawesome/free-solid-svg-icons": "6.6.0",
+    "@fortawesome/vue-fontawesome": "3.0.8",
+    "@github/hotkey": "3.1.1",
+    "@infectoone/vue-ganttastic": "2.3.2",
+    "@intlify/unplugin-vue-i18n": "6.0.0",
+    "@kyvg/vue3-notification": "3.4.1",
+    "@sentry/tracing": "7.114.0",
+    "@sentry/vue": "8.38.0",
+    "@tiptap/core": "2.9.1",
+    "@tiptap/extension-blockquote": "2.9.1",
+    "@tiptap/extension-bold": "2.9.1",
+    "@tiptap/extension-bullet-list": "2.9.1",
+    "@tiptap/extension-code": "2.9.1",
+    "@tiptap/extension-code-block": "2.9.1",
+    "@tiptap/extension-code-block-lowlight": "2.9.1",
+    "@tiptap/extension-document": "2.9.1",
+    "@tiptap/extension-dropcursor": "2.9.1",
+    "@tiptap/extension-gapcursor": "2.9.1",
+    "@tiptap/extension-hard-break": "2.9.1",
+    "@tiptap/extension-heading": "2.9.1",
+    "@tiptap/extension-history": "2.9.1",
+    "@tiptap/extension-horizontal-rule": "2.9.1",
+    "@tiptap/extension-image": "2.9.1",
+    "@tiptap/extension-italic": "2.9.1",
+    "@tiptap/extension-link": "2.9.1",
+    "@tiptap/extension-list-item": "2.9.1",
+    "@tiptap/extension-ordered-list": "2.9.1",
+    "@tiptap/extension-paragraph": "2.9.1",
+    "@tiptap/extension-placeholder": "2.9.1",
+    "@tiptap/extension-strike": "2.9.1",
+    "@tiptap/extension-table": "2.9.1",
+    "@tiptap/extension-table-cell": "2.9.1",
+    "@tiptap/extension-table-header": "2.9.1",
+    "@tiptap/extension-table-row": "2.9.1",
+    "@tiptap/extension-task-item": "2.9.1",
+    "@tiptap/extension-task-list": "2.9.1",
+    "@tiptap/extension-text": "2.9.1",
+    "@tiptap/extension-typography": "2.9.1",
+    "@tiptap/extension-underline": "2.9.1",
+    "@tiptap/pm": "2.9.1",
+    "@tiptap/suggestion": "2.9.1",
+    "@tiptap/vue-3": "2.9.1",
+    "@vueuse/core": "11.2.0",
+    "@vueuse/router": "11.2.0",
+    "axios": "1.7.7",
     "blurhash": "2.0.5",
     "bulma-css-variables": "0.9.33",
-    "camel-case": "4.1.2",
-    "date-fns": "3.3.1",
-    "dayjs": "1.11.10",
-    "dompurify": "3.0.9",
+    "change-case": "5.4.4",
+    "date-fns": "4.1.0",
+    "dayjs": "1.11.13",
+    "dompurify": "3.2.0",
     "fast-deep-equal": "3.1.3",
     "flatpickr": "4.6.13",
-    "flexsearch": "0.7.31",
+    "flexsearch": "0.7.43",
     "floating-vue": "5.2.2",
     "is-touch-device": "1.0.1",
     "klona": "2.0.6",
-    "lodash.debounce": "4.0.8",
     "lowlight": "2.9.0",
-    "pinia": "2.1.7",
+    "pinia": "2.2.6",
     "register-service-worker": "1.7.2",
-    "snake-case": "3.0.4",
-    "sortablejs": "1.15.2",
+    "sortablejs": "1.15.3",
+    "tailwindcss": "3.4.15",
     "tippy.js": "6.3.7",
-    "ufo": "1.4.0",
-    "vue": "3.4.21",
-    "vue-advanced-cropper": "2.8.8",
+    "ufo": "1.5.4",
+    "vue": "3.5.13",
+    "vue-advanced-cropper": "2.8.9",
     "vue-flatpickr-component": "11.0.5",
-    "vue-i18n": "9.10.1",
-    "vue-router": "4.3.0",
-    "workbox-precaching": "7.0.0",
+    "vue-i18n": "10.0.4",
+    "vue-router": "4.4.5",
+    "vuemoji-picker": "0.3.1",
+    "workbox-precaching": "7.3.0",
     "zhyswan-vuedraggable": "4.1.3"
   },
   "devDependencies": {
     "@4tw/cypress-drag-drop": "2.2.5",
-    "@cypress/vite-dev-server": "5.0.7",
-    "@cypress/vue": "6.0.0",
-    "@faker-js/faker": "8.4.1",
-    "@histoire/plugin-screenshot": "0.17.8",
-    "@histoire/plugin-vue": "0.17.12",
-    "@rushstack/eslint-patch": "1.7.2",
-    "@tsconfig/node18": "18.2.2",
+    "@cypress/vite-dev-server": "5.2.0",
+    "@cypress/vue": "6.0.1",
+    "@faker-js/faker": "9.2.0",
+    "@histoire/plugin-screenshot": "0.17.17",
+    "@histoire/plugin-vue": "0.17.17",
+    "@tsconfig/node22": "22.0.0",
     "@types/codemirror": "5.60.15",
     "@types/dompurify": "3.0.5",
     "@types/flexsearch": "0.7.6",
-    "@types/is-touch-device": "1.0.2",
-    "@types/lodash.debounce": "4.0.9",
-    "@types/marked": "5.0.2",
-    "@types/node": "20.11.24",
-    "@types/postcss-preset-env": "7.7.0",
+    "@types/is-touch-device": "1.0.3",
+    "@types/lodash.clonedeep": "4.5.9",
+    "@types/node": "22.9.0",
     "@types/sortablejs": "1.15.8",
-    "@typescript-eslint/eslint-plugin": "7.1.1",
-    "@typescript-eslint/parser": "7.1.1",
-    "@vitejs/plugin-legacy": "5.3.1",
-    "@vitejs/plugin-vue": "5.0.4",
-    "@vue/eslint-config-typescript": "12.0.0",
-    "@vue/test-utils": "2.4.4",
-    "@vue/tsconfig": "0.5.1",
-    "autoprefixer": "10.4.18",
-    "browserslist": "4.23.0",
-    "caniuse-lite": "1.0.30001593",
-    "css-has-pseudo": "6.0.2",
+    "@typescript-eslint/eslint-plugin": "8.14.0",
+    "@typescript-eslint/parser": "8.14.0",
+    "@vitejs/plugin-legacy": "5.4.3",
+    "@vitejs/plugin-vue": "5.2.0",
+    "@vue/eslint-config-typescript": "14.1.3",
+    "@vue/test-utils": "2.4.6",
+    "@vue/tsconfig": "0.6.0",
+    "autoprefixer": "10.4.20",
+    "browserslist": "4.24.2",
+    "caniuse-lite": "1.0.30001680",
     "csstype": "3.1.3",
-    "cypress": "13.6.6",
-    "esbuild": "0.20.1",
-    "eslint": "8.57.0",
-    "eslint-plugin-vue": "9.22.0",
-    "happy-dom": "13.6.2",
-    "histoire": "0.17.9",
-    "postcss": "8.4.35",
+    "cypress": "13.15.2",
+    "esbuild": "0.24.0",
+    "eslint": "9.14.0",
+    "eslint-plugin-vue": "9.31.0",
+    "happy-dom": "15.11.6",
+    "histoire": "0.17.17",
+    "postcss": "8.4.49",
     "postcss-easing-gradients": "3.0.1",
-    "postcss-easings": "4.0.0",
-    "postcss-focus-within": "8.0.1",
-    "postcss-preset-env": "9.4.0",
-    "rollup": "4.12.0",
+    "postcss-preset-env": "10.1.0",
+    "rollup": "4.26.0",
     "rollup-plugin-visualizer": "5.12.0",
-    "sass": "1.71.1",
-    "start-server-and-test": "2.0.3",
-    "typescript": "5.3.3",
-    "vite": "5.1.5",
-    "vite-plugin-inject-preload": "1.3.3",
-    "vite-plugin-pwa": "0.19.2",
+    "sass-embedded": "1.81.0",
+    "start-server-and-test": "2.0.8",
+    "typescript": "5.6.3",
+    "unplugin-inject-preload": "3.0.0",
+    "vite": "5.4.11",
+    "vite-plugin-pwa": "0.21.0",
     "vite-plugin-sentry": "1.4.0",
     "vite-svg-loader": "5.1.0",
-    "vitest": "1.3.1",
-    "vue-tsc": "2.0.4",
-    "wait-on": "7.2.0",
-    "workbox-cli": "7.0.0"
+    "vitest": "2.1.5",
+    "vue-tsc": "2.1.10",
+    "wait-on": "8.0.1",
+    "workbox-cli": "7.3.0"
   },
   "pnpm": {
     "patchedDependencies": {
-      "flexsearch@0.7.31": "patches/flexsearch@0.7.31.patch"
+      "@github/hotkey@3.1.1": "patches/@github__hotkey@3.1.1.patch",
+      "flexsearch@0.7.43": "patches/flexsearch@0.7.43.patch"
     }
   }
 }

frontend/patches/@github__hotkey@3.1.1.patch

@@ -0,0 +1,28 @@
+diff --git a/dist/index.js b/dist/index.js
+index b6e6e0a6864cb00bc085b8d4503a705cb3bc8404..0466ef46406b0df41c8d0bb9a5bac9eabf4a50de 100644
+--- a/dist/index.js
++++ b/dist/index.js
+@@ -368,10 +368,12 @@ const sequenceTracker = new SequenceTracker({
+ function keyDownHandler(event) {
+     if (event.defaultPrevented)
+         return;
+-    if (!(event.target instanceof Node))
++    const target = event.explicitOriginalTarget || event.target;
++    if (target.shadowRoot)
+         return;
+-    if (isFormField(event.target)) {
+-        const target = event.target;
++    if (!(target instanceof Node))
++        return;
++    if (isFormField(target)) {
+         if (!target.id)
+             return;
+         if (!target.ownerDocument.querySelector(`[data-hotkey-scope="${target.id}"]`))
+@@ -385,7 +387,6 @@ function keyDownHandler(event) {
+     sequenceTracker.registerKeypress(event);
+     currentTriePosition = newTriePosition;
+     if (newTriePosition instanceof Leaf) {
+-        const target = event.target;
+         let shouldFire = false;
+         let elementToFire;
+         const formField = isFormField(target);

frontend/patches/flexsearch@0.7.31.patch

@@ -1,16 +0,0 @@
-diff --git a/index.d.ts b/index.d.ts
-deleted file mode 100644
-index 9f39f41073864b83968bdaa242ac4e3c3149685a..0000000000000000000000000000000000000000
-diff --git a/package.json b/package.json
-index 8968f5bf8010ff194240591c8b83299f7328e79d..6d84b6f590a841b129ed8b3860cb786df5a185c0 100644
---- a/package.json
-+++ b/package.json
-@@ -22,8 +22,6 @@
-   },
-   "main": "dist/flexsearch.bundle.js",
-   "browser": "dist/flexsearch.bundle.js",
--  "module": "dist/module/index.js",
--  "types": "./index.d.ts",
-   "preferGlobal": false,
-   "repository": {
-     "type": "git",

frontend/patches/flexsearch@0.7.43.patch

@@ -0,0 +1,18 @@
+diff --git a/package.json b/package.json
+index c154e54029c94be444916fb2249941e7182d80ed..54a65c42a42c4627506e016132becc43b47a517c 100644
+--- a/package.json
++++ b/package.json
+@@ -28,13 +28,11 @@
+     "email": "info@nextapps.de"
+   },
+   "main": "dist/flexsearch.bundle.min.js",
+-  "module": "dist/flexsearch.bundle.module.min.js",
+   "browser": {
+     "dist/flexsearch.bundle.min.js": "./dist/flexsearch.bundle.min.js",
+     "dist/flexsearch.bundle.module.min.js": "./dist/flexsearch.bundle.module.min.js",
+     "worker_threads": false
+   },
+-  "types": "./index.d.ts",
+   "scripts": {
+     "build": "npm run copy && npm run build:bundle",
+     "build:bundle": "node task/build RELEASE=bundle DEBUG=false SUPPORT_WORKER=true SUPPORT_ENCODER=true SUPPORT_CACHE=true SUPPORT_ASYNC=true SUPPORT_STORE=true SUPPORT_TAGS=true SUPPORT_SUGGESTION=true SUPPORT_SERIALIZE=true SUPPORT_DOCUMENT=true POLYFILL=false",