.all-contributorsrc

@@ -3,19 +3,15 @@
   "projectOwner": "adaures",
   "repoType": "gitlab",
   "repoHost": "https://code.castopod.org",
-  "files": [
-    "README.md",
-    "docs/src/index.md"
-  ],
+  "files": ["README.md"],
   "imageSize": 100,
   "commit": false,
-  "contributorsPerLine": 7,
   "contributors": [
     {
       "login": "yassinedoghri",
       "name": "Yassine Doghri",
-      "avatar_url": "https://code.castopod.org/uploads/-/system/user/avatar/3/avatar.png",
-      "profile": "https://github.com/yassinedoghri",
+      "avatar_url": "https://avatars.githubusercontent.com/u/11021441?v=4",
+      "profile": "https://yassinedoghri.com",
       "contributions": [
         "code",
         "bug",
@@ -100,24 +96,14 @@
       "name": "Lyonel Bernard",
       "avatar_url": "https://castopod.org/assets/images/castopod-avatar.jpg",
       "profile": "https://twitter.com/lyonelbernard",
-      "contributions": [
-        "bug",
-        "question",
-        "audio",
-        "ideas"
-      ]
+      "contributions": ["bug", "question", "audio", "ideas"]
     },
     {
       "login": "ctlw83",
       "name": "Christopher Lagonick-Weitzel",
       "avatar_url": "https://secure.gravatar.com/avatar/7c2a721b52d0763673a600e8f01bd745?s=80&d=identicon",
       "profile": "https://www.crypticchameleon.com/",
-      "contributions": [
-        "bug",
-        "question",
-        "audio",
-        "ideas"
-      ]
+      "contributions": ["bug", "question", "audio", "ideas"]
     },
     {
       "login": "ernestoacostame",
@@ -154,19 +140,14 @@
       "name": "Bastien Luneteau",
       "avatar_url": "https://secure.gravatar.com/avatar/ad63ee8ef8e3db8253d21e5012d2724f?s=80&d=identicon",
       "profile": "https://code.castopod.org/Behel",
-      "contributions": [
-        "code",
-        "bug"
-      ]
+      "contributions": ["code", "bug"]
     },
     {
       "login": "cecillie",
       "name": "Cécile Ricordeau",
       "avatar_url": "https://castopod.org/assets/images/castopod-avatar.jpg",
       "profile": "https://www.cecillie.fr/",
-      "contributions": [
-        "design"
-      ]
+      "contributions": ["design"]
     },
     {
       "login": "PatrykMis",
@@ -185,48 +166,35 @@
       "name": "Marcin Lewandowski",
       "avatar_url": "https://secure.gravatar.com/avatar/eed8337939641eac5ad0b570bd6acf96?s=80&d=identicon",
       "profile": "https://code.castopod.org/mspanc",
-      "contributions": [
-        "bug",
-        "ideas"
-      ]
+      "contributions": ["bug", "ideas"]
     },
     {
       "login": "SJanik",
       "name": "Sebastian Janik",
       "avatar_url": "https://castopod.org/assets/images/castopod-avatar.jpg",
       "profile": "https://code.castopod.org/SJanik",
-      "contributions": [
-        "code"
-      ]
+      "contributions": ["code"]
     },
     {
       "login": "patryk",
       "name": "Patryk Karczmarczyk",
       "avatar_url": "https://castopod.org/assets/images/castopod-avatar.jpg",
       "profile": "https://code.castopod.org/patryk",
-      "contributions": [
-        "code"
-      ]
+      "contributions": ["code"]
     },
     {
       "login": "ddenis",
       "name": "denis d",
       "avatar_url": "https://castopod.org/assets/images/castopod-avatar.jpg",
       "profile": "https://code.castopod.org/ddenis",
-      "contributions": [
-        "bug",
-        "ideas"
-      ]
+      "contributions": ["bug", "ideas"]
     },
     {
       "login": "douglaskastle",
       "name": "Douglas Kastle",
       "avatar_url": "https://secure.gravatar.com/avatar/b7e652ba4b6bcd440afa069e7f7bc9e6?s=80&d=identicon",
       "profile": "https://code.castopod.org/douglaskastle",
-      "contributions": [
-        "bug",
-        "ideas"
-      ]
+      "contributions": ["bug", "ideas"]
     },
     {
       "login": "cExplorer",
@@ -246,66 +214,49 @@
       "name": "ImaCrea",
       "avatar_url": "https://castopod.org/assets/images/castopod-avatar.jpg",
       "profile": "https://code.castopod.org/imacrea",
-      "contributions": [
-        "bug",
-        "ideas"
-      ]
+      "contributions": ["bug", "ideas"]
     },
     {
       "login": "jonas",
       "name": "Jonas S",
       "avatar_url": "https://castopod.org/assets/images/castopod-avatar.jpg",
       "profile": "https://code.castopod.org/jonas",
-      "contributions": [
-        "code"
-      ]
+      "contributions": ["code"]
     },
     {
       "login": "yannL",
       "name": "LEFEBVRE Yann",
       "avatar_url": "https://secure.gravatar.com/avatar/9c46600ce566ec6d526370d8e104b1c8?s=80&d=identicon",
       "profile": "https://code.castopod.org/yannL",
-      "contributions": [
-        "bug"
-      ]
+      "contributions": ["bug"]
     },
     {
       "login": "spaetz",
       "name": "Sebastian Späth",
       "avatar_url": "https://secure.gravatar.com/avatar/278e1af65e82993efd0ba7bbbacf6435?s=80&d=identicon",
       "profile": "https://code.castopod.org/spaetz",
-      "contributions": [
-        "bug",
-        "ideas"
-      ]
+      "contributions": ["bug", "ideas"]
     },
     {
       "login": "rocky",
       "name": "rocky III",
       "avatar_url": "https://castopod.org/assets/images/castopod-avatar.jpg",
       "profile": "https://code.castopod.org/rocky",
-      "contributions": [
-        "bug"
-      ]
+      "contributions": ["bug"]
     },
     {
       "login": "Regenpfeifer",
       "name": "Hermann Josef Eckl",
       "avatar_url": "https://code.castopod.org/uploads/-/system/user/avatar/103/avatar.png",
       "profile": "https://code.castopod.org/Regenpfeifer",
-      "contributions": [
-        "bug"
-      ]
+      "contributions": ["bug"]
     },
     {
       "login": "cyrilledel",
       "name": "Delhaye Cyrille",
       "avatar_url": "https://castopod.org/assets/images/castopod-avatar.jpg",
       "profile": "https://code.castopod.org/cyrilledel",
-      "contributions": [
-        "bug",
-        "ideas"
-      ]
+      "contributions": ["bug", "ideas"]
     },
     {
       "login": "otetranome",
@@ -493,9 +444,7 @@
       "name": "Dimitri Regnier",
       "avatar_url": "https://castopod.org/assets/images/castopod-avatar.jpg",
       "profile": "https://dimitriregnier.net/",
-      "contributions": [
-        "ideas"
-      ]
+      "contributions": ["ideas"]
     },
     {
       "login": "irithys",
@@ -521,18 +470,6 @@
         }
       ]
     },
-    {
-      "login": "ghose",
-      "name": "ghose (XoseM)",
-      "avatar_url": "https://crowdin-static.downloads.crowdin.com/avatar/12617257/large/a201650da44fed28890b0e0d8477a663.jpg",
-      "profile": "https://crowdin.com/profile/xosem",
-      "contributions": [
-        {
-          "type": "translation",
-          "url": "https://translate.castopod.org"
-        }
-      ]
-    },
     {
       "login": "basen1982",
       "name": "Andreas Olsson",
@@ -594,7 +531,7 @@
       ]
     },
     {
-      "login": "ahmed.sabouni11",
+      "login": "ahmedsabouni",
       "name": "Ahmed Sabouni",
       "avatar_url": "https://avatars.githubusercontent.com/u/74497842?v=4",
       "profile": "https://github.com/ahmedsabouni",
@@ -610,9 +547,28 @@
       "name": "KrzysztofDomanczyk",
       "avatar_url": "https://avatars.githubusercontent.com/u/75178474?v=4",
       "profile": "https://github.com/KrzysztofDomanczyk",
-      "contributions": [
-        "code"
-      ]
+      "contributions": ["code"]
+    },
+    {
+      "login": "Dwev",
+      "name": "Guy Martin",
+      "avatar_url": "https://avatars.githubusercontent.com/u/46626050?v=4",
+      "profile": "https://github.com/Dwev",
+      "contributions": ["bug", "code"]
+    },
+    {
+      "login": "prcutler",
+      "name": "Paul Cutler",
+      "avatar_url": "https://avatars.githubusercontent.com/u/67276?v=4",
+      "profile": "https://github.com/prcutler",
+      "contributions": ["doc", "question", "ideas"]
+    },
+    {
+      "login": "nateritter",
+      "name": "Nate Ritter",
+      "avatar_url": "https://avatars.githubusercontent.com/u/198798?v=4",
+      "profile": "https://github.com/nateritter",
+      "contributions": ["code"]
     }
   ],
   "commitConvention": "none"

docker/development/Dockerfile → .devcontainer/Dockerfile

@@ -4,13 +4,10 @@
 # ⚠️ NOT optimized for production
 # should be used only for development purposes
 #---------------------------------------------------
-FROM php:8.1-fpm
+FROM php:8.4-fpm
 
 LABEL maintainer="Yassine Doghri <yassine@doghri.fr>"
 
-COPY . /castopod
-WORKDIR /castopod
-
 # Install composer
 COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
 
@@ -50,11 +47,4 @@ RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
     && docker-php-ext-enable redis \
     # mysqli for database access
     && docker-php-ext-install mysqli \
-    && docker-php-ext-enable mysqli \
-    # configure php
-    && echo "file_uploads = On\n" \
-         "memory_limit = 512M\n" \
-         "upload_max_filesize = 500M\n" \
-         "post_max_size = 512M\n" \
-         "max_execution_time = 300\n" \
-         > /usr/local/etc/php/conf.d/uploads.ini
+    && docker-php-ext-enable mysqli

.devcontainer/crontab

+* * * * * /usr/local/bin/php /workspaces/castopod/spark tasks:run >> /dev/null 2>&1

.devcontainer/devcontainer.json

 // For format details, see https://aka.ms/vscode-remote/devcontainer.json or this file's README at:
 // https://github.com/microsoft/vscode-dev-containers/tree/v0.117.1/containers/docker-existing-dockerfile
 {
-  "name": "Castopod dev",
-  "dockerComposeFile": ["../docker-compose.yml", "./docker-compose.yml"],
+  "name": "castopod.local",
+  "dockerComposeFile": ["./docker-compose.yml"],
   "service": "app",
-  "workspaceFolder": "/castopod",
-  "postCreateCommand": "composer install && pnpm install && pnpm run build:static",
-  "postStartCommand": "crontab ./crontab && cron && php spark serve --host 0.0.0.0",
-  "postAttachCommand": "crontab ./crontab && service cron reload",
+  "workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
+  "postCreateCommand": "composer install && pnpm install && pnpm run build:static && php spark migrate --all && php spark db:seed DevSeeder",
+  "postStartCommand": "git config --global --add safe.directory ${containerWorkspaceFolder} && crontab .devcontainer/crontab && cron && php spark serve --host 0.0.0.0",
+  "postAttachCommand": "crontab .devcontainer/crontab && service cron reload",
   "shutdownAction": "stopCompose",
   "features": {
     "ghcr.io/devcontainers/features/git:1": {},
@@ -30,9 +30,20 @@
           "spark": "php",
           "env": "dotenv",
           ".rsync-filter": "diff"
-        }
+        },
+        "json.schemas": [
+          {
+            "fileMatch": [
+              "plugins/**/manifest.json",
+              "tests/modules/Plugins/mocks/manifests/*.json",
+              "tests/modules/Plugins/mocks/plugins/**/manifest.json"
+            ],
+            "url": "/workspaces/castopod/modules/Plugins/Manifest/manifest.schema.json"
+          }
+        ]
       },
       "extensions": [
+        "astro-build.astro-vscode",
         "bmewburn.vscode-intelephense-client",
         "bradlc.vscode-tailwindcss",
         "breezelin.phpstan",
@@ -49,8 +60,10 @@
         "runem.lit-plugin",
         "streetsidesoftware.code-spell-checker",
         "stylelint.vscode-stylelint",
+        "unifiedjs.vscode-mdx",
         "wayou.vscode-todo-highlight",
-        "yzhang.markdown-all-in-one"
+        "yzhang.markdown-all-in-one",
+        "42Crunch.vscode-openapi"
       ]
     }
   }

.devcontainer/docker-compose.yml

 version: "3"
+
 services:
   app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - 8080:8080
+    volumes:
+      - ../..:/workspaces:cached
+      - ./uploads.ini:/usr/local/etc/php/conf.d/uploads.ini
+    environment:
+      CI_ENVIRONMENT: development
+      vite_environment: development
+      app_forceGlobalSecureRequests: 0 #false
+      app_baseURL: http://localhost:8080/
+      media_baseURL: http://localhost:8080/
+      admin_gateway: cp-admin
+      auth_gateway: cp-auth
+      analytics_salt: dev_analytics_salt
+      database_default_hostname: mariadb
+      database_default_database: castopod
+      database_default_username: castopod
+      database_default_password: castopod
+      database_default_DBPrefix: cp_
+      restapi_enabled: 1 #true
+      email_fromEmail: hello@castopod.local
+      email_SMTPCrypto: ""
+      email_SMTPHost: mailpit
+      email_SMTPUser: castopod
+      email_SMTPPass: castopod
+      email_SMTPPort: 1025
+    depends_on:
+      - redis
+      - mariadb
+
+  redis:
+    image: redis:alpine
+    volumes:
+      - redis:/data
+
+  mariadb:
+    image: mariadb:10.2
+    volumes:
+      - ./initdb:/docker-entrypoint-initdb.d
+      - mariadb:/var/lib/mysql
+    environment:
+      MYSQL_ROOT_PASSWORD: root
+      MYSQL_DATABASE: castopod
+      MYSQL_USER: castopod
+      MYSQL_PASSWORD: castopod
+
+  phpmyadmin:
+    image: phpmyadmin/phpmyadmin:latest
+    environment:
+      PMA_HOST: mariadb
+      PMA_PORT: 3306
+      UPLOAD_LIMIT: 300M
+    ports:
+      - 8888:80
+    volumes:
+      - phpmyadmin:/sessions
+    depends_on:
+      - mariadb
+
+  mailpit:
+    image: axllent/mailpit
+    restart: always
     volumes:
-      # Mounts the project folder to '/workspace'. While this file is in .devcontainer,
-      # mounts are relative to the first file in the list, which is a level up.
-      - .:/castopod:cached
+      - mailpit:/data
+    ports:
+      - 8025:8025
+      - 1025:1025
+    environment:
+      MP_MAX_MESSAGES: 5000
+      MP_DATA_FILE: /data/mailpit.db
+      MP_SMTP_AUTH_ACCEPT_ANY: 1
+      MP_SMTP_AUTH_ALLOW_INSECURE: 1
 
-    # Overrides default command so things don't shut down after the process ends.
-    command: /bin/sh -c "while sleep 1000; do :; done"
+volumes:
+  redis:
+  mariadb:
+  phpmyadmin:
+  mailpit:

.devcontainer/uploads.ini

+file_uploads = On
+memory_limit = 512M
+upload_max_filesize = 500M
+post_max_size = 512M
+max_execution_time = 300

.eslintrc.json

-{
-  "env": {
-    "browser": true,
-    "es2020": true
-  },
-  "parser": "@typescript-eslint/parser",
-  "plugins": ["@typescript-eslint"],
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended",
-    "plugin:prettier/recommended"
-  ],
-  "parserOptions": {
-    "ecmaVersion": 11,
-    "sourceType": "module"
-  },
-  "rules": {}
-}

.gitignore

@@ -128,11 +128,11 @@ nb-configuration.xml
 
 # Visual Studio Code
 .vscode/
+.history/
 tmp/
 
 /results/
 /phpunit*.xml
-/.phpunit.*.cache
 
 # js package manager
 yarn.lock
@@ -188,3 +188,7 @@ data
 castopod/
 castopod-*.zip
 castopod-*.tar.gz
+
+# Plugins
+plugins/*
+!plugins/.gitkeep

.gitlab-ci.yml

-image: code.castopod.org:5050/adaures/castopod:ci
+image: code.castopod.org:5050/adaures/castopod:ci-php8.4
 
 stages:
   - prepare
@@ -53,6 +53,7 @@ lint-commit-msg:
     - main
     - beta
     - alpha
+    - next
 
 lint-php:
   stage: quality
@@ -69,7 +70,7 @@ lint-php:
 lint-js:
   stage: quality
   script:
-    - pnpm run prettier
+    - pnpm run format
     - pnpm run typecheck
     - pnpm run lint
     - pnpm run lint:css
@@ -79,14 +80,14 @@ lint-js:
 tests:
   stage: quality
   services:
-    - mariadb
+    - mariadb:10.11
   variables:
     MYSQL_ROOT_PASSWORD: "R00Tp4ssW0RD"
     MYSQL_DATABASE: "test"
     MYSQL_USER: "castopod"
     MYSQL_PASSWORD: "castopod"
   script:
-    - echo "SHOW DATABASES;" | mysql --user=root --password="$MYSQL_ROOT_PASSWORD" --host=mariadb "$MYSQL_DATABASE"
+    - echo "SHOW DATABASES;" | mariadb --user=root --password="$MYSQL_ROOT_PASSWORD" --host=mariadb "$MYSQL_DATABASE" --skip_ssl
 
     # run phpunit without code coverage
     # TODO: add code coverage
@@ -120,6 +121,7 @@ bundle:
     - main
     - beta
     - alpha
+    - next
 
 release:
   stage: release
@@ -148,6 +150,7 @@ release:
     - main
     - beta
     - alpha
+    - next
 
 website:
   stage: deploy
@@ -162,9 +165,6 @@ documentation:
   trigger:
     include: docs/.gitlab-ci.yml
     strategy: depend
-  only:
-    changes:
-      - docs/**/*
 
 docker:
   stage: build
@@ -179,5 +179,6 @@ docker:
       - main
       - beta
       - alpha
+      - next
     variables:
       - $CI_PROJECT_NAMESPACE == "adaures"

.husky/commit-msg

-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
 pnpm exec commitlint --verbose --edit "$1"

.husky/pre-commit

-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
 # CaptainHook 5.10.0
 
 INTERACTIVE="--no-interaction"

.husky/pre-push

-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
 # CaptainHook 5.10.0
 
 INTERACTIVE="--no-interaction"

.prettierrc.json

@@ -2,7 +2,7 @@
   "trailingComma": "es5",
   "overrides": [
     {
-      "files": "*.md",
+      "files": ["*.md", "*.mdx"],
       "options": {
         "proseWrap": "always"
       }

.releaserc.json

@@ -8,11 +8,74 @@
     {
       "name": "beta",
       "prerelease": true
+    },
+    {
+      "name": "next",
+      "prerelease": true
     }
   ],
   "plugins": [
-    "@semantic-release/commit-analyzer",
-    "@semantic-release/release-notes-generator",
+    [
+      "@semantic-release/commit-analyzer",
+      {
+        "preset": "conventionalcommits",
+        "releaseRules": [
+          {
+            "type": "docs",
+            "scope": "README",
+            "release": "patch"
+          },
+          {
+            "type": "refactor",
+            "scope": "core-*",
+            "release": "minor"
+          },
+          {
+            "type": "refactor",
+            "release": "patch"
+          }
+        ],
+        "parserOpts": {
+          "noteKeywords": ["BREAKING CHANGE", "BREAKING CHANGES", "BREAKING"]
+        }
+      }
+    ],
+    [
+      "@semantic-release/release-notes-generator",
+      {
+        "preset": "conventionalcommits",
+        "parserOpts": {
+          "noteKeywords": ["BREAKING CHANGE", "BREAKING CHANGES", "BREAKING"]
+        },
+        "presetConfig": {
+          "types": [
+            {
+              "type": "feat",
+              "section": "Features"
+            },
+            {
+              "type": "fix",
+              "section": "Bug Fixes"
+            },
+            {
+              "type": "chore",
+              "section": "Internal",
+              "hidden": false
+            },
+            {
+              "type": "refactor",
+              "section": "Internal",
+              "hidden": false
+            },
+            {
+              "type": "perf",
+              "section": "Internal",
+              "hidden": false
+            }
+          ]
+        }
+      }
+    ],
     "@semantic-release/changelog",
     [
       "@semantic-release/exec",

.rsync-filter

 # rsync filter rules to copy required files for Castopod's bundle
 
-- app/Resources/
++ resources/icons/***
+- resources/**
 + app/***
 + modules/***
++ plugins/***
 + public/***
 + themes/***
 + vendor/***
@@ -11,4 +13,5 @@
 + LICENSE.md
 + README.md
 + spark
++ php-icons.php
 - **

.stylelintrc.json

@@ -10,10 +10,17 @@
           "responsive",
           "variants",
           "screen",
-          "layer"
+          "layer",
+          "config"
         ]
       }
     ],
+    "at-rule-no-deprecated": [
+      true,
+      {
+        "ignoreAtRules": ["apply"]
+      }
+    ],
     "function-no-unknown": [
       true,
       {

CHANGELOG.md

+## [2.0.0-next.3](https://code.castopod.org/adaures/castopod/compare/v2.0.0-next.2...v2.0.0-next.3) (2024-12-30)
+
+### Features
+
+- **api:** add Episode create and publish endpoints
+  ([a90cdfd](https://code.castopod.org/adaures/castopod/commit/a90cdfdcdbde7a8fb520c6815d7b757947aea055))
+- **image:** add image size's width and height
+  ([f50098e](https://code.castopod.org/adaures/castopod/commit/f50098ec8926c8ae40718f5f128b6de7fe721b46))
+- **plugins:** add defaultValue for all field types
+  ([d3a98db](https://code.castopod.org/adaures/castopod/commit/d3a98db6d0112b5f59daddd2708c09dd2e595332))
+- **plugins:** add group field type + multiple option to render field arrays
+  ([11ccd0e](https://code.castopod.org/adaures/castopod/commit/11ccd0ebe71d476d8c0dbfe28edcf01f7f362b83))
+- **plugins:** add html field type + CodeEditor component + rework html head
+  generation
+  ([8cf9c6d](https://code.castopod.org/adaures/castopod/commit/8cf9c6dc833aedcccbc4cdb309b111f84d97d629))
+- **rss:** add option for 301 redirect to new feed url
+  ([8402cc2](https://code.castopod.org/adaures/castopod/commit/8402cc29d2d0c61b014a7e03e5ccce7d3c11782a))
+
+### Bug Fixes
+
+- add downloads_count to episodes table, computed every hour
+  ([f981937](https://code.castopod.org/adaures/castopod/commit/f9819376455c371eb5bd3c84ad938698335a3d67))
+- allow passing json to app.proxyIPs config to set it
+  ([cbf739e](https://code.castopod.org/adaures/castopod/commit/cbf739e95cc0ad6e83a21353b8f4678e68d74f63))
+- **api:** cast integers when creating episode
+  ([775b302](https://code.castopod.org/adaures/castopod/commit/775b302f7c886e30e133c8a8c68764301b6c663b))
+- **docker-image:** clear cache to account for new assets and data structure
+  changes
+  ([63c763f](https://code.castopod.org/adaures/castopod/commit/63c763f941195b3758c4b91acd8c350a5e7bb9c2)),
+  closes [#510](https://code.castopod.org/adaures/castopod/issues/510)
+- edit remap functions to get episode in episode admin controllers
+  ([9f74cca](https://code.castopod.org/adaures/castopod/commit/9f74cca342fedd896977efd2e89d0143959f3c4f))
+- **episode:** do not change slug when editing episode title
+  ([a83afb0](https://code.castopod.org/adaures/castopod/commit/a83afb0004511db80337806577fbc36f8d777116)),
+  closes [#513](https://code.castopod.org/adaures/castopod/issues/513)
+- **fediverse:** add "processing" and "failed" statuses to better manage
+  broadcast load
+  ([1d7583d](https://code.castopod.org/adaures/castopod/commit/1d7583d738219574ae3d45d294dc94e7e406472b)),
+  closes [#511](https://code.castopod.org/adaures/castopod/issues/511)
+- **icons:** set correct names for lock and lock-unlock icons in premium banner
+  ([37ee6d3](https://code.castopod.org/adaures/castopod/commit/37ee6d35b4bb66ce23dc271fb846200d1be0e7f6))
+- **plugins:** clear cache after activating or deactivating plugin
+  ([08c7df2](https://code.castopod.org/adaures/castopod/commit/08c7df2a5d5be340490c78deeef823167eb1b2fc))
+- **plugins:** delete relevant cache when submitting settings
+  ([00bd4c0](https://code.castopod.org/adaures/castopod/commit/00bd4c02ee23b181d74e7731626bfec3b1ff4916))
+- **podcast-model:** always query podcast from database when clearing cache
+  ([d30c49c](https://code.castopod.org/adaures/castopod/commit/d30c49cdff380c15db4f1851631a255a5baffcbe))
+- **premium-podcasts:** update query to validate subscription
+  ([2b1bbf3](https://code.castopod.org/adaures/castopod/commit/2b1bbf34303ead927f433b5c7d5d888ca3799954))
+- **preview:** delete episode preview cache after editing episode
+  ([732d429](https://code.castopod.org/adaures/castopod/commit/732d42923d0d7a66ff1ebd5841458e4205060560)),
+  closes [#514](https://code.castopod.org/adaures/castopod/issues/514)
+- **release:** add conventional-changelog-conventionalcommits for CHANGELOG
+  generation
+  ([6934c8a](https://code.castopod.org/adaures/castopod/commit/6934c8aa8f0b7f9eea7c3f6f4089c56b2391d9a6))
+- **rss:** add subscription id to cache name to prevent premium feeds from
+  overlapping
+  ([74f9325](https://code.castopod.org/adaures/castopod/commit/74f9325946d03a0d4efce57045e41cc9454ff97c))
+- set user as www-data when running cron jobs in docker's supervisord config
+  ([65d74f1](https://code.castopod.org/adaures/castopod/commit/65d74f14e612be3757c9304518eee112705f5ff9))
+- typo in EpisodeController remap function to get episode
+  ([f288a75](https://code.castopod.org/adaures/castopod/commit/f288a750f580ab19b04a170cc76bf8769084e19d))
+- update select and multi-select options to value/label arrays
+  ([63f93f5](https://code.castopod.org/adaures/castopod/commit/63f93f585bec4a11022cc8c75deb34968cba2348))
+
+### Internal
+
+- **plugins:** create Field objects per field type in settings forms + handle
+  rendering in class
+  ([34be5bc](https://code.castopod.org/adaures/castopod/commit/34be5bccabb7531afdcc6ebaf1dd39e4dfbe0677))
+- remove fields from podcast and episode entities to be replaced with plugins
+  ([b869acb](https://code.castopod.org/adaures/castopod/commit/b869acb3a988a3616d883a41c25d9c8409bd5518))
+- rename controller methods for views and actions to be more consistent
+  ([85704bf](https://code.castopod.org/adaures/castopod/commit/85704bfbe03fe5e38ff5e76a0e1cf0e5f1275f57))
+- update CodeIgniter to v4.5.6
+  ([f295e9a](https://code.castopod.org/adaures/castopod/commit/f295e9aa4ca3129df24a22779f7c19bba7fac370))
+- update codigniter-icons to v1.0.1
+  ([fa6967e](https://code.castopod.org/adaures/castopod/commit/fa6967e65cef1705b19cbb205132c4c751507d53))
+- update js dependencies to latest
+  ([70c9797](https://code.castopod.org/adaures/castopod/commit/70c97971fcf5bbeee826578057ae0e3afbbbd8a8))
+
+# [2.0.0-next.2](https://code.castopod.org/adaures/castopod/compare/v2.0.0-next.1...v2.0.0-next.2) (2024-07-08)
+
+### Bug Fixes
+
+- **audio-player:** set player icons to default instead of missing Castopod's
+  ([0ba0a25](https://code.castopod.org/adaures/castopod/commit/0ba0a25b11bd67aeeb47a8179b72152dfd4a36da))
+- broken icon call in frontend default pages template
+  ([3228362](https://code.castopod.org/adaures/castopod/commit/322836254e86be7878e21438177ee8f73f03a2fa))
+- **manifest:** set repository url as required in docstring typings
+  ([a8c81b3](https://code.castopod.org/adaures/castopod/commit/a8c81b3fa19a28dbd608027c231dcac31eafb38f))
+- set correct icons parameters in map and funding links views
+  ([5d35524](https://code.castopod.org/adaures/castopod/commit/5d355248753be24e3cf324144ff076f2fc23be88)),
+  closes [#500](https://code.castopod.org/adaures/castopod/issues/500)
+
+### Features
+
+- **plugins:** add `minCastopodVersion` to denote incompatibility with previous
+  Castopod versions
+  ([fc9ea75](https://code.castopod.org/adaures/castopod/commit/fc9ea7597e454e5c7c7af043d29af7bbe119e342))
+- **plugins:** load and display LICENSE.md file if found in plugin's directory
+  ([fee7905](https://code.castopod.org/adaures/castopod/commit/fee7905935a9adf963b4485b437fe4d972c14b5f))
+
+# [2.0.0-next.1](https://code.castopod.org/adaures/castopod/compare/v1.11.0...v2.0.0-next.1) (6/19/2024)
+
+### Bug Fixes
+
+- add missing php-icons config file to bundle
+  ([56612f0](https://code.castopod.org/adaures/castopod/commit/56612f0c762aa2d98e3c8c77fba88ffdf6f46a44))
+- **docs:** add base to og image using env variable
+  ([fe67659](https://code.castopod.org/adaures/castopod/commit/fe676590f23a33bdbe8905d234760923c029e350))
+- **import:** rewrite download_file helper to output curl response directly to
+  file
+  ([eb7ad2f](https://code.castopod.org/adaures/castopod/commit/eb7ad2f7e1c0137f222f47e47062887de42c4824))
+- include app/Resources/icons folder to bundle
+  ([3fd5efc](https://code.castopod.org/adaures/castopod/commit/3fd5efc7956977acc19e53182f25b12813964a7d))
+- **platforms:** add platforms service + reduce memory consumption when
+  rendering platform cards
+  ([fe73e9f](https://code.castopod.org/adaures/castopod/commit/fe73e9fae9ea5d5ce946680aec194308bb2e620c))
+- set owner email visibility when editing podcast
+  ([fc4f982](https://code.castopod.org/adaures/castopod/commit/fc4f9825568cd4384c5b3cfe972accd146548807)),
+  closes [#473](https://code.castopod.org/adaures/castopod/issues/473)
+
+### Build System
+
+- release next major version as prerelease
+  ([8275226](https://code.castopod.org/adaures/castopod/commit/827522643e9f8a5ea9be05b4847dc637f0f43a13))
+
+### Features
+
+- add Plugins module with base files for plugins architecture
+  ([7253e13](https://code.castopod.org/adaures/castopod/commit/7253e13ac2118f6f165f54ea0cbcd63d51ab9205))
+- **plugins:** abstract settings form for general, podcast and episode types
+  ([b62b483](https://code.castopod.org/adaures/castopod/commit/b62b483ad9ff114a22a9ee52e1a1a2c9fa444d42))
+- **plugins:** activate / deactivate plugin using settings table
+  ([27d2a1b](https://code.castopod.org/adaures/castopod/commit/27d2a1b0ffba9454dd54cbb4251a2d179b09762a))
+- **plugins:** add aside with plugin metadata next to plugin's readme
+  ([dfb7888](https://code.castopod.org/adaures/castopod/commit/dfb7888aeb689b4066abc37084e08cd7f1d0f15d))
+- **plugins:** add before channel/item hooks to allow podcast/episode data edit
+  when generating rss
+  ([80d2c48](https://code.castopod.org/adaures/castopod/commit/80d2c48ee265cb32ed0d710c488292fcbc120044))
+- **plugins:** add json schema definition for plugin manifest
+  ([b5eddf3](https://code.castopod.org/adaures/castopod/commit/b5eddf351f6f6fa1c299fbac31cbd056ef232330))
+- **plugins:** add methods to easily retrieve general, podcast and episode
+  settings in hooks methods
+  ([3a900bb](https://code.castopod.org/adaures/castopod/commit/3a900bbab68b819cedf8943540d2ee0aeb6e8539))
+- **plugins:** add new field types + validate & cast user data before storing
+  settings
+  ([6f833fc](https://code.castopod.org/adaures/castopod/commit/6f833fc76a3aa6c6b87c27ad18a2fb90e537e21e))
+- **plugins:** add options to manifest for building forms and storing plugin
+  settings
+  ([3d8aedf](https://code.castopod.org/adaures/castopod/commit/3d8aedf9c34e6927b6d3b11445d5f0e669b347d7))
+- **plugins:** add settings page for podcast and episode if defined in the
+  plugin's manifest
+  ([89ac92f](https://code.castopod.org/adaures/castopod/commit/89ac92fb412a04231ce52fd6480c9ab893b19ef5))
+- **plugins:** add siteHead hook to add custom meta tags to public pages
+  ([e80a33b](https://code.castopod.org/adaures/castopod/commit/e80a33bf2ad4fe1b47037add7470a6c2770f4036))
+- **plugins:** display errors when plugin is invalid instead of crashing
+  ([8ec7909](https://code.castopod.org/adaures/castopod/commit/8ec79097bbdbcbce622518ef61c068f20e0ef74e))
+- **plugins:** handle empty states and long strings in UI
+  ([45ac2a4](https://code.castopod.org/adaures/castopod/commit/45ac2a4be96532b9456e6af1d26ba4ada3649303))
+- **plugins:** load and validate plugin manifest.json
+  ([1510e36](https://code.castopod.org/adaures/castopod/commit/1510e36c0acd2b254622ec230acd1d2461ee9bf3))
+- **plugins:** load plugins using file locator service
+  ([587938d](https://code.castopod.org/adaures/castopod/commit/587938d2bf307b823af143586b9ec9e9b44e8dc1))
+- **plugins:** load README.md file to view plugin's instructions in UI
+  ([e6bfdfc](https://code.castopod.org/adaures/castopod/commit/e6bfdfc3902705285701c13c8067fe0f538425c6))
+- **plugins:** register plugins using Plugin.php file instead of namespace +
+  simplify i18n structure
+  ([2035c39](https://code.castopod.org/adaures/castopod/commit/2035c39fd138a1fd408516bd1972ab6a02544c10))
+- **plugins:** uninstall plugins via CLI and admin UI
+  ([9a80de4](https://code.castopod.org/adaures/castopod/commit/9a80de40686bbf4288da21cc2a6dde8036580e47))
+- set owner email to hidden by default in podcast create form
+  ([7a6d9df](https://code.castopod.org/adaures/castopod/commit/7a6d9df6db8a6184b8250ced0475f3e741dde7f4))
+- support podcast:txt tag with verify use case
+  ([57e459e](https://code.castopod.org/adaures/castopod/commit/57e459e187ed048430f4137172e22396cd02bf81)),
+  closes [#468](https://code.castopod.org/adaures/castopod/issues/468)
+
+### BREAKING CHANGES
+
+- next major release including plugins architecture
+
+# [1.11.0](https://code.castopod.org/adaures/castopod/compare/v1.10.5...v1.11.0) (4/17/2024)
+
+### Bug Fixes
+
+- **premium:** set itunes:block on premium feeds to prevent indexing
+  ([88851b0](https://code.castopod.org/adaures/castopod/commit/88851b022663d575a816f0e2f33f0353767dd52d))
+- **rss:** generate podcast guid if empty
+  ([a5aef2a](https://code.castopod.org/adaures/castopod/commit/a5aef2a63e464632f3941649d455672835989e6c)),
+  closes [#450](https://code.castopod.org/adaures/castopod/issues/450)
+
+### Features
+
+- add trailer tags to rss if trailer episodes are present
+  ([80fdd9c](https://code.castopod.org/adaures/castopod/commit/80fdd9cfb4a95feac6ed0000435a013fc83e6892))
+- add transcript display to episode page
+  ([4d141fc](https://code.castopod.org/adaures/castopod/commit/4d141fceae56fa9e666b42c32a830ff9c68989db)),
+  closes [#411](https://code.castopod.org/adaures/castopod/issues/411)
+- **platforms:** add telegram to socials
+  ([004f804](https://code.castopod.org/adaures/castopod/commit/004f804045cd8e884361bb4318109fbdd7afc9a8))
+- **platforms:** add truefans.fm and episodes.fm
+  ([d046ecc](https://code.castopod.org/adaures/castopod/commit/d046ecc52f6ccd41d09f6de48e00d2c61d25d7f0)),
+  closes [#458](https://code.castopod.org/adaures/castopod/issues/458)
+  [#459](https://code.castopod.org/adaures/castopod/issues/459)
+
+## [1.10.5](https://code.castopod.org/adaures/castopod/compare/v1.10.4...v1.10.5) (3/12/2024)
+
+### Bug Fixes
+
+- **file-uploads:** validate chapters json content + remove permit_empty rule to
+  uploaded files
+  ([6289c42](https://code.castopod.org/adaures/castopod/commit/6289c42b1189f074c7e4e4cd9fbfd73bf26625c9)),
+  closes [#445](https://code.castopod.org/adaures/castopod/issues/445)
+
+## [1.10.4](https://code.castopod.org/adaures/castopod/compare/v1.10.3...v1.10.4) (2/26/2024)
+
+### Bug Fixes
+
+- display chapters in episode preview page
+  ([797516a](https://code.castopod.org/adaures/castopod/commit/797516a2ec7d88704412a5cca50421e8eef38eec)),
+  closes [#445](https://code.castopod.org/adaures/castopod/issues/445)
+
+## [1.10.3](https://code.castopod.org/adaures/castopod/compare/v1.10.2...v1.10.3) (2/21/2024)
+
+### Bug Fixes
+
+- **chapters:** use episode cover when chapter img is an empty string
+  ([a343de4](https://code.castopod.org/adaures/castopod/commit/a343de4cf6ba38561b8fe675fa9c38d9f0ecfec7)),
+  closes [#444](https://code.castopod.org/adaures/castopod/issues/444)
+- **import:** set episodes as premium if podcast is set as premium by default
+  ([dfd66be](https://code.castopod.org/adaures/castopod/commit/dfd66beebfcca1670b0a9d389e8e3f8d2d08d2f2))
+
+## [1.10.2](https://code.castopod.org/adaures/castopod/compare/v1.10.1...v1.10.2) (2/20/2024)
+
+### Bug Fixes
+
+- **podcast-import:** move closing parenthasis when checking for owner name and
+  email existence
+  ([cec7815](https://code.castopod.org/adaures/castopod/commit/cec78155f94a222edcf7964c0a2f3a3e0f46a98d))
+
+## [1.10.1](https://code.castopod.org/adaures/castopod/compare/v1.10.0...v1.10.1) (2/20/2024)
+
+### Bug Fixes
+
+- **fediverse:** use config name to get Fediverse config properties instead of
+  hardcoded class string
+  ([5fd0980](https://code.castopod.org/adaures/castopod/commit/5fd0980ff7101d45051a2daa3f635694f85609d7))
+
+# [1.10.0](https://code.castopod.org/adaures/castopod/compare/v1.9.0...v1.10.0) (2/19/2024)
+
+### Bug Fixes
+
+- **op3:** move op3 prefix to enclosure url instead of audio proxy
+  ([d580369](https://code.castopod.org/adaures/castopod/commit/d5803692357952d82d54efd8d3aa71de3a1c9571))
+- **podcast-import:** rollback transaction before exception is thrown
+  ([419bb04](https://code.castopod.org/adaures/castopod/commit/419bb04716088586b87b2c8f24a954ca8cfd6c76)),
+  closes [#429](https://code.castopod.org/adaures/castopod/issues/429)
+  [#319](https://code.castopod.org/adaures/castopod/issues/319)
+  [#443](https://code.castopod.org/adaures/castopod/issues/443)
+  [#438](https://code.castopod.org/adaures/castopod/issues/438)
+
+### Features
+
+- add podcast:season and podcast:episode tags to rss feed
+  ([98c6658](https://code.castopod.org/adaures/castopod/commit/98c6658840eedd55bd6d8042f8a69c342b87cd71))
+- add support for podcasting 2.0 "medium" tag with podcast, music and audiobook
+  ([630e788](https://code.castopod.org/adaures/castopod/commit/630e788f0e1ddfe5de229bd415a8e15361efa746)),
+  closes [#439](https://code.castopod.org/adaures/castopod/issues/439)
+- display chapters in episode's public page
+  ([87cc437](https://code.castopod.org/adaures/castopod/commit/87cc437e1ead5486ed46ca37e2055aaf5c9445c1)),
+  closes [#423](https://code.castopod.org/adaures/castopod/issues/423)
+- support VTT transcript file format in addition to SRT
+  ([7071b4b](https://code.castopod.org/adaures/castopod/commit/7071b4b6f48cb9a2f766064f3a5c23f92b293718)),
+  closes [#433](https://code.castopod.org/adaures/castopod/issues/433)
+
+# [1.9.0](https://code.castopod.org/adaures/castopod/compare/v1.8.2...v1.9.0) (1/31/2024)
+
+### Bug Fixes
+
+- **i18n:** escape language strings in form fields to prevent them from
+  disappearing
+  ([3cb5ffd](https://code.castopod.org/adaures/castopod/commit/3cb5ffd25b9604a83cd12935e641dab7c88fba47)),
+  closes [#412](https://code.castopod.org/adaures/castopod/issues/412)
+- **podcast-about:** update stats query to discard scheduled episodes from
+  episodes number
+  ([67c037c](https://code.castopod.org/adaures/castopod/commit/67c037c9eb1e15c6945eaf74ec0ff30b33f4b704))
+- **premium-subs:** clear subscription list cache after insert
+  ([2accb0f](https://code.castopod.org/adaures/castopod/commit/2accb0f7652330b29c3adb85a2e1b0d5d83f1389)),
+  closes [#430](https://code.castopod.org/adaures/castopod/issues/430)
+- **s3:** remove proxy, set objects acl to public-read, and serve files using
+  their public urls
+  ([6a77a9d](https://code.castopod.org/adaures/castopod/commit/6a77a9d2f29c849775a3d1bcbd819f73f21d9aa6))
+
+### Features
+
+- add actor domain to handle in follow page
+  ([de099ac](https://code.castopod.org/adaures/castopod/commit/de099ac64300b8edb86e387fde89c0a3e9472f46))
+- **admin:** add podcast's OP3 analytics dashboard link
+  ([5f3752b](https://code.castopod.org/adaures/castopod/commit/5f3752b4430f6f2d5f9e5f6a7a003bc4d2f9d487))
+
 ## [1.8.2](https://code.castopod.org/adaures/castopod/compare/v1.8.1...v1.8.2) (1/17/2024)
 
 ### Bug Fixes

docs/src/contributing/setup-development.md → CONTRIBUTING-DEV.md

----
-title: Development setup
-sidebarDepth: 3
----
-
 # Setup your development environment
 
 ## Introduction
@@ -10,7 +5,7 @@ sidebarDepth: 3
 Castopod is a web app based on the `php` framework
 [CodeIgniter 4](https://codeigniter.com).
 
-We use [Docker](https://www.docker.com/) quickly setup a dev environment. A
+We use [Docker](https://www.docker.com/) to quickly setup a dev environment. A
 `docker-compose.yml` and `Dockerfile` are included in the project's root folder
 to help you kickstart your contribution.
 
@@ -21,9 +16,9 @@ to help you kickstart your contribution.
 
 ### 1. Pre-requisites
 
-0. Install [docker](https://docs.docker.com/get-docker).
+0. Install [Docker](https://docs.docker.com/get-docker).
 
-1. Clone Castopod project by running:
+1. Clone the Castopod repository by running:
 
    ```bash
    git clone https://code.castopod.org/adaures/castopod.git
@@ -34,7 +29,7 @@ to help you kickstart your contribution.
 
    ```ini
    CI_ENVIRONMENT="development"
-   # If set to development, you must run `npm run dev` to start the static assets server
+   # If set to development, you must run `pnpm run dev` to start the static assets server
    vite.environment="development"
 
    # By default, this is set to true in the app config.
@@ -56,7 +51,7 @@ to help you kickstart your contribution.
    analytics.salt="DEV_ANALYTICS_SALT"
 
    cache.handler="redis"
-   cache.redis.host = "redis"
+   cache.redis.host="redis"
 
    # You may not want to use redis as your cache handler
    # Comment/remove the two lines above and uncomment
@@ -78,15 +73,16 @@ to help you kickstart your contribution.
    #media.s3.pathStyleEndpoint=true
    ```
 
-   > _NB._ You can tweak your environment by setting more environment variables
-   > in your custom `.env` file. See the `env` for examples or the
+   > [!NOTE]  
+   > You can tweak your environment by setting more environment variables in
+   > your custom `.env` file. See the `env` for examples or the
    > [CodeIgniter4 User Guide](https://codeigniter.com/user_guide/index.html)
    > for more info.
 
-3. (for docker desktop) Add the repository you've cloned to docker desktop's
+3. (for Docker desktop) Add the repository you've cloned to Docker desktop's
    `Settings` > `Resources` > `File Sharing`
 
-### 2. (recommended) Develop inside the app Container with VSCode
+### 2. (recommended) Develop inside the app container with VSCode
 
 If you're working in VSCode, you can take advantage of the `.devcontainer/`
 folder. It defines a development environment (dev container) with preinstalled
@@ -100,16 +96,16 @@ required services will be loaded automagically! 🪄
    > The VSCode window will reload inside the dev container. Expect several
    > minutes during first load as it is building all necessary services.
 
-   **Note**: The dev container will start by running Castopod's php server.
+   **Note**: The dev container will start by running Castopod's PHP server.
    During development, you will have to start [Vite](https://vitejs.dev)'s dev
    server for compiling the typescript code and styles:
 
    ```bash
    # run Vite dev server
-   npm run dev
+   pnpm run dev
    ```
 
-   If there is any issue with the php server not running, you can restart them
+   If there is any issue with the PHP server not running, you can restart them
    using the following commands:
 
    ```bash
@@ -129,15 +125,15 @@ required services will be loaded automagically! 🪄
    # Composer is installed
    composer -V
 
-   # npm is installed
-   npm -v
+   # pnpm is installed
+   pnpm -v
 
    # git is installed
    git version
    ```
 
 For more info, see
-[VSCode Remote Containers](https://code.visualstudio.com/docs/remote/containers)
+[Developing inside a Container](https://code.visualstudio.com/docs/devcontainers/containers)
 
 ### 3. Start hacking
 
@@ -148,7 +144,12 @@ more insights.
 
 To see your changes, go to:
 
-- `http://localhost:8080/` for the Castopod app
+- `http://localhost:8080/` for the Castopod website
+- `http://localhost:8080/cp-admin` for the Castopod admin:
+
+  - email: **admin@castopod.local**
+  - password: **castopod**
+
 - `http://localhost:8888/` for the phpmyadmin interface:
 
   - username: **castopod**
@@ -158,9 +159,9 @@ To see your changes, go to:
 
 You do not wish to use the VSCode devcontainer? No problem!
 
-1. Start docker containers manually:
+1. Start the Docker containers manually:
 
-   Go to project's root folder and run:
+   Go to the project's root folder and run:
 
    ```bash
    # starts all services declared in docker-compose.yml file
@@ -175,7 +176,7 @@ You do not wish to use the VSCode devcontainer? No problem!
 
    ```
 
-   > The `docker-compose up -d` command will boot 4 containers in the
+   > The `docker-compose up -d` command will boot 5 containers in the
    > background:
    >
    > - `castopod_app`: a php based container with Castopod requirements
@@ -186,6 +187,7 @@ You do not wish to use the VSCode devcontainer? No problem!
    >   persistent data
    > - `castopod_phpmyadmin`: a phpmyadmin server to visualize the mariadb
    >   database.
+   > - `castopod_s3`: a mock s3 server to work on the s3 fileManager
 
 2. Run any command inside the containers by prefixing them with
    `docker-compose run --rm app`:
@@ -197,8 +199,8 @@ You do not wish to use the VSCode devcontainer? No problem!
    # use Composer
    docker-compose run --rm app composer -V
 
-   # use npm
-   docker-compose run --rm app npm -v
+   # use pnpm
+   docker-compose run --rm app pnpm -v
 
    # use git
    docker-compose run --rm app git version
@@ -216,57 +218,46 @@ You do not wish to use the VSCode devcontainer? No problem!
    composer install
    ```
 
-   ::: info Note
-
-   The php dependencies aren't included in the repository. Composer will check
-   the `composer.json` and `composer.lock` files to download the packages with
-   the right versions. The dependencies will live under the `vendor/` folder.
-   For more info, check out the
-   [Composer documentation](https://getcomposer.org/doc/).
+   > [!NOTE]  
+   > The php dependencies aren't included in the repository. Composer will check
+   > the `composer.json` and `composer.lock` files to download the packages with
+   > the right versions. The dependencies will live under the `vendor/` folder.
+   > For more info, check out the
+   > [Composer documentation](https://getcomposer.org/doc/).
 
-   :::
-
-2. Install javascript dependencies with [npm](https://www.npmjs.com/)
+2. Install JavaScript dependencies with [pnpm](https://pnpm.io/)
 
    ```bash
-   npm install
+   pnpm install
    ```
 
-   ::: info Note
-
-   The javascript dependencies aren't included in the repository. Npm will check
-   the `package.json` and `package.lock` files to download the packages with the
-   right versions. The dependencies will live under the `node_module` folder.
-   For more info, check out the [NPM documentation](https://docs.npmjs.com/).
-
-   :::
+   > [!NOTE]  
+   > The JavaScript dependencies aren't included in the repository. Pnpm will
+   > check the `package.json` and `pnpm-lock.yaml` files to download the
+   > packages with the right versions. The dependencies will live under the
+   > `node_module` folder. For more info, check out the
+   > [PNPM documentation](https://pnpm.io/motivation).
 
 3. Generate static assets:
 
    ```bash
    # build all static assets at once
-   npm run build:static
+   pnpm run build:static
 
    # build specific assets
-   npm run build:icons
-   npm run build:svg
+   pnpm run build:icons
+   pnpm run build:svg
    ```
 
-   ::: info Note
-
-   The static assets generated live under the `public/assets` folder, it
-   includes javascript, styles, images, fonts, icons and svg files.
-
-   :::
+   > [!NOTE]  
+   > The static assets generated live under the `public/assets` folder, it
+   > includes JavaScript, styles, images, fonts, icons and svg files.
 
 ### Initialize and populate database
 
-::: tip Tip
-
-You may skip this section if you go through the install wizard (go to
-`/cp-install`).
-
-:::
+> [!TIP]  
+> You may skip this section if you go through the install wizard (go to
+> `/cp-install`).
 
 1. Build the database with the migrate command:
 
@@ -286,7 +277,7 @@ You may skip this section if you go through the install wizard (go to
 
    ```bash
    # Populates all required data
-   php spark db:seed AppSeeder
+   php spark db:seed DevSeeder
    ```
 
    You may choose to add data separately:
@@ -298,20 +289,11 @@ You may skip this section if you go through the install wizard (go to
    # Populates all Languages
    php spark db:seed LanguageSeeder
 
-   # Populates all podcasts platforms
-   php spark db:seed PlatformSeeder
-
-   # Populates all Authentication data (roles definition…)
-   php spark db:seed AuthSeeder
+   # Adds a superadmin with [admin@castopod.local / castopod] credentials
+   php spark db:seed DevSuperadminSeeder
    ```
 
-3. (optionnal) Populate the database with test data:
-
-   - Populate test data (login: admin / password: AGUehL3P)
-
-   ```bash
-   php spark db:seed TestSeeder
-   ```
+3. (optional) Populate the database with test data:
 
    - Populate with fake podcast analytics:
 
@@ -325,11 +307,6 @@ You may skip this section if you go through the install wizard (go to
    php spark db:seed FakeWebsiteAnalyticsSeeder
    ```
 
-   TestSeeder will add an active superadmin user with the following credentials:
-
-   - username: **admin**
-   - password: **AGUehL3P**
-
 ### Useful docker / docker-compose commands
 
 - Monitor the app container:
@@ -338,13 +315,13 @@ You may skip this section if you go through the install wizard (go to
 docker-compose logs --tail 50 --follow --timestamps app
 ```
 
-- Interact with redis server using included redis-cli command:
+- Interact with the Redis server using included redis-cli command:
 
 ```bash
 docker exec -it castopod_redis redis-cli
 ```
 
-- Monitor the redis container:
+- Monitor the Redis container:
 
 ```bash
 docker-compose logs --tail 50 --follow --timestamps redis
@@ -380,28 +357,52 @@ docker-compose down
 docker-compose build app
 ```
 
-Check [docker](https://docs.docker.com/engine/reference/commandline/docker/) and
+Check [Docker](https://docs.docker.com/engine/reference/commandline/docker/) and
 [docker-compose](https://docs.docker.com/compose/reference/) documentations for
 more insights.
 
+### Updating Documentation
+
+Castopod's documentation is written in Markdown and uses the Astro Starlight
+framework. To update Castopod's documentation, including the Getting Started
+guide and User Guide:
+
+1. Change directories to the `docs` directory and install the dependencies:
+
+   ```bash
+   cd docs/
+   pnpm i
+   ```
+
+2. Start the documentation development server:
+
+   ```bash
+   pnpm run dev --host
+   ```
+
+3. The documentation development server runs on port 4321. In your browser visit
+   `http://localhost:4321/docs`. If the page displays a 404 Not Found error,
+   click on the Castopod logo in the upper left hand corner of the page and the
+   documentation should load.
+
+4. Edit the Markdown files with your documentation updates. The Astro Starlight
+   development server will automatically update each time you save a change.
+
 ## Known issues
 
 ### Allocation failed - JavaScript heap out of memory
 
-This happens when running `npm install`.
+This happens when running `pnpm install`.
 
 👉 By default, docker might not have access to enough RAM. Allocate more memory
-and run `npm install` again.
+and run `pnpm install` again.
 
 ### (Linux) Files created inside container are attributed to root locally
 
 You may use Linux user namespaces to fix this on your machine:
 
-::: info Note
-
-Replace "username" with your local username
-
-:::
+> [!NOTE]  
+> Replace "username" with your local username
 
 1. Go to `/etc/docker/daemon.json` and add:
 
@@ -425,7 +426,7 @@ Replace "username" with your local username
    username:100000:65536
    ```
 
-3. Restart docker:
+3. Restart Docker:
 
    ```bash
    sudo systemctl restart docker

CONTRIBUTING.md

-# Contributing guidelines
+# Contributing to Castopod
 
-You may find the contributing guidelines in the
-[Castopod documentation website](https://docs.castopod.org/contributing/guidelines.html).
+Love Castopod and want to help? Thanks so much, there's something to do for
+everybody!
+
+> [!NOTE]  
+> Castopod follows the [all contributors](https://allcontributors.org/)
+> specification in an effort to **recognize any kind of contribution**, not just
+> code!  
+> If you've made a contribution and do not appear in the
+> [contributors](../index.md#contributors-✨) list, please
+> [let us know](../index.md#contact) so we can correct our mistake! 🙂
+
+Please take a moment to review this document in order to make the contribution
+process easy and effective for everyone involved.
+
+Following these guidelines helps to communicate that you respect the time of the
+developers managing and developing this open source project. In return, they
+should reciprocate that respect in addressing your issue or assessing patches
+and features.
+
+## Translating Castopod
+
+We use [Crowdin](https://translate.castopod.org/) to manage translation files
+for [Castopod](https://code.castopod.org/), the
+[documentation](https://docs.castopod.org/) and the
+[landing](https://castopod.org/) websites.
+
+Whether you'd like to correct a translation error, validate new translations or
+include your language to Castopod, head into the
+[crowdin project](https://translate.castopod.org/) to get started.
+
+> [!NOTE]  
+> To prevent degrading user experience, new languages are included to Castopod
+> when they reach a certain threshold (~90%).
+
+## Using the issue tracker
+
+The [issue tracker](https://code.castopod.org/adaures/castopod/-/issues) is the
+preferred channel for [bug reports](#bug-reports),
+[features requests](#feature-requests) and
+[submitting pull requests](#pull-requests).
+
+## ⚠️ Security issues and vulnerabilities
+
+If you encounter any security issue or vulnerability in the Castopod source,
+please contact us directly by email at
+[security@castopod.org](mailto:security@castopod.org)
+
+## Bug reports
+
+A bug is a _demonstrable problem_ that is caused by the code in the repository.
+Good bug reports are extremely helpful - thank you!
+
+Guidelines for bug reports:
+
+1. **Use the issue search** — check if the issue has already been
+   reported.
+
+2. **Check if the issue has been fixed** — try to reproduce it using the
+   latest `main` branch in the repository.
+
+3. **Isolate the problem** — ideally create a
+   [reduced test case](https://css-tricks.com/reduced-test-cases/) and a live
+   example.
+
+A good bug report shouldn't leave others needing to chase you up for more
+information. Please try to be as detailed as possible in your report. What is
+your environment? What steps will reproduce the issue? What browser(s) and OS
+experience the problem? What would you expect to be the outcome? All these
+details will help people to fix any potential bugs.
+
+> [!NOTE]  
+> [Issue templates](https://docs.gitlab.com/ee/user/project/description_templates.html#using-the-templates) have
+> been created for this project. You may use them to help you follow those
+> guidelines.
+
+## Feature requests
+
+Feature requests are welcome. But take a moment to find out whether your idea
+fits with the scope and aims of the project. It's up to _you_ to make a strong
+case to convince the project's developers of the merits of this feature. Please
+provide as much detail and context as possible.
+
+## Pull requests
+
+Good pull requests - patches, improvements, new features - are a fantastic help.
+They should remain focused in scope and avoid containing unrelated commits.
+
+**Please ask first** before embarking on any significant pull request (e.g.
+implementing features, refactoring code, porting to a different language),
+otherwise you risk spending a lot of time working on something that the
+project's developers might not want to merge into the project.
+
+Please adhere to the coding conventions used throughout a project (indentation,
+accurate comments, etc.) and any other requirements (such as test coverage).
+
+Adhering to the following process is the best way to get your work included in
+the project:
+
+1. [Fork](https://docs.gitlab.com/ee/user/project/repository/forking_workflow.html)
+   the project, clone your fork, and configure the remotes:
+
+   ```bash
+   # Clone your fork of the repo into the current directory
+   git clone https://code.castopod.org/<your-username>/castopod.git
+
+   # Navigate to the newly cloned directory
+   cd castopod
+
+   # Assign the original repo to a remote called "upstream"
+   git remote add upstream https://code.castopod.org/adaures/castopod.git
+   ```
+
+2. If you cloned a while ago, get the latest changes from upstream:
+
+   ```bash
+   git checkout main
+   git pull upstream main
+   ```
+
+3. Create a new topic branch (off the `main` branch) to contain your feature,
+   change, or fix:
+
+   ```bash
+   git checkout -b <topic-branch-name>
+   ```
+
+4. Commit your changes in logical chunks. Please adhere to these
+   [git commit message guidelines](https://conventionalcommits.org/) or your
+   code is unlikely be merged into the main project. Use Git's
+   [interactive rebase](https://help.github.com/articles/about-git-rebase/)
+   feature to tidy up your commits before making them public.
+
+5. Locally merge (or rebase) the upstream dev branch into your topic branch:
+
+   ```bash
+   git pull [--rebase] upstream main
+   ```
+
+6. Push your topic branch up to your fork:
+
+   ```bash
+   git push origin <topic-branch-name>
+   ```
+
+7. [Open a Pull Request](https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html#new-merge-request-from-a-fork)
+   with a clear title and description.
+
+> [!IMPORTANT]  
+> By submitting a patch, you agree to allow the project owners to license your
+> work under the terms of the
+> [GNU AGPLv3](https://code.castopod.org/adaures/castopod/-/blob/develop/LICENSE.md).
+
+## Collaborating guidelines
+
+There are few basic rules to ensure high quality of the project:
+
+- Before merging, a PR requires at least two approvals from the collaborators
+  unless it's an architectural change, a large feature, etc. If it is, then at
+  least 50% of the core team have to agree to merge it, with every team member
+  having a full veto right. (i.e. every single one can block any PR)
+- A PR should remain open for at least two days before merging (does not apply
+  for trivial contributions like fixing a typo). This way everyone has enough
+  time to look into it.
+
+You are always welcome to discuss and propose improvements to this guideline.