chore(release): update versions (#303)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

.changeset/config.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "changelog": [
+    "@changesets/changelog-github",
+    { "repo": "papra-hq/papra"} 
+  ],
+  "commit": false,
+  "fixed": [
+    ["@papra/app-client", "@papra/app-server"]
+  ],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": [],
+  "privatePackages": {
+    "tag": true,
+    "version": true
+  }
+}

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: 💬 Discord Community
+    url: https://papra.app/discord
+    about: Join the Papra Discord community to get help, share your feedback, and stay updated on the project.

.github/workflows/ci-apps-papra-client.yaml

@@ -38,11 +38,12 @@ jobs:
       - name: Run unit test
         run: pnpm test
 
-      - name: Build the app
-        run: pnpm build
-
-      # Ensure locales types are up to date
+      # Ensure locales types are up to date, must be run before building the app
       - name: Check locales types
         run: |
           pnpm script:generate-i18n-types
-          git diff --exit-code -- src/modules/i18n/locales.types.ts > /dev/null || (echo "Locales types are outdated, please run 'pnpm script:generate-i18n-types' and commit the changes." && exit 1)
+          git diff --exit-code -- src/modules/i18n/locales.types.ts > /dev/null || (echo "Locales types are outdated, please run 'pnpm script:generate-i18n-types' and commit the changes." && exit 1)
+
+      - name: Build the app
+        run: pnpm build
+

.github/workflows/ci-apps-papra-server.yaml

@@ -26,7 +26,9 @@ jobs:
           cache: 'pnpm'
 
       - name: Install dependencies
-        run: pnpm i --frozen-lockfile
+        run: |
+          pnpm i --frozen-lockfile
+          pnpm --filter "@papra/app-server^..." build
 
       - name: Run linters
         run: pnpm lint

.github/workflows/ci-packages-api-sdk.yaml

@@ -0,0 +1,41 @@
+name: CI - Api SDK
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  ci-packages-api-sdk:
+    name: CI - Api SDK
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: packages/api-sdk
+
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm i
+
+      - name: Run linters
+        run: pnpm lint
+
+      - name: Type check
+        run: pnpm typecheck
+
+      # - name: Run unit test
+      #   run: pnpm test
+
+      - name: Build the app
+        run: pnpm build

.github/workflows/ci-packages-cli.yaml

@@ -0,0 +1,44 @@
+name: CI - CLI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  ci-packages-cli:
+    name: CI - CLI
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: packages/cli
+
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm i
+
+      - name: Build related packages
+        run: cd ../api-sdk && pnpm build
+
+      - name: Run linters
+        run: pnpm lint
+
+      - name: Type check
+        run: pnpm typecheck
+
+      # - name: Run unit test
+      #   run: pnpm test
+
+      - name: Build the app
+        run: pnpm build

.github/workflows/ci-packages-webhook.yaml

@@ -0,0 +1,41 @@
+name: CI - Webhooks
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  ci-packages-webhooks:
+    name: CI - Webhooks
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: packages/webhooks
+
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm i
+
+      - name: Run linters
+        run: pnpm lint
+
+      - name: Type check
+        run: pnpm typecheck
+
+      - name: Run unit test
+        run: pnpm test
+
+      - name: Build the app
+        run: pnpm build

.github/workflows/release-docker.yaml

@@ -1,9 +1,12 @@
 name: Release new versions
 
 on:
-  push:
-    tags:
-      - 'v*.*.*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to release'
+        required: true
+        type: string
 
 permissions:
   contents: read
@@ -14,14 +17,6 @@ jobs:
     name: Release Docker images
     runs-on: ubuntu-latest
     steps:
-      - name: Get release version from tag
-        if: ${{ github.event_name == 'push' }}
-        run: echo "RELEASE_VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_ENV
-    
-      - name: Get release version from input
-        if: ${{ github.event_name == 'workflow_dispatch' }}
-        run: echo "RELEASE_VERSION=${{ github.event.inputs.release_version }}" >> $GITHUB_ENV
-
       - name: Checkout
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
 
@@ -53,9 +48,9 @@ jobs:
           push: true
           tags: |
             corentinth/papra:latest-root
-            corentinth/papra:${{ env.RELEASE_VERSION }}-root
+            corentinth/papra:${{ inputs.version }}-root
             ghcr.io/papra-hq/papra:latest-root
-            ghcr.io/papra-hq/papra:${{ env.RELEASE_VERSION }}-root
+            ghcr.io/papra-hq/papra:${{ inputs.version }}-root
 
       - name: Build and push rootless Docker image
         uses: docker/build-push-action@v6
@@ -67,7 +62,7 @@ jobs:
           tags: |
             corentinth/papra:latest
             corentinth/papra:latest-rootless
-            corentinth/papra:${{ env.RELEASE_VERSION }}-rootless
+            corentinth/papra:${{ inputs.version }}-rootless
             ghcr.io/papra-hq/papra:latest
             ghcr.io/papra-hq/papra:latest-rootless
-            ghcr.io/papra-hq/papra:${{ env.RELEASE_VERSION }}-rootless
+            ghcr.io/papra-hq/papra:${{ inputs.version }}-rootless

.github/workflows/release.yml

@@ -0,0 +1,53 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      id-token: write
+      actions: write
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm i
+
+      - name: Create Release Pull Request
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          # Note: pnpm install after versioning is necessary to refresh lockfile
+          version: pnpm run version
+          publish: pnpm exec changeset publish
+          commit: "chore(release): update versions"
+          title: "chore(release): update versions"
+        env:
+          GITHUB_TOKEN: ${{ secrets.CHANGESET_GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Trigger Docker build
+        if: steps.changesets.outputs.published == 'true' && contains(fromJson(steps.changesets.outputs.publishedPackages).*.name, '@papra/app-server')
+        run: |
+          VERSION=$(echo '${{ steps.changesets.outputs.publishedPackages }}' | jq -r '.[] | select(.name=="@papra/app-server") | .version')
+          echo "VERSION: $VERSION"
+          gh workflow run release-docker.yaml -f version="$VERSION"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -37,5 +37,6 @@ cache
 *.sqlite
 
 local-documents
+ingestion
 .cursorrules
 *.traineddata

CODEOWNERS

@@ -0,0 +1 @@
+* @papra-hq/papra-maintainers

CONTRIBUTING.md

@@ -22,11 +22,11 @@ We follow a **GitHub Flow** model where all PRs should target the `main` branch,
 
 - Each PR should be small and atomic. Please avoid solving multiple unrelated issues in a single PR.
 - Ensure that the **CI is green** before submitting. Some of the following checks are automatically run for each package: linting, type checking, testing, and building.
-- PRs without a corresponding issue are welcome.
 - If your PR fixes an issue, please reference the issue number in the PR description.
 - If your PR adds a new feature, please include tests and update the documentation if necessary.
 - Be prepared to address feedback and iterate on your PR.
 - Resolving merge conflicts is part of the PR author's responsibility.
+- Draft PRs are welcome to get feedback early on your work but only when requested, they'll not be reviewed.
 
 ### Branching
 
@@ -60,7 +60,7 @@ pnpm script:generate-i18n-types
 ```
 
 - This command will update the file [`locales.types.ts`](./apps/papra-client/src/modules/i18n/locale.types.ts) with the new/removed keys.
-- Will developing you can use `pnpm script:generate-i18n-types:watch` to automatically update the types when you touch the  [`en.yml`](./apps/papra-client/src/locales/en.yml) file.
+- When developing in papra-client (using `pnpm dev`), the i18n types definition will automatically update when you touch the  [`en.yml`](./apps/papra-client/src/locales/en.yml) file, so no need to run the command above.
 
 ## Development Setup
 

README.md

@@ -22,17 +22,14 @@
   <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
   <a href="https://github.com/orgs/papra-hq/projects/2">Roadmap</a>
   <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
-  <a href="https://discord.gg/8UPjzsrBNF">Discord</a>
+  <a href="https://papra.app/discord">Discord</a>
   <!-- <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
   <a href="https://dashboard.papra.app">Managed instance</a> -->
 </p>
 
 ## Introduction
 
-> [!IMPORTANT]  
-> **Papra** is currently in active development and is not yet ready for production use or self-hosting.
-
-**Papra** is a minimalistic document management and archiving platform. It is designed to be simple to use and accessible to everyone. Papra is a plateform for long-term document storage and management, like a digital archive for your documents.
+**Papra** is a minimalistic document management and archiving platform. It is designed to be simple to use and accessible to everyone. Papra is a platform for long-term document storage and management, like a digital archive for your documents.
 
 Forget about that receipt of that gift you bought for your friend last year, or that warranty for your new phone. With Papra, you can easily store, forget, and retrieve your documents whenever you need them.
 
@@ -40,6 +37,15 @@ A live demo of the platform is available at [demo.papra.app](https://demo.papra.
 
 [![Papra](./.github/papra-screenshot.png)](https://demo.papra.app)
 
+## Project Status
+
+Papra is currently in **beta**. The core functionality is stable and usable, but you may encounter occasional bugs or limitations. The project is actively developed, with new features being added regularly.
+
+- ✅ Core document management features are stable
+- ✅ Self-hosting is fully supported
+- 🚧 Some advanced features are still in development
+- 📝 Feedback and bug reports are highly appreciated
+
 ## Features
 
 - **Document management**: Upload, store, and manage your documents in one place.
@@ -53,15 +59,28 @@ A live demo of the platform is available at [demo.papra.app](https://demo.papra.
 - **Tags**: Organize your documents with tags.
 - **Email ingestion**: Send/forward emails to a generated address to automatically import documents.
 - **Content extraction**: Automatically extract text from images or scanned documents for search.
-- **i18n**: Support for multiple languages.
-- *Coming soon:* **Tagging Rules**: Automatically tag documents based on custom rules.
-- *Coming soon:* **Folder ingestion**: Automatically import documents from a folder.
-- *Coming soon:* **SDK and API**: Build your own applications on top of Papra.
-- *Coming soon:* **CLI**: Manage your documents from the command line.
+- **Tagging Rules**: Automatically tag documents based on custom rules.
+- **Folder ingestion**: Automatically import documents from a folder.
+- **CLI**: Manage your documents from the command line.
+- **API, SDK and webhooks**: Build your own applications on top of Papra.
+- *In progress:* **i18n**: Support for multiple languages.
 - *Coming soon:* **Document sharing**: Share documents with others.
+- *Coming soon:* **Document requests**: Generate upload links for people to add documents.
 - *Coming maybe one day:* **Mobile app**: Access and upload documents on the go.
 - *Coming maybe one day:* **Desktop app**: Access and upload documents from your computer.
 
+## Self-hosting
+
+Papra is dedicated to providing a simple yet highly configurable self-hosting experience. Our lightweight Docker image (<200MB) is compatible with multiple architectures including x86, ARM64, and ARMv7.
+
+For a quick start, simply run the following command:
+
+```bash
+docker run -d --name papra -p 1221:1221 ghcr.io/papra-hq/papra:latest
+```
+
+Please refer to the [self-hosting documentation](https://docs.papra.app/self-hosting/using-docker) for more information and configuration options.
+
 ## Contributing
 
 Contributions are welcome! Please refer to the [`CONTRIBUTING.md`](./CONTRIBUTING.md) file for guidelines on how to get started, report issues, and submit pull requests.
@@ -73,7 +92,7 @@ This project is licensed under the AGPL-3.0 License - see the [LICENSE](./LICENS
 
 ## Community
 
-Join the community on [Papra's Discord server](https://discord.gg/8UPjzsrBNF) to discuss the project, ask questions, or get help.
+Join the community on [Papra's Discord server](https://papra.app/discord) to discuss the project, ask questions, or get help.
 
 ## Credits
 

apps/docs/CHANGELOG.md

@@ -0,0 +1,15 @@
+# @papra/docs
+
+## 0.4.0
+
+### Minor Changes
+
+- [#295](https://github.com/papra-hq/papra/pull/295) [`438a311`](https://github.com/papra-hq/papra/commit/438a31171c606138c4b7fa299fdd58dcbeaaf298) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Added support for custom oauth2 providers
+
+- [#293](https://github.com/papra-hq/papra/pull/293) [`53bf93f`](https://github.com/papra-hq/papra/commit/53bf93f128b54ad1d3553e18680c87ab23155f8d) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Added a papra docker-compose.yml generator
+
+## 0.3.1
+
+### Patch Changes
+
+- [#280](https://github.com/papra-hq/papra/pull/280) [`85fa5c4`](https://github.com/papra-hq/papra/commit/85fa5c43424d139f5c2752a3ad644082e61d3d67) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Fix broken lint and added auto link check

apps/docs/astro.config.ts

@@ -1,8 +1,11 @@
 import { env } from 'node:process';
 import starlight from '@astrojs/starlight';
 import { defineConfig } from 'astro/config';
+import starlightLinksValidator from 'starlight-links-validator';
 import starlightThemeRapide from 'starlight-theme-rapide';
+import UnoCSS from 'unocss/astro';
 import { sidebar } from './src/content/navigation';
+
 import posthogRawScript from './src/scripts/posthog.script.js?raw';
 
 const posthogApiKey = env.POSTHOG_API_KEY;
@@ -15,18 +18,22 @@ const posthogScript = posthogRawScript.replace('[POSTHOG-API-KEY]', posthogApiKe
 export default defineConfig({
   site: 'https://docs.papra.app',
   integrations: [
+    UnoCSS(),
     starlight({
-      plugins: [starlightThemeRapide()],
+      plugins: [starlightThemeRapide(), starlightLinksValidator({ exclude: ['http://localhost:1221'] })],
       title: 'Papra Docs',
       logo: {
         dark: './src/assets/logo-dark.svg',
         light: './src/assets/logo-light.svg',
         alt: 'Papra Logo',
       },
-      social: {
-        github: 'https://github.com/papra-hq/papra',
-        blueSky: 'https://bsky.app/profile/papra.app',
-        discord: 'https://discord.gg/8UPjzsrBNF',
+      social: [
+        { href: 'https://github.com/papra-hq/papra', icon: 'github', label: 'GitHub' },
+        { href: 'https://bsky.app/profile/papra.app', icon: 'blueSky', label: 'BlueSky' },
+        { href: 'https://papra.app/discord', icon: 'discord', label: 'Discord' },
+      ],
+      expressiveCode: {
+        themes: ['vitesse-black', 'vitesse-light'],
       },
       editLink: {
         baseUrl: 'https://github.com/papra-hq/papra/edit/main/apps/docs/',
@@ -34,7 +41,7 @@ export default defineConfig({
       sidebar,
       favicon: '/favicon.svg',
       head: [
-        // Add ICO favicon fallback for Safari.
+      // Add ICO favicon fallback for Safari.
         {
           tag: 'link',
           attrs: {

apps/docs/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@papra/docs",
   "type": "module",
-  "version": "0.1.1",
-  "packageManager": "pnpm@9.15.4",
+  "version": "0.4.0",
+  "private": true,
+  "packageManager": "pnpm@10.9.0",
   "description": "Papra documentation website",
   "author": "Corentin Thomasset <corentinth@proton.me> (https://corentin.tech)",
   "license": "AGPL-3.0-or-later",
@@ -17,10 +18,17 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@astrojs/starlight": "^0.31.0",
-    "astro": "^5.1.5",
+    "@astrojs/solid-js": "^5.1.0",
+    "@astrojs/starlight": "^0.34.3",
+    "astro": "^5.8.0",
     "sharp": "^0.32.5",
-    "starlight-theme-rapide": "^0.3.0"
+    "shiki": "^3.4.2",
+    "starlight-links-validator": "^0.16.0",
+    "starlight-theme-rapide": "^0.5.0",
+    "tailwind-merge": "^2.6.0",
+    "unocss-preset-animations": "^1.2.1",
+    "yaml": "^2.8.0",
+    "zod-to-json-schema": "^3.24.5"
   },
   "devDependencies": {
     "@antfu/eslint-config": "^3.13.0",
@@ -29,9 +37,10 @@
     "@unocss/reset": "^0.64.0",
     "eslint": "^9.17.0",
     "eslint-plugin-astro": "^1.3.1",
-    "figue": "^2.2.0",
+    "figue": "^2.2.2",
     "lodash-es": "^4.17.21",
     "marked": "^15.0.6",
-    "typescript": "^5.7.3"
+    "typescript": "^5.7.3",
+    "unocss": "0.65.0-beta.2"
   }
 }

apps/docs/src/assets/app.css

@@ -1,7 +1,44 @@
 :root[data-theme='dark'] {
-    --background-color: #050505!important;
+    --background: 240 4% 10%;
+    --foreground: 0 0% 98%;
+  
+    --card: 240 4% 8%;
+    --card-foreground: 0 0% 98%;
+  
+    --popover: 240 4% 8%;
+    --popover-foreground: 0 0% 98%;
+  
+    --primary: 77 100% 74%;
+    --primary-foreground: 0 0% 9%;
+  
+    --secondary: 0 0% 14.9%;
+    --secondary-foreground: 0 0% 98%;
+  
+    --muted: 0 0% 14.9%;
+    --muted-foreground: 0 0% 63.9%;
+  
+    --accent: 0 0% 14.9%;
+    --accent-foreground: 0 0% 98%;
+  
+    --destructive: 0 62.8% 30.6%;
+    --destructive-foreground: 0 0% 98%;
+  
+    --warning: 31 98% 50%;
+    --warning-foreground: 0 0% 98%;
+  
+    --border: 345 4% 17%;
+    --input: 0 0% 89.8%;
+    --ring: 0 0% 3.9%;
+  
+    --radius: 0.5rem;
+
+
+    --background-color: #0c0d0f!important;
     --accent-color: #fff!important;
-    --foreground-color: #f6f6f6!important;
+    --foreground-color: #9ea3a2!important;
+    --sl-color-white: #f3f7f6!important;
+
+    --surface: #0a0b0d!important;
 
     --sl-color-text: var(--foreground-color)!important;
 
@@ -13,6 +50,33 @@
     --sl-color-bg-sidebar: var(--background-color)!important;
 }
 
+.sl-link-card {
+    background-color: var(--surface)!important;
+}
+
+.hero .sl-link-button {
+    background-color: var(--sl-color-text)!important;
+    border-color: transparent!important;
+    color: var(--sl-color-bg)!important;
+    border-radius: 0.8rem!important;
+    transition: opacity 0.2s ease-in-out!important;
+    font-weight: 500!important;
+}
+
+:root[data-theme='dark'] .hero .sl-link-button {
+    background-color: var(--accent-color)!important;
+    color: var(--background-color)!important;
+}
+
+.hero .sl-link-button:hover {
+    opacity: 0.8!important;
+}
+
+#_top {
+    padding-top: 10px!important;
+    padding-bottom: 30px!important;
+}
+
 .site-title {
     color:inherit !important;
     gap: 0.5rem !important;
@@ -25,4 +89,8 @@
 
 .site-title img {
     width: 1.8rem !important;
-} 
+} 
+
+pre.shiki {
+    border-radius: 0.5rem!important;
+}

apps/docs/src/config.data.ts

@@ -52,4 +52,34 @@ ${documentation}
 
 `.trim()).join('\n\n---\n\n');
 
-export { mdSections };
+function wrapText(text: string, maxLength = 75) {
+  const words = text.split(' ');
+  const lines: string[] = [];
+  let currentLine = '';
+
+  words.forEach((word) => {
+    if ((currentLine + word).length + 1 <= maxLength) {
+      currentLine += (currentLine ? ' ' : '') + word;
+    } else {
+      lines.push(currentLine);
+      currentLine = word;
+    }
+  });
+
+  if (currentLine) {
+    lines.push(currentLine);
+  }
+
+  return lines.map(line => `# ${line}`);
+}
+
+const fullDotEnv = rows.map(({ env, defaultValue, documentation }) => {
+  const isEmptyDefaultValue = isNil(defaultValue) || (isArray(defaultValue) && isEmpty(defaultValue)) || defaultValue === '';
+
+  return [
+    ...wrapText(documentation),
+    `# ${env}=${isEmptyDefaultValue ? '' : defaultValue}`,
+  ].join('\n');
+}).join('\n\n');
+
+export { fullDotEnv, mdSections };

apps/docs/src/content/docs/02-self-hosting/01-using-docker.md

@@ -1,61 +0,0 @@
----
-title: Installing Papra using Docker
-description: Self-host Papra using Docker.
-slug: self-hosting/using-docker
----
-
-Papra can be easily installed and run using Docker. This method is recommended for users who want a quick and straightforward way to deploy their own instance of Papra with minimal setup.
-
-- Single lightweight image
-- Only one container to manage
-- Available for all platforms (arm64, arm/v7, x86_64)
-- Root and Rootless image variants
-
-## Prerequisites
-
-Before you begin, ensure that you have Docker installed on your system. You can download and install Docker from the official [Docker website](https://www.docker.com/get-started).
-
-Verify your installation:
-
-```bash frame="none"
-docker --version
-```
-
-## Installation
-
-You can run Papra using the following command:
-
-```bash frame="none"
-docker run -d --name papra --restart unless-stopped -p 1221:1221 ghcr.io/papra-hq/papra
-```
-
-It will automatically download the latest image and start the container. The application will be available at [http://localhost:1221](http://localhost:1221).
-
-## Root and Rootless installation
-
-Papra can be installed in two different ways:
-
-- **Rootless** (recommended): This method does not require root privileges to run. The images are suffixed with `-rootless` like `corentinth/papra:latest-rootless` or `corentinth/papra:1.0.0-rootless` and the default `:latest` tag points to the latest rootless image.
-- **Root**: This is the default installation method. It requires root privileges to run. The images are suffixed with `-root` like `corentinth/papra:latest-root` or `corentinth/papra:1.0.0-root`.
-
-## Image Sources
-
-Papra Docker images are available on both **Docker Hub** and **GitHub Container Registry** (GHCR). You can choose the source that best suits your needs.
-
-```bash frame="none"
-# Using Docker Hub
-docker pull corentinth/papra:latest
-docker pull corentinth/papra:latest-rootless
-docker pull corentinth/papra:latest-root
-
-# Using GitHub Container Registry
-docker pull ghcr.io/papra-hq/papra:latest
-docker pull ghcr.io/papra-hq/papra:latest-rootless
-docker pull ghcr.io/papra-hq/papra:latest-root
-```
-
-## Basic Usage
-
-```bash frame="none"
-docker run -d --name papra --restart unless-stopped -p 1221:1221 ghcr.io/papra-hq/papra:latest-root
-```

apps/docs/src/content/docs/02-self-hosting/01-using-docker.mdx

@@ -0,0 +1,111 @@
+---
+title: Installing Papra using Docker
+description: Self-host Papra using Docker.
+slug: self-hosting/using-docker
+---
+import { Steps } from '@astrojs/starlight/components';
+
+Papra provides optimized Docker images for streamlined deployment. This method is recommended for users seeking a production-ready setup with minimal maintenance overhead.
+
+- **Simplified management**: Single container handles all components
+- **Lightweight**: Optimized image sizes across architectures
+- **Cross-platform support**: Compatible with `arm64`, `arm/v7`, and `x86_64` systems
+- **Security options**: Supports both rootless (recommended) and rootful configurations
+
+## Prerequisites
+
+Ensure Docker is installed on your host system. Official installation guides are available at:
+[docker.com/get-started](https://www.docker.com/get-started)
+
+Verify Docker installation with:
+
+```bash
+docker --version
+```
+
+## Quick Deployment
+
+Launch Papra with default configuration using:
+
+```bash
+docker run -d \
+  --name papra \
+  --restart unless-stopped \
+  -p 1221:1221 \
+  ghcr.io/papra-hq/papra:latest
+```
+
+This command will:
+1. Pull the latest rootless image from GitHub Container Registry
+2. Expose the web interface on [http://localhost:1221](http://localhost:1221)
+3. Configure automatic restarts for service continuity
+
+## Image Variants
+
+Choose between two security models based on your requirements:
+
+- **Rootless**: Tagged as `latest`, `latest-rootless` or `<version>-rootless` (like `0.2.1-rootless`). Recommended for most users.
+- **Root**: Tagged as `latest-root` or `<version>-root` (like `0.2.1-root`). Only use if you need to run Papra as the root user.
+
+The `:latest` tag always references the latest rootless build.
+
+## Persistent Data Configuration
+
+For production deployments, mount host directories to preserve application data between container updates.
+
+<Steps>
+
+1. Create Storage Directories
+
+    Create a directory for Papra data `./papra-data`, with `./papra-data/db` and `./papra-data/documents` subdirectories:
+
+    ```bash
+    mkdir -p ./papra-data/{db,documents}
+    ```
+
+2. Launch Container with Volume Binding
+
+    ```bash
+    docker run -d \
+      --name papra \
+      --restart unless-stopped \
+      -p 1221:1221 \
+      -v $(pwd)/papra-data:/app/app-data \
+      --user $(id -u):$(id -g) \
+      ghcr.io/papra-hq/papra:latest
+    ```
+
+    This configuration:
+    - Maintains data integrity across container lifecycle events
+    - Enforces proper file ownership without manual permission adjustments
+    - Stores both database files and document assets persistently
+
+</Steps>
+
+## Image Registries
+
+Papra images are distributed through multiple channels:
+
+**Primary Source (GHCR):**
+```bash
+docker pull ghcr.io/papra-hq/papra:latest
+docker pull ghcr.io/papra-hq/papra:latest-rootless
+docker pull ghcr.io/papra-hq/papra:latest-root
+```
+
+**Community Mirror (Docker Hub):**
+```bash
+docker pull corentinth/papra:latest
+docker pull corentinth/papra:latest-rootless
+docker pull corentinth/papra:latest-root
+```
+
+## Updating Papra
+
+Regularly pull updated images and recreate containers to receive security patches and feature updates.
+
+```bash
+docker pull ghcr.io/papra-hq/papra:latest
+# Or
+docker pull corentinth/papra:latest
+```

apps/docs/src/content/docs/02-self-hosting/02-using-docker-compose.mdx

@@ -5,18 +5,35 @@ slug: self-hosting/using-docker-compose
 
 import { Steps } from '@astrojs/starlight/components';
 
-Docker Compose makes it easy to deploy Papra on your server or local machine. Follow these simple steps to get your instance up and running quickly.
+This guide covers how to deploy Papra using Docker Compose, ideal for users who prefer declarative configurations or plan to integrate Papra into a broader service stack.
+
+Using Docker Compose provides:
+- A single, versioned configuration file
+- Easy integration with volumes, networks, and service dependencies
+- Simplified updates and re-deployments
+
+This method supports both `rootless` and `rootful` Papra images, please refer to the [Docker](/self-hosting/using-docker) guide for more information about the difference between the two. The following example uses the recommended `rootless` setup.
+
+## Prerequisites
+
+Ensure Docker and Docker Compose are installed on your host system. Official installation guides are available at: [docker.com/get-started](https://www.docker.com/get-started)
+
+Verify Docker installation with:
+
+```bash
+docker --version
+docker compose version
+```
+
 
 <Steps>
 
-1. Prepare your environment
+1. Initialize Project Structure
 
-    Make sure you have [Docker](https://www.docker.com/get-started) and [Docker Compose](https://docs.docker.com/compose/install/) installed on your system.
+    Create working directory and persistent storage subdirectories:
 
-    Verify your installation:
-
-    ```bash frame="none"
-    docker --version
+    ```bash
+    mkdir -p papra/app-data/{db,documents} && cd papra
     ```
 
 2. Create Docker Compose file
@@ -26,16 +43,14 @@ Docker Compose makes it easy to deploy Papra on your server or local machine. Fo
     ```yaml
     services:
       papra:
-        image: corentinth/papra:latest-rootless
-        ports:
-          - '1221:1221'
-        volumes:
-          - papra-data:/app/app-data
+        container_name: papra
+        image: ghcr.io/papra-hq/papra:latest
         restart: unless-stopped
-
-    volumes:
-      papra-data:
-        driver: local
+        ports:
+          - "1221:1221"
+        volumes:
+          - ./app-data:/app/app-data
+        user: "${UID}:${GID}"
     ```
 
 3. Start Papra
@@ -43,10 +58,10 @@ Docker Compose makes it easy to deploy Papra on your server or local machine. Fo
     From the directory containing your `docker-compose.yml` file, run:
 
     ```bash
-    docker compose up -d
+    UID=$(id -u) GID=$(id -g) docker compose up -d
     ```
 
-    This command downloads the latest Papra image, sets up the container, and starts the Papra service.
+    This command downloads the latest Papra image, sets up the container, and starts the Papra service. The `UID` and `GID` variables are used to set the user and group for the container, ensuring proper file ownership. If you don't want to use the `UID` and `GID` variables, you can replace the image with the rootful variant.
 
 4. Access Papra
 

apps/docs/src/content/docs/02-self-hosting/03-configuration.mdx

@@ -4,15 +4,85 @@ slug: self-hosting/configuration
 
 ---
 
-import { mdSections } from '../../../config.data.ts';
+import { mdSections, fullDotEnv } from '../../../config.data.ts';
 import { marked } from 'marked';
+import { Tabs, TabItem } from '@astrojs/starlight/components';
+import { Aside } from '@astrojs/starlight/components';
+import { Code } from '@astrojs/starlight/components';
 
 Configuring your self hosted Papra allows you to customize the application to better suit your environment and requirements. This guide covers the key environment variables you can set to control various aspects of the application, including port settings, security options, and storage configurations.
 
+## Configuration files
+
+You can configure Papra using standard environment variables or use some configuration files.
+Papra uses [c12](https://github.com/unjs/c12) to load configuration files and [figue](https://github.com/CorentinTh/figue) to validate and merge environment variables and configuration files.
+
+The [c12](https://github.com/unjs/c12) allows you to use the file format you want. The configuration file should be named `papra.config.[ext]` and should be located in the root of the project or in `/app/app-data/` directory in docker container (it can be changed using `PAPRA_CONFIG_DIR` environment variable).
+
+The supported formats are: `json`, `jsonc`, `json5`, `yaml`, `yml`, `toml`, `js`, `ts`, `cjs`, `mjs`.
+
+Example of configuration files:
+<Tabs>
+  <TabItem label="papra.config.yaml">
+    ```yaml
+    server:
+      baseUrl: https://papra.example.com
+      corsOrigins: *
+
+    client:
+      baseUrl: https://papra.example.com
+
+    auth:
+      secret: your-secret-key
+      isRegistrationEnabled: true
+    # ...
+    ```
+  </TabItem>
+
+  <TabItem label="papra.config.json">
+    ```json
+    {
+      "$schema": "https://docs.papra.com/papra-config-schema.json",
+      "server": {
+        "baseUrl": "https://papra.example.com"
+      },
+      "client": {
+        "baseUrl": "https://papra.example.com"
+      },
+      "auth": {
+        "secret": "your-secret-key",
+        "isRegistrationEnabled": true
+      }
+    }
+    ```
+
+    <Aside type="tip">
+      When using an IDE, you can use the [papra-config-schema.json](/papra-config-schema.json) file to get autocompletion for the configuration file. Just add a `$schema` property to your configuration file and point it to the schema file.
+
+      ```json
+      {
+        "$schema": "https://docs.papra.com/papra-config-schema.json",
+        // ...
+      }
+      ```
+      
+    </Aside>
+
+  </TabItem>
+</Tabs>
+
+
+You'll find the complete list of configuration variables with their environment variables equivalents and path for files in the next section.
+
+## Complete .env
+
+Here is the full configuration file that you can use to configure Papra. The variables values are the default values.
+
+<Code code={fullDotEnv} language="env" title=".env" />
+
 ## Configuration variables
 
 Here is the complete list of configuration variables that you can use to configure Papra. You can set these variables in the `.env` file or pass them as environment variables when running the Docker container.
 
 <Fragment set:html={marked.parse(mdSections)} />
 
-Coming soon.

apps/docs/src/content/docs/03-guides/01-intake-emails-with-owlrelay.mdx

@@ -55,11 +55,12 @@ By integrating Papra with OwlRelay, your instance will generate email addresses
    # this is to authenticate that the emails are coming from OwlRelay
    INTAKE_EMAILS_WEBHOOK_SECRET=a-random-key
 
-   # Optional: This is the URL that OwlRelay will send the emails to,
+   # [Optional]
+   # This is the URL that OwlRelay will send the emails to,
    # if not provided, the webhook will be inferred from the server URL.
    # Can be relevant if you have multiple urls pointing to your Papra instance
    # or when using tunnel services
-   OWLRELAY_WEBHOOK_URL=https://your-instance.com/api/intake-emails/owlrelay
+   OWLRELAY_WEBHOOK_URL=https://your-instance.com/api/intake-emails/ingest
    ```
 
 4. **That's it!**

apps/docs/src/content/docs/03-guides/02-intake-emails-with-cf-email-worker.mdx

@@ -12,7 +12,7 @@ This guide will show you how to setup a Cloudflare Email worker to receive email
 <Aside type="note">
   Setting up a Papra Intake Emails with a Cloudflare Email worker requires bit of knowledge about how to setup a CF Email worker and how to configure your Papra instance to receive emails.
 
-  For a simpler solution, you can use the official [OwlRelay integration](/docs/guides/intake-emails-with-papra-email-intake) guide.
+  For a simpler solution, you can use the official [OwlRelay integration](/guides/intake-emails-with-owlrelay) guide.
 </Aside>
 
 ## Prerequisites
@@ -23,7 +23,7 @@ In order to follow this guide, you need:
 - a publicly accessible Papra instance
 - basic development skills (git and node.js to setup the Email Worker)
 
-If you prefer a simpler solution, you can use the official [OwlRelay integration](/docs/guides/intake-emails-with-papra-email-intake) guide.
+If you prefer a simpler solution, you can use the official [OwlRelay integration](/guides/intake-emails-with-owlrelay) guide.
 
 ## How it works
 

apps/docs/src/content/docs/03-guides/03-setup-ingestion-folder.mdx

@@ -0,0 +1,105 @@
+---
+title: Setup Ingestion Folder
+description: Step-by-step guide to setup an ingestion folder to automatically ingest documents into your Papra instance.
+slug: guides/setup-ingestion-folder
+---
+import { Steps } from '@astrojs/starlight/components';
+import { Aside } from '@astrojs/starlight/components';
+import { FileTree } from '@astrojs/starlight/components';
+
+The ingestion folder is a special folder that is watched by Papra for new files. When a new file is added to the ingestion folder, Papra will automatically import it.
+
+## Multi-Organization Structure
+
+Papra supports multiple organizations within a single instance, each requiring a dedicated ingestion folder. The ingestion system uses a hierarchical structure where:
+
+<FileTree>
+- ingestion-folder
+  - org_abc123
+    - document.pdf
+    - report.docx
+  - org_def456
+    - file.txt
+  - foo.txt # Ignored as it's not in an organization 
+</FileTree>
+
+
+This allows you to have a single instance of Papra watching multiple organizations' ingestion folders.
+
+<Aside>
+Files and folders that are within the `ingestion-root-folder` but not within an organization folder are ignored.
+</Aside>
+
+## Setup
+
+Add the following to your `docker-compose.yml` file:
+
+```yaml title="docker-compose.yml" ins={9,12}
+services:
+papra:
+   container_name: papra
+   image: ghcr.io/papra-hq/papra:latest
+   restart: unless-stopped
+   ports:
+      - "1221:1221"
+   environment:
+      - INGESTION_FOLDER_IS_ENABLED=true
+   volumes:
+      - ./app-data:/app/app-data
+      - <your-ingestion-folder>:/app/ingestion
+   user: "${UID}:${GID}"
+```
+
+Then add files to a folder named with the organization id (available in Papra URL, e.g. `https://papra.example.com/organizations/<organization-id>`, the format is `org_<random>`).
+
+```bash
+mkdir -p <your-ingestion-folder>/<org_id>
+touch <your-ingestion-folder>/<org_id>/hello.txt
+```
+
+## Post-processing
+
+Once a file has been ingested in your Papra organization, you can configure what happens to it by setting the `INGESTION_FOLDER_POST_PROCESSING_STRATEGY` environment variable. There are two strategies:
+
+- `delete`: The file is deleted from the ingestion folder (default strategy)
+- `move`: The file is moved to the `INGESTION_FOLDER_POST_PROCESSING_MOVE_FOLDER_PATH` folder (default: `./ingestion-done`)
+
+Note that the `INGESTION_FOLDER_POST_PROCESSING_MOVE_FOLDER_PATH` path is relative to the organization ingestion folder.
+
+So with `INGESTION_FOLDER_POST_PROCESSING_MOVE_FOLDER_PATH=ingestion-done`, the file `<ingestion-folder>/<org_id>/file.pdf` will be moved to `<ingestion-folder>/<org_id>/ingestion-done/file.pdf` once ingested.
+
+## Safeguards
+
+To avoid accidental data loss, if for some reason the ingestion fails, the file is moved to the `INGESTION_FOLDER_ERROR_FOLDER_PATH` folder (default: `./ingestion-error`).
+
+<Aside>
+As for the `INGESTION_FOLDER_POST_PROCESSING_MOVE_FOLDER_PATH`, the `INGESTION_FOLDER_ERROR_FOLDER_PATH` path is relative to the organization ingestion folder.
+</Aside>
+
+## Polling
+
+By default, Papra uses native file watchers to detect changes in the ingestion folder. On some OS (like Windows), this can be flaky with Docker. To avoid this issue, you can enable polling by setting the `INGESTION_FOLDER_WATCHER_USE_POLLING` environment variable to `true`.
+
+The default polling interval is 2 seconds, you can change it by setting the `INGESTION_FOLDER_WATCHER_POLLING_INTERVAL_MS` environment variable.
+
+
+```yaml title="docker-compose.yml" ins={2-3}
+environment:
+   - INGESTION_FOLDER_WATCHER_USE_POLLING=true
+   - INGESTION_FOLDER_WATCHER_POLLING_INTERVAL_MS=2000
+```
+
+## Configuration
+
+You can find the list of all configuration options in the [configuration reference](/self-hosting/configuration), the related variables are prefixed with `INGESTION_FOLDER_`.
+
+
+## Edge cases and behaviors
+
+- The ingestion folder is watched recursively.
+- Files in the ingestion folder `done` and `error` folders are ignored.
+- When a file from the ingestion folder is already present (and not in the trash) in the organization, no ingestion is done, but the file is post-processed (deleted or moved) as successfully ingested.
+- When a file is moved to "done" or "error" folder
+   - If a file with the same name and same content is present in the destination folder, the original file is deleted
+   - If a file with the same name but different content is present in the destination folder, the original file is moved and a timestamp is added to the filename
+- Some files are ignored by default (`.DS_Store`, `Thumbs.db`, `desktop.ini`, etc.) see [ingestion-folders.constants.ts](https://github.com/papra-hq/papra/blob/main/apps/papra-server/src/modules/ingestion-folders/ingestion-folders.constants.ts) for the list of ignored files and patterns. You can change this by setting the `INGESTION_FOLDER_IGNORED_PATTERNS` environment variable.

apps/docs/src/content/docs/03-guides/04-setup-custom-oauth2.mdx

@@ -0,0 +1,181 @@
+---
+title: Setup Custom OAuth2 Providers
+description: Step-by-step guide to setup custom OAuth2 providers for authentication in your Papra instance.
+slug: guides/setup-custom-oauth2-providers
+---
+
+import { Aside } from '@astrojs/starlight/components';
+import { Steps } from '@astrojs/starlight/components';
+
+This guide will show you how to configure custom OAuth2 providers for authentication in your Papra instance.
+
+<Aside type="note">
+  Papra's OAuth2 implementation is based on the [Better Auth Generic OAuth plugin](https://www.better-auth.com/docs/plugins/generic-oauth). For more detailed information about the configuration options and advanced usage, please refer to their documentation.
+</Aside>
+
+## Prerequisites
+
+In order to follow this guide, you need:
+- A custom OAuth2 provider
+- An accessible Papra instance
+- Basic understanding of OAuth2 flows
+
+## Configuration
+
+To set up custom OAuth2 providers, you'll need to configure the `AUTH_PROVIDERS_CUSTOMS` environment variable with an array of provider configurations. Here's an example:
+
+```bash
+AUTH_PROVIDERS_CUSTOMS='[
+  {
+    "providerId": "custom-oauth2",
+    "providerName": "Custom OAuth2",
+    "providerIconUrl": "https://api.iconify.design/tabler:login-2.svg",
+    "clientId": "your-client-id",
+    "clientSecret": "your-client-secret",
+    "type": "oidc",
+    "discoveryUrl": "https://your-provider.tld/.well-known/openid-configuration",
+    "scopes": ["openid", "profile", "email"]
+  }
+]'
+```
+
+Each provider configuration supports the following fields:
+
+- `providerId`: A unique identifier for the OAuth provider
+- `providerName`: The display name of the provider
+- `providerIconUrl`: URL of the icon to display (optional) you can use a base64 encoded image or an url to a remote image.
+- `clientId`: OAuth client ID
+- `clientSecret`: OAuth client secret
+- `type`: Type of OAuth flow ("oauth2" or "oidc")
+- `discoveryUrl`: URL to fetch OAuth 2.0 configuration (recommended for OIDC providers)
+- `authorizationUrl`: URL for the authorization endpoint (required for OAuth2 if not using discoveryUrl)
+- `tokenUrl`: URL for the token endpoint (required for OAuth2 if not using discoveryUrl)
+- `userInfoUrl`: URL for the user info endpoint (required for OAuth2 if not using discoveryUrl)
+- `scopes`: Array of OAuth scopes to request
+- `redirectURI`: Custom redirect URI (optional)
+- `responseType`: OAuth response type (defaults to "code")
+- `prompt`: Controls the authentication experience ("select_account", "consent", "login", "none")
+- `pkce`: Whether to use PKCE (Proof Key for Code Exchange)
+- `accessType`: Access type for the authorization request
+
+## Setup
+
+<Steps>
+
+1. **Configure your OAuth2 Provider**
+
+   First, you'll need to register your application with your OAuth2 provider. This typically involves:
+   - Creating a new application in your provider's dashboard
+   - Setting up the redirect URI (usually `https://<your-papra-instance>/api/auth/oauth2/callback/:providerId`)
+   - Obtaining the client ID and client secret
+   - Configuring the required scopes
+
+2. **Configure Papra**
+
+   Add the `AUTH_PROVIDERS_CUSTOMS` environment variable to your Papra instance. Here are some examples:
+
+   For OIDC providers:
+   ```json
+   [
+     {
+       "providerId": "custom-oauth2",
+       "providerName": "Custom OAuth2",
+       "providerIconUrl": "https://api.iconify.design/tabler:login-2.svg",
+       "clientId": "your-client-id",
+       "clientSecret": "your-client-secret",
+       "type": "oidc",
+       "discoveryUrl": "https://your-provider.tld/.well-known/openid-configuration",
+       "scopes": ["openid", "profile", "email"]
+     }
+   ]
+   ```
+
+   For standard OAuth2 providers:
+   ```json
+   [
+     {
+       "providerId": "custom-oauth2",
+       "providerName": "Custom OAuth2",
+       "providerIconUrl": "https://api.iconify.design/tabler:login-2.svg",
+       "clientId": "your-client-id",
+       "clientSecret": "your-client-secret",
+       "type": "oauth2",
+       "authorizationUrl": "https://your-provider.tld/oauth2/authorize",
+       "tokenUrl": "https://your-provider.tld/oauth2/token",
+       "userInfoUrl": "https://your-provider.tld/oauth2/userinfo",
+       "scopes": ["profile", "email"]
+     }
+   ]
+   ```
+
+   <Aside type="note">
+     The `discoveryUrl` is recommended for OIDC providers as it automatically configures all the necessary endpoints.
+     For standard OAuth2 providers, you'll need to specify the endpoints manually.
+   </Aside>
+
+3. **Test the Configuration**
+
+   - Restart your Papra instance to apply the changes
+   - Go to the login page
+   - You should see your custom OAuth2 providers as login options
+   - Try logging in with a test account
+
+</Steps>
+
+## Troubleshooting
+
+### Providers Not Showing Up
+
+If your OAuth2 providers are not showing up on the login page:
+- Check that the JSON configuration in `AUTH_PROVIDERS_CUSTOMS` is valid
+- Ensure all required fields are provided
+- Verify that the provider IDs are unique
+
+### Authentication Fails
+
+If authentication fails:
+- Verify that the redirect URI is correctly configured in your OAuth2 provider
+- Check that the client ID and client secret are correct
+- Ensure the required scopes are properly configured
+- Check the Papra logs for any error messages
+
+### OIDC Discovery Issues
+
+If you're using OIDC and experiencing issues:
+- Verify that the `discoveryUrl` is accessible
+- Check that the provider supports OIDC discovery
+- Ensure the provider's configuration is properly exposed through the discovery endpoint
+
+## Security Considerations
+
+<Aside type="caution">
+  Always use HTTPS for your OAuth2 endpoints and ensure your client secret is kept secure.
+  Consider using PKCE (Proof Key for Code Exchange) for additional security by setting `pkce: true` in your configuration.
+</Aside>
+
+## Multiple Providers
+
+You can configure multiple custom OAuth2 providers by adding them to the array:
+
+```json
+[
+  {
+    "providerId": "custom-oauth2-1",
+    "providerName": "Custom OAuth2 Provider 1",
+    "type": "oidc",
+    "discoveryUrl": "https://provider1.tld/.well-known/openid-configuration",
+    "clientId": "client-id-1",
+    "clientSecret": "client-secret-1",
+    "scopes": ["openid", "profile", "email"]
+  },
+  {
+    "providerId": "custom-oauth2-2",
+    "providerName": "Custom OAuth2 Provider 2",
+    "type": "oidc",
+    "discoveryUrl": "https://provider2.tld/.well-known/openid-configuration",
+    "clientId": "client-id-2",
+    "clientSecret": "client-secret-2",
+    "scopes": ["openid", "profile", "email"]
+  }
+]
+```

apps/docs/src/content/docs/04-resources/01-cli.mdx

@@ -0,0 +1,89 @@
+---
+title: CLI Documentation
+description: Learn how to use the Papra CLI to interact with your Papra instance from the command line.
+slug: resources/cli
+---
+
+The Papra CLI is a command-line interface tool that helps you interact with the Papra platform from your terminal.
+
+## Installation
+
+For the moment, the CLI is only available as an NPM package.
+
+```bash
+# using pnpm
+pnpm i -g @papra/cli
+
+# or using npm
+npm i -g @papra/cli
+
+# or using yarn
+yarn add -g @papra/cli
+```
+
+The CLI will be installed globally, so you can use it from anywhere in your system with the `papra` command.
+
+## Configuration
+
+Before using the CLI, you need to configure it with your API credentials.
+
+### Initial Setup
+
+To initialize the configuration, run:
+
+```bash
+papra config init
+```
+
+This command will prompt you for:
+- **Instance URL**: Your Papra instance URL (e.g., `https://api.papra.app`)
+- **API Key**: Your personal API key (can be created in your User Settings)
+
+### Managing Configuration
+
+You can manage your configuration using the following commands:
+
+- `papra config list`: View your current configuration
+- `papra config set api-key`: Set or update your API key
+- `papra config set api-url`: Set or update your instance URL
+- `papra config set default-org-id`: Set a default organization ID
+
+### Organization IDs
+
+Since Papra supports multiple organizations, you may need to specify the organization ID when importing documents for example. If want, you can set a default organization ID in your configuration.
+
+```bash
+papra config set default-org-id <organization-id>
+papra documents import <file-path>
+
+# or 
+papra documents import -o <organization-id> <file-path>
+```
+
+## Available Commands
+
+### Importing documents
+
+The `import` command allows you to import a document into your Papra organization.
+
+```bash
+papra documents import -o <organization-id> <file-path>
+```
+
+## Getting Help
+
+For more information about any command, you can use the `--help` flag:
+
+```bash
+papra --help
+papra config --help
+papra documents --help
+```
+
+
+## About the CLI
+
+The CLI is built using the [citty](https://github.com/unjs/citty) framework and the [Papra TS SDK](https://github.com/papra-hq/papra/tree/main/packages/api-sdk).
+
+
+

apps/docs/src/content/docs/index.mdx

@@ -1,6 +1,19 @@
 ---
 title: Papra documentation
 description: Papra documentation.
+hero:
+  title: Papra Docs
+  tagline: Documentation for Papra, the minimalistic document archiving platform.
+  image:
+    alt: A glittering, brightly colored logo
+    dark: ../../assets/logo-dark.svg
+    light: ../../assets/logo-light.svg
+  actions:
+    - text: Self-hosting guide
+      link: /self-hosting/using-docker
+      icon: right-arrow
+      variant: primary
+
 ---
 
 import { LinkCard } from '@astrojs/starlight/components';
@@ -38,12 +51,13 @@ In today's digital world, managing countless important documents efficiently and
 - **Tags**: Organize your documents with tags.
 - **Email ingestion**: Send/forward emails to a generated address to automatically import documents.
 - **Content extraction**: Automatically extract text from images or scanned documents for search.
-- **i18n**: Support for multiple languages.
-- *Coming soon:* **Tagging Rules**: Automatically tag documents based on custom rules.
-- *Coming soon:* **Folder ingestion**: Automatically import documents from a folder.
-- *Coming soon:* **SDK and API**: Build your own applications on top of Papra.
-- *Coming soon:* **CLI**: Manage your documents from the command line.
+- **Tagging Rules**: Automatically tag documents based on custom rules.
+- **Folder ingestion**: Automatically import documents from a folder.
+- **API, SDK and webhooks**: Build your own applications on top of Papra.
+- **CLI**: Manage your documents from the command line.
+- *In progress:* **i18n**: Support for multiple languages.
 - *Coming soon:* **Document sharing**: Share documents with others.
+- *Coming soon:* **Document requests**: Generate upload links for people to add documents.
 
 ## Community & Open Source
 

apps/docs/src/content/navigation.ts

@@ -12,6 +12,7 @@ export const sidebar: StarlightUserConfig['sidebar'] = [
     items: [
       { label: 'Using Docker', slug: 'self-hosting/using-docker' },
       { label: 'Using Docker Compose', slug: 'self-hosting/using-docker-compose' },
+      { label: 'Docker Compose Generator', link: '/docker-compose-generator', badge: { text: 'new', variant: 'note' } },
       { label: 'Configuration', slug: 'self-hosting/configuration' },
     ],
   },
@@ -26,11 +27,23 @@ export const sidebar: StarlightUserConfig['sidebar'] = [
         label: 'Setup intake emails with CF Email Workers',
         slug: 'guides/intake-emails-with-cloudflare-email-workers',
       },
+      {
+        label: 'Setup Ingestion Folder',
+        slug: 'guides/setup-ingestion-folder',
+      },
+      {
+        label: 'Setup Custom OAuth2 Providers',
+        slug: 'guides/setup-custom-oauth2-providers',
+      },
     ],
   },
   {
     label: 'Resources',
     items: [
+      {
+        label: 'CLI Documentation',
+        slug: 'resources/cli',
+      },
       {
         label: 'Security Policy',
         link: 'https://github.com/papra-hq/papra/blob/main/SECURITY.md',

apps/docs/src/docker-compose-generator/dc-generator.astro

@@ -0,0 +1,363 @@
+---
+import { codeToHtml } from 'shiki';
+
+const images = {
+  GitHub: 'ghcr.io/papra-hq/papra',
+  DockerHub: 'corentinth/papra',
+};
+
+const defaultDockerCompose = `
+services:
+  papra:
+    image: ghcr.io/papra-hq/papra:latest
+    container_name: papra
+    restart: unless-stopped
+    ports:
+      - 1221:1221
+    environment:
+      - AUTH_SECRET=change-me
+    volumes:
+      - ./app-data:/app/app-data
+    user: 1000:1000
+`.trim();
+
+const dcHtml = await codeToHtml(defaultDockerCompose, { theme: 'vitesse-black', lang: 'yaml' });
+---
+
+<p>This tool will help you generate a custom docker-compose.yml file for Papra, tailored to your needs. You can personalize the service name, the port, the auth secret, and the source image.</p>
+
+<h2 class="mt-8 mb-2">General settings</h2>
+
+<div class="flex items-center gap-2 mt-1">
+  <label for="port" class="min-w-32">External port</label>
+  <input id="port" class="input-field" value="1221" type="number" min="1024" max="65535" placeholder="eg: 1221" />
+</div>
+
+<div class="flex items-center gap-2 mt-1">
+  <label for="source" class="min-w-32">Image source</label>
+  <select class="input-field mt-0" id="source">
+    {Object.entries(images).map(([registry, imageName]) => <option class="bg-background" value={imageName}>{`${registry} - ${imageName}`}</option>)}
+  </select>
+</div>
+
+<div class="flex items-center gap-2 mt-1">
+  <label for="service-name" class="min-w-32">Service Name</label>
+  <input id="service-name" class="input-field" value="papra" type="text" placeholder="eg: papra" />
+</div>
+
+<div class="flex items-center gap-2 mt-1">
+  <label
+    for="auth-secret"
+    class="min-w-32"
+  >
+  Auth secret
+  </label>
+  <div class="flex items-center gap-2 mt-0 w-full">
+    <input class="input-field font-mono" id="auth-secret" type="text" placeholder="eg: 1234567890" />
+    <button class="btn bg-muted" id="refresh-secret"> Refresh </button>
+  </div>
+</div>
+
+<div class="flex items-center gap-2 mt-1">
+  <label for="volume-path" class="min-w-32">Volume path</label>
+  <input id="volume-path" class="input-field" value="./app-data" type="text" placeholder="eg: ./app-data" />
+</div>
+
+<div class="flex items-center gap-2 mt-1">
+  <label for="privileged-mode" class="min-w-32">Privileged mode</label>
+  <div class="flex items-center gap-2 mt-0 w-full">
+    <select class="input-field mt-0" id="privileged-mode">
+      <option value="false" class="bg-background">Rootless</option>
+      <option value="true" class="bg-background">Root</option>
+    </select>
+  </div>
+</div>
+
+<h2 class="mt-8 mb-2">Ingestion folder</h2>
+
+<div class="flex items-center gap-2 mt-1">
+  <label for="ingestion-enabled" class="min-w-32">Enable ingestion</label>
+  <div class="flex items-center gap-2 mt-0 w-full">
+    <select class="input-field mt-0" id="ingestion-enabled">
+      <option value="false" class="bg-background">Disabled</option>
+      <option value="true" class="bg-background">Enabled</option>
+    </select>
+  </div>
+</div>
+
+<div class="flex items-center gap-2 mt-1" id="ingestion-path-container" style="display: none;">
+  <label for="ingestion-path" class="min-w-32">Ingestion path</label>
+  <input id="ingestion-path" class="input-field" value="./ingestion" type="text" placeholder="eg: ./ingestion" />
+</div>
+
+<h2 class="mt-8 mb-2">Intake emails</h2>
+<div class="flex items-center gap-2 mt-1">
+  <label for="intake-email-enabled" class="min-w-32">Enabled</label>
+  <div class="flex items-center gap-2 mt-0 w-full">
+    <select class="input-field mt-0" id="intake-email-enabled">
+      <option value="false" class="bg-background">Disabled</option>
+      <option value="true" class="bg-background">Enabled</option>
+    </select>
+  </div>
+</div>
+
+<div class="flex items-center gap-2 mt-1" id="intake-email-driver-container" style="display: none;">
+  <label for="intake-email-driver" class="min-w-32">Driver</label>
+  <div class="flex items-center gap-2 mt-0 w-full">
+    <select class="input-field mt-0" id="intake-email-driver">
+      <option value="owlrelay" class="bg-background">OwlRelay</option>
+      <option value="random-username" class="bg-background">Cloudflare Email Worker</option>
+    </select>
+  </div>
+</div>
+
+<div id="intake-email-owlrelay-config" style="display: none;" class="mt-1">
+  <div class="flex items-center gap-2 mt-1">
+    <label for="intake-email-owlrelay-api-key" class="min-w-32">API Key</label>
+    <input id="intake-email-owlrelay-api-key" class="input-field" type="text" placeholder="owrl_*****" />
+  </div>
+  <div class="flex items-center gap-2 mt-1">
+    <label for="intake-email-owlrelay-webhook-url" class="min-w-32">Webhook URL</label>
+    <input id="intake-email-owlrelay-webhook-url" class="input-field" type="text" placeholder="https://your-instance.com/api/intake-emails/ingest" />
+  </div>
+</div>
+
+<div id="intake-email-cf-worker-config" style="display: none;" class="mt-1">
+  <div class="flex items-center gap-2 mt-1">
+    <label for="intake-email-cf-email-domain" class="min-w-32">Email domain</label>
+    <input id="intake-email-cf-email-domain" class="input-field" type="text" placeholder="papra.email" />
+  </div>
+</div>
+
+<div class="flex items-center gap-2 mt-1" id="intake-email-webhook-secret-container" style="display: none;">
+  <label for="intake-email-webhook-secret" class="min-w-32">Webhook secret</label>
+  <div class="flex items-center gap-2 mt-0 w-full">
+    <input class="input-field font-mono" id="intake-email-webhook-secret" type="text" placeholder="a-random-key" />
+    <button class="btn bg-muted" id="refresh-webhook-secret">Refresh</button>
+  </div>
+</div>
+
+<div id="docker-compose-output" class="mt-12" set:html={dcHtml} />
+
+<div class="flex items-center gap-2 mt-4">
+  <button class="btn bg-muted mt-0" id="download-button">Download docker-compose.yml</button>
+  <button class="btn bg-muted mt-0" id="copy-button">Copy to clipboard</button>
+</div>
+
+
+<script>
+import { codeToHtml } from 'shiki';
+import { stringify } from 'yaml';
+
+const portInput = document.getElementById('port') as HTMLInputElement;
+const sourceSelect = document.getElementById('source') as HTMLSelectElement;
+const serviceNameInput = document.getElementById('service-name') as HTMLInputElement;
+const authSecretInput = document.getElementById('auth-secret') as HTMLInputElement;
+const refreshSecretButton = document.getElementById('refresh-secret');
+const copyButton = document.getElementById('copy-button');
+const dockerComposeOutput = document.getElementById('docker-compose-output');
+const downloadButton = document.getElementById('download-button');
+const volumePathInput = document.getElementById('volume-path') as HTMLInputElement;
+const privilegedModeSelect = document.getElementById('privileged-mode') as HTMLSelectElement;
+const ingestionEnabledSelect = document.getElementById('ingestion-enabled') as HTMLSelectElement;
+const ingestionPathInput = document.getElementById('ingestion-path') as HTMLInputElement;
+const ingestionPathContainer = document.getElementById('ingestion-path-container') as HTMLDivElement;
+const intakeEmailEnabledSelect = document.getElementById('intake-email-enabled') as HTMLSelectElement;
+const intakeDriverSelect = document.getElementById('intake-email-driver') as HTMLSelectElement;
+const owlrelayConfig = document.getElementById('intake-email-owlrelay-config') as HTMLDivElement;
+const cfWorkerConfig = document.getElementById('intake-email-cf-worker-config') as HTMLDivElement;
+const owlrelayApiKeyInput = document.getElementById('intake-email-owlrelay-api-key') as HTMLInputElement;
+const owlrelayWebhookUrlInput = document.getElementById('intake-email-owlrelay-webhook-url') as HTMLInputElement;
+const cfEmailDomainInput = document.getElementById('intake-email-cf-email-domain') as HTMLInputElement;
+const webhookSecretInput = document.getElementById('intake-email-webhook-secret') as HTMLInputElement;
+const refreshWebhookSecretButton = document.getElementById('refresh-webhook-secret');
+
+function getRandomString() {
+  const alphabet = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+  return Array.from({ length: 48 }, () => alphabet[Math.floor(Math.random() * alphabet.length)]).join('');
+}
+
+function copyToClipboard(text: string) {
+  navigator.clipboard.writeText(text);
+}
+
+function getDockerComposeYml() {
+  const serviceName = serviceNameInput.value;
+  const isRootless = privilegedModeSelect.value === 'false';
+  const image = sourceSelect.value;
+  const port = portInput.value;
+  const authSecret = authSecretInput.value;
+  const volumePath = volumePathInput.value;
+  const isIngestionEnabled = ingestionEnabledSelect.value === 'true';
+  const ingestionPath = ingestionPathInput.value;
+  const intakeEmailEnabled = intakeEmailEnabledSelect.value === 'true';
+  const intakeDriver = intakeDriverSelect.value;
+  const webhookSecret = webhookSecretInput.value;
+
+  const version = isRootless ? 'latest' : 'latest-root';
+  const fullImage = `${image}:${version}`;
+
+  const environment = [
+    `AUTH_SECRET=${authSecret}`,
+    isIngestionEnabled && 'INGESTION_FOLDER_IS_ENABLED=true',
+    intakeEmailEnabled && 'INTAKE_EMAILS_IS_ENABLED=true',
+    intakeEmailEnabled && `INTAKE_EMAILS_DRIVER=${intakeDriver}`,
+    intakeEmailEnabled && `INTAKE_EMAILS_WEBHOOK_SECRET=${webhookSecret}`,
+    intakeEmailEnabled && intakeDriver === 'owlrelay' && owlrelayApiKeyInput.value && `OWLRELAY_API_KEY=${owlrelayApiKeyInput.value}`,
+    intakeEmailEnabled && intakeDriver === 'owlrelay' && owlrelayWebhookUrlInput.value && `OWLRELAY_WEBHOOK_URL=${owlrelayWebhookUrlInput.value}`,
+    intakeEmailEnabled && intakeDriver === 'random-username' && cfEmailDomainInput.value && `INTAKE_EMAILS_EMAIL_GENERATION_DOMAIN=${cfEmailDomainInput.value}`,
+  ].flat().filter(Boolean);
+
+  const volumes = [
+    `${volumePath}:/app/app-data`,
+    isIngestionEnabled && `${ingestionPath}:/app/ingestion`,
+  ].filter(Boolean);
+
+  const dc = {
+    services: {
+      [serviceName]: {
+        image: fullImage,
+        container_name: serviceName,
+        restart: 'unless-stopped',
+        ports: [`${port}:1221`],
+        environment,
+        volumes,
+        ...(isRootless && {
+          user: '1000:1000',
+        }),
+      },
+    },
+  };
+
+  return stringify(dc);
+}
+
+async function updateDockerCompose() {
+  const dockerCompose = getDockerComposeYml();
+
+  const html = await codeToHtml(dockerCompose, { theme: 'vitesse-black', lang: 'yaml' });
+
+  if (dockerComposeOutput) {
+    dockerComposeOutput.innerHTML = html;
+  }
+}
+
+function handleCopy() {
+  const dockerCompose = getDockerComposeYml();
+
+  copyToClipboard(dockerCompose);
+
+  if (copyButton) {
+    copyButton.textContent = 'Copied!';
+  }
+
+  setTimeout(() => {
+    if (copyButton) {
+      copyButton.textContent = 'Copy to clipboard';
+    }
+  }, 1000);
+}
+
+function handleRefreshSecret() {
+  authSecretInput.value = getRandomString();
+  updateDockerCompose();
+}
+
+function handleDownload() {
+  const dockerCompose = getDockerComposeYml();
+
+  const blob = new Blob([dockerCompose], { type: 'text/yaml' });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement('a');
+  a.href = url;
+  a.download = 'docker-compose.yml';
+  a.click();
+}
+
+function handleIngestionEnabledChange() {
+  const isEnabled = ingestionEnabledSelect.value === 'true';
+  ingestionPathContainer.style.display = isEnabled ? 'flex' : 'none';
+  updateDockerCompose();
+}
+
+function handleIntakeEmailEnabledChange() {
+  const isEnabled = intakeEmailEnabledSelect.value === 'true';
+  const driverContainer = document.getElementById('intake-email-driver-container');
+  const webhookSecretContainer = document.getElementById('intake-email-webhook-secret-container');
+
+  if (driverContainer) {
+    driverContainer.style.display = isEnabled ? 'flex' : 'none';
+  }
+  if (webhookSecretContainer) {
+    webhookSecretContainer.style.display = isEnabled ? 'flex' : 'none';
+  }
+
+  if (!isEnabled) {
+    // Reset driver-specific configs when disabled
+    if (owlrelayConfig) {
+      owlrelayConfig.style.display = 'none';
+    }
+    if (cfWorkerConfig) {
+      cfWorkerConfig.style.display = 'none';
+    }
+  } else {
+    // Show the appropriate driver config
+    handleIntakeDriverChange();
+  }
+
+  updateDockerCompose();
+}
+
+function handleIntakeDriverChange() {
+  const driver = intakeDriverSelect.value;
+  const isEnabled = intakeEmailEnabledSelect.value === 'true';
+
+  if (!isEnabled) {
+    return;
+  }
+
+  if (owlrelayConfig) {
+    owlrelayConfig.style.display = driver === 'owlrelay' ? 'block' : 'none';
+  }
+  if (cfWorkerConfig) {
+    cfWorkerConfig.style.display = driver === 'random-username' ? 'block' : 'none';
+  }
+
+  updateDockerCompose();
+}
+
+function handleRefreshWebhookSecret() {
+  webhookSecretInput.value = getRandomString();
+  updateDockerCompose();
+}
+
+// Add event listeners
+portInput.addEventListener('input', updateDockerCompose);
+sourceSelect.addEventListener('change', updateDockerCompose);
+serviceNameInput.addEventListener('input', updateDockerCompose);
+authSecretInput.addEventListener('input', updateDockerCompose);
+refreshSecretButton?.addEventListener('click', handleRefreshSecret);
+copyButton?.addEventListener('click', handleCopy);
+downloadButton?.addEventListener('click', handleDownload);
+volumePathInput.addEventListener('input', updateDockerCompose);
+privilegedModeSelect.addEventListener('change', updateDockerCompose);
+ingestionEnabledSelect.addEventListener('change', handleIngestionEnabledChange);
+ingestionPathInput.addEventListener('input', updateDockerCompose);
+intakeEmailEnabledSelect.addEventListener('change', handleIntakeEmailEnabledChange);
+intakeDriverSelect.addEventListener('change', handleIntakeDriverChange);
+owlrelayApiKeyInput.addEventListener('input', updateDockerCompose);
+owlrelayWebhookUrlInput.addEventListener('input', updateDockerCompose);
+cfEmailDomainInput.addEventListener('input', updateDockerCompose);
+webhookSecretInput.addEventListener('input', updateDockerCompose);
+refreshWebhookSecretButton?.addEventListener('click', handleRefreshWebhookSecret);
+
+authSecretInput.value = getRandomString();
+
+// Initial render
+updateDockerCompose();
+
+// Initial setup
+handleIngestionEnabledChange();
+handleIntakeEmailEnabledChange();
+webhookSecretInput.value = getRandomString();
+</script>

apps/docs/src/pages/docker-compose-generator.astro

@@ -0,0 +1,15 @@
+---
+import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
+import DockerComposeGeneratorComp from '../docker-compose-generator/dc-generator.astro';
+---
+
+<StarlightPage
+  frontmatter={{
+        title: 'Papra docker-compose.yml generator',
+        description: 'Generate a custom docker-compose.yml file for Papra, tailored to your needs.',
+        tableOfContents: false,
+
+    }}
+>
+    <DockerComposeGeneratorComp />
+</StarlightPage>

apps/docs/src/pages/papra-config-schema.json.ts

@@ -0,0 +1,49 @@
+import type { APIRoute } from 'astro';
+import type { ConfigDefinition } from 'figue';
+import { z } from 'astro:content';
+import { mapValues } from 'lodash-es';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { configDefinition } from '../../../papra-server/src/modules/config/config';
+
+function buildConfigSchema({ configDefinition }: { configDefinition: ConfigDefinition }) {
+  const schema: any = mapValues(configDefinition, (config) => {
+    if (typeof config === 'object' && config !== null && 'schema' in config && 'doc' in config) {
+      return config.schema;
+    } else {
+      return buildConfigSchema({
+        configDefinition: config as ConfigDefinition,
+      });
+    }
+  });
+
+  return z.object(schema);
+}
+
+function stripRequired(schema: any) {
+  if (schema.type === 'object') {
+    schema.required = [];
+    for (const key in schema.properties) {
+      stripRequired(schema.properties[key]);
+    }
+  }
+}
+
+function addSchema(schema: any) {
+  schema.properties.$schema = {
+    type: 'string',
+    description: 'The schema of the configuration file, to be used by IDEs to provide autocompletion and validation',
+  };
+}
+
+function getConfigSchema() {
+  const schema = buildConfigSchema({ configDefinition });
+  const jsonSchema = zodToJsonSchema(schema, { pipeStrategy: 'output' });
+
+  stripRequired(jsonSchema);
+  addSchema(jsonSchema);
+  return jsonSchema;
+}
+
+export const GET: APIRoute = () => {
+  return new Response(JSON.stringify(getConfigSchema()));
+};

apps/docs/src/pages/robots.txt.ts

@@ -0,0 +1,15 @@
+import type { APIRoute } from 'astro';
+
+function getRobotsTxt(sitemapURL: URL) {
+  return `
+User-agent: *
+Allow: /
+
+Sitemap: ${sitemapURL.href}
+`.trim();
+}
+
+export const GET: APIRoute = ({ site }) => {
+  const sitemapURL = new URL('sitemap-index.xml', site);
+  return new Response(getRobotsTxt(sitemapURL));
+};

apps/docs/tsconfig.json

@@ -1,5 +1,10 @@
 {
   "extends": "astro/tsconfigs/strict",
-  "include": [".astro/types.d.ts", "**/*"],
-  "exclude": ["dist"]
+  "include": [
+    ".astro/types.d.ts",
+    "**/*"
+  ],
+  "exclude": [
+    "dist"
+  ]
 }

apps/docs/uno.config.ts

@@ -0,0 +1,97 @@
+import {
+  defineConfig,
+  presetUno,
+  transformerDirectives,
+  transformerVariantGroup,
+} from 'unocss';
+import presetAnimations from 'unocss-preset-animations';
+
+export default defineConfig({
+  presets: [
+    presetUno({
+      dark: {
+        dark: '[data-kb-theme="dark"]',
+        light: '[data-kb-theme="light"]',
+      },
+      prefix: '',
+    }),
+    presetAnimations(),
+  ],
+  transformers: [transformerVariantGroup(), transformerDirectives()],
+  theme: {
+    colors: {
+      border: 'hsl(var(--border))',
+      input: 'hsl(var(--input))',
+      ring: 'hsl(var(--ring))',
+      background: 'hsl(var(--background))',
+      foreground: 'hsl(var(--foreground))',
+      primary: {
+        DEFAULT: 'hsl(var(--primary))',
+        foreground: 'hsl(var(--primary-foreground))',
+      },
+      secondary: {
+        DEFAULT: 'hsl(var(--secondary))',
+        foreground: 'hsl(var(--secondary-foreground))',
+      },
+      destructive: {
+        DEFAULT: 'hsl(var(--destructive))',
+        foreground: 'hsl(var(--destructive-foreground))',
+      },
+      muted: {
+        DEFAULT: 'hsl(var(--muted))',
+        foreground: 'hsl(var(--muted-foreground))',
+      },
+      accent: {
+        DEFAULT: 'hsl(var(--accent))',
+        foreground: 'hsl(var(--accent-foreground))',
+      },
+      popover: {
+        DEFAULT: 'hsl(var(--popover))',
+        foreground: 'hsl(var(--popover-foreground))',
+      },
+      card: {
+        DEFAULT: 'hsl(var(--card))',
+        foreground: 'hsl(var(--card-foreground))',
+      },
+    },
+    borderRadius: {
+      lg: 'var(--radius)',
+      md: 'calc(var(--radius) - 2px)',
+      sm: 'calc(var(--radius) - 4px)',
+    },
+    animation: {
+      keyframes: {
+        'accordion-down':
+          '{ from { height: 0 } to { height: var(--kb-accordion-content-height) } }',
+        'accordion-up':
+          '{ from { height: var(--kb-accordion-content-height) } to { height: 0 } }',
+        'collapsible-down':
+          '{ from { height: 0 } to { height: var(--kb-collapsible-content-height) } }',
+        'collapsible-up':
+          '{ from { height: var(--kb-collapsible-content-height) } to { height: 0 } }',
+        'caret-blink': '{ 0%,70%,100% { opacity: 1 } 20%,50% { opacity: 0 } }',
+      },
+      timingFns: {
+        'accordion-down': 'ease-out',
+        'accordion-up': 'ease-out',
+        'collapsible-down': 'ease-out',
+        'collapsible-up': 'ease-out',
+        'caret-blink': 'ease-out',
+      },
+      durations: {
+        'accordion-down': '0.2s',
+        'accordion-up': '0.2s',
+        'collapsible-down': '0.2s',
+        'collapsible-up': '0.2s',
+        'caret-blink': '1.25s',
+      },
+      counts: {
+        'caret-blink': 'infinite',
+      },
+    },
+  },
+  shortcuts: {
+    'input-field': 'flex h-9 w-full bg-none outline-none rounded-lg border border-border border-solid bg-inherit px-3 py-1 text-sm shadow-none placeholder:text-muted-foreground focus-visible:(outline-none ring-1.5 ring-ring) disabled:(cursor-not-allowed opacity-50) transition-shadow',
+    'btn': 'text-sm font-medium hover:opacity-80 rounded-lg transition-all px-4 py-2 bg-none outline-none border-none cursor-pointer',
+  },
+});

apps/papra-client/CHANGELOG.md

@@ -0,0 +1,37 @@
+# @papra/app-client
+
+## 0.5.1
+
+## 0.5.0
+
+### Minor Changes
+
+- [#295](https://github.com/papra-hq/papra/pull/295) [`438a311`](https://github.com/papra-hq/papra/commit/438a31171c606138c4b7fa299fdd58dcbeaaf298) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Added support for custom oauth2 providers
+
+- [#291](https://github.com/papra-hq/papra/pull/291) [`0627ec2`](https://github.com/papra-hq/papra/commit/0627ec25a422b7b820b08740cfc2905f9c55c00e) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Added invitation system to add users to an organization
+
+### Patch Changes
+
+- [#296](https://github.com/papra-hq/papra/pull/296) [`0ddc234`](https://github.com/papra-hq/papra/commit/0ddc2340f092cf6fe5bf2175b55fb46db7681c36) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Fix register page description
+
+## 0.4.0
+
+### Minor Changes
+
+- [#280](https://github.com/papra-hq/papra/pull/280) [`85fa5c4`](https://github.com/papra-hq/papra/commit/85fa5c43424d139f5c2752a3ad644082e61d3d67) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Added webhook management
+
+- [#280](https://github.com/papra-hq/papra/pull/280) [`85fa5c4`](https://github.com/papra-hq/papra/commit/85fa5c43424d139f5c2752a3ad644082e61d3d67) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Added API keys support
+
+- [#280](https://github.com/papra-hq/papra/pull/280) [`85fa5c4`](https://github.com/papra-hq/papra/commit/85fa5c43424d139f5c2752a3ad644082e61d3d67) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Added document searchable content edit
+
+### Patch Changes
+
+- [#280](https://github.com/papra-hq/papra/pull/280) [`85fa5c4`](https://github.com/papra-hq/papra/commit/85fa5c43424d139f5c2752a3ad644082e61d3d67) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Added tag creation button in document page
+
+- [#280](https://github.com/papra-hq/papra/pull/280) [`85fa5c4`](https://github.com/papra-hq/papra/commit/85fa5c43424d139f5c2752a3ad644082e61d3d67) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Improved tag selector input wrapping
+
+- [#280](https://github.com/papra-hq/papra/pull/280) [`85fa5c4`](https://github.com/papra-hq/papra/commit/85fa5c43424d139f5c2752a3ad644082e61d3d67) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Properly handle file names without extensions
+
+- [#280](https://github.com/papra-hq/papra/pull/280) [`85fa5c4`](https://github.com/papra-hq/papra/commit/85fa5c43424d139f5c2752a3ad644082e61d3d67) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Wrap text in document preview
+
+- [#280](https://github.com/papra-hq/papra/pull/280) [`85fa5c4`](https://github.com/papra-hq/papra/commit/85fa5c43424d139f5c2752a3ad644082e61d3d67) Thanks [@CorentinTh](https://github.com/CorentinTh)! - Excluded deleted documents from doc count

apps/papra-client/package.json

@@ -1,8 +1,9 @@
 {
-  "name": "@papra/papra-app-client",
+  "name": "@papra/app-client",
   "type": "module",
-  "version": "0.1.1",
-  "packageManager": "pnpm@9.15.4",
+  "version": "0.5.1",
+  "private": true,
+  "packageManager": "pnpm@10.9.0",
   "description": "Papra frontend client",
   "author": "Corentin Thomasset <corentinth@proton.me> (https://corentin.tech)",
   "license": "AGPL-3.0-or-later",
@@ -25,8 +26,7 @@
     "test:e2e": "playwright test",
     "typecheck": "tsc --noEmit",
     "script:get-missing-i18n-keys": "tsx src/scripts/get-missing-i18n-keys.script.ts",
-    "script:generate-i18n-types": "tsx src/scripts/generate-i18n-types.script.ts",
-    "script:generate-i18n-types:watch": "tsx watch --include src/locales/en.yml src/scripts/generate-i18n-types.script.ts"
+    "script:generate-i18n-types": "tsx src/scripts/generate-i18n-types.script.ts"
   },
   "dependencies": {
     "@corentinth/chisels": "^1.0.2",
@@ -64,6 +64,7 @@
     "@types/node": "catalog:",
     "eslint": "catalog:",
     "jsdom": "^25.0.0",
+    "tinyglobby": "^0.2.13",
     "tsx": "^4.19.1",
     "typescript": "catalog:",
     "unocss": "0.65.0-beta.2",

apps/papra-client/src/locales/en.yml

@@ -1,35 +1,291 @@
-auth:
-  login:
-    title: Login to Papra
-    description: Enter your email or use social login to access your Papra account.
-    login-with-provider: Login with {{ provider }}
-    no-account: Don't have an account?
-    register: Register
-  email-validation-required:
-    title: Verify your email
-    description: A verification email has been sent to your email address. Please verify your email address by clicking the link in the email.
-  legal-links:
-    description: By continuing, you acknowledge that you understand and agree to the {{ terms }} and {{ privacy }}.
-    terms: Terms of Service
-    privacy: Privacy Policy
+auth.request-password-reset.title: Reset your password
+auth.request-password-reset.description: Enter your email to reset your password.
+auth.request-password-reset.requested: If an account exists for this email, we've sent you an email to reset your password.
+auth.request-password-reset.back-to-login: Back to login
+auth.request-password-reset.form.email.label: Email
+auth.request-password-reset.form.email.placeholder: 'Example: ada@papra.app'
+auth.request-password-reset.form.email.required: Please enter your email address
+auth.request-password-reset.form.email.invalid: This email address is invalid
+auth.request-password-reset.form.submit: Request password reset
 
-tags:
-  no-tags:
-    title: No tags yet
-    description: This organization has no tags yet. Tags are used to categorize documents. You can add tags to your documents to make them easier to find and organize.
-    create-tag: Create tag
+auth.reset-password.title: Reset your password
+auth.reset-password.description: Enter your new password to reset your password.
+auth.reset-password.reset: Your password has been reset.
+auth.reset-password.back-to-login: Back to login
+auth.reset-password.form.new-password.label: New password
+auth.reset-password.form.new-password.placeholder: 'Example: **********'
+auth.reset-password.form.new-password.required: Please enter your new password
+auth.reset-password.form.new-password.min-length: Password must be at least {{ minLength }} characters
+auth.reset-password.form.new-password.max-length: Password must be less than {{ maxLength }} characters
+auth.reset-password.form.submit: Reset password
 
-layout:
-  menu:
-    home: Home
-    documents: Documents
-    tags: Tags
-    integrations: Integrations
-    deleted-documents: Deleted documents
-    organization-settings: Organization settings
+auth.email-provider.open: Open {{ provider }}
 
-demo:
-  popup:
-    description: This is a demo environment, all data is save to your browser local storage.
-    reset: Reset demo data
-    hide: Hide
+auth.login.title: Login to Papra
+auth.login.description: Enter your email or use social login to access your Papra account.
+auth.login.login-with-provider: Login with {{ provider }}
+auth.login.no-account: Don't have an account?
+auth.login.register: Register
+auth.login.form.email.label: Email
+auth.login.form.email.placeholder: 'Example: ada@papra.app'
+auth.login.form.email.required: Please enter your email address
+auth.login.form.email.invalid: This email address is invalid
+auth.login.form.password.label: Password
+auth.login.form.password.placeholder: Set a password
+auth.login.form.password.required: Please enter your password
+auth.login.form.remember-me.label: Remember me
+auth.login.form.forgot-password.label: Forgot password?
+auth.login.form.submit: Login
+
+auth.register.title: Register to Papra
+auth.register.description: Create an account to start using Papra.
+auth.register.register-with-email: Register with email
+auth.register.register-with-provider: Register with {{ provider }}
+auth.register.providers.google: Google
+auth.register.providers.github: GitHub
+auth.register.have-account: Already have an account?
+auth.register.login: Login
+auth.register.registration-disabled.title: Registration is disabled
+auth.register.registration-disabled.description: The creation of new accounts is currently disabled on this instance of Papra. Only users with existing accounts can log in. If you think this is a mistake, please contact the administrator of this instance.
+auth.register.form.email.label: Email
+auth.register.form.email.placeholder: 'Example: ada@papra.app'
+auth.register.form.email.required: Please enter your email address
+auth.register.form.email.invalid: This email address is invalid
+auth.register.form.password.label: Password
+auth.register.form.password.placeholder: Set a password
+auth.register.form.password.required: Please enter your password
+auth.register.form.password.min-length: Password must be at least {{ minLength }} characters
+auth.register.form.password.max-length: Password must be less than {{ maxLength }} characters
+auth.register.form.name.label: Name
+auth.register.form.name.placeholder: 'Example: Ada Lovelace'
+auth.register.form.name.required: Please enter your name
+auth.register.form.name.max-length: Name must be less than {{ maxLength }} characters
+auth.register.form.submit: Register
+
+auth.email-validation-required.title: Verify your email
+auth.email-validation-required.description: A verification email has been sent to your email address. Please verify your email address by clicking the link in the email.
+
+auth.legal-links.description: By continuing, you acknowledge that you understand and agree to the {{ terms }} and {{ privacy }}.
+auth.legal-links.terms: Terms of Service
+auth.legal-links.privacy: Privacy Policy
+
+tags.no-tags.title: No tags yet
+tags.no-tags.description: This organization has no tags yet. Tags are used to categorize documents. You can add tags to your documents to make them easier to find and organize.
+tags.no-tags.create-tag: Create tag
+
+layout.menu.home: Home
+layout.menu.documents: Documents
+layout.menu.tags: Tags
+layout.menu.tagging-rules: Tagging rules
+layout.menu.deleted-documents: Deleted documents
+layout.menu.organization-settings: Settings
+layout.menu.api-keys: API keys
+layout.menu.settings: Settings
+layout.menu.account: Account
+layout.menu.general-settings: General settings
+layout.menu.intake-emails: Intake emails
+layout.menu.webhooks: Webhooks
+layout.menu.members: Members
+layout.menu.invitations: Invitations
+tagging-rules.field.name: document name
+tagging-rules.field.content: document content
+tagging-rules.operator.equals: equals
+tagging-rules.operator.not-equals: not equals
+tagging-rules.operator.contains: contains
+tagging-rules.operator.not-contains: not contains
+tagging-rules.operator.starts-with: starts with
+tagging-rules.operator.ends-with: ends with
+tagging-rules.list.title: Tagging rules
+tagging-rules.list.description: Manage your organization's tagging rules, to automatically tag documents based on conditions you define.
+tagging-rules.list.demo-warning: 'Note: As this is a demo environment (with no server), tagging rules will not be applied to newly added documents.'
+tagging-rules.list.no-tagging-rules.title: No tagging rules
+tagging-rules.list.no-tagging-rules.description: Create a tagging rule to automatically tag your added documents based on conditions you define.
+tagging-rules.list.no-tagging-rules.create-tagging-rule: Create tagging rule
+tagging-rules.list.card.no-conditions: No conditions
+tagging-rules.list.card.one-condition: 1 condition
+tagging-rules.list.card.conditions: '{{ count }} conditions'
+tagging-rules.list.card.delete: Delete rule
+tagging-rules.list.card.edit: Edit rule
+tagging-rules.create.title: Create tagging rule
+tagging-rules.create.success: Tagging rule created successfully
+tagging-rules.create.error: Failed to create tagging rule
+tagging-rules.create.submit: Create rule
+tagging-rules.form.name.label: Name
+tagging-rules.form.name.placeholder: 'Example: Tag invoices'
+tagging-rules.form.name.min-length: Please enter a name for the rule
+tagging-rules.form.name.max-length: The name must be less than 64 characters
+tagging-rules.form.description.label: Description
+tagging-rules.form.description.placeholder: "Example: Tag documents with 'invoice' in the name"
+tagging-rules.form.description.max-length: The description must be less than 256 characters
+tagging-rules.form.conditions.label: Conditions
+tagging-rules.form.conditions.description: Define the conditions that must be met for the rule to apply. All conditions must be met for the rule to apply.
+tagging-rules.form.conditions.add-condition: Add condition
+tagging-rules.form.conditions.no-conditions.title: No conditions
+tagging-rules.form.conditions.no-conditions.description: You didn't add any conditions to this rule. This rule will apply its tags to all documents.
+tagging-rules.form.conditions.no-conditions.confirm: Apply rule without conditions
+tagging-rules.form.conditions.no-conditions.cancel: Cancel
+tagging-rules.form.conditions.value.placeholder: 'Example: invoice'
+tagging-rules.form.conditions.value.min-length: Please enter a value for the condition
+tagging-rules.form.tags.label: Tags
+tagging-rules.form.tags.description: Select the tags to apply to the added documents that match the conditions
+tagging-rules.form.tags.min-length: At least one tag to apply is required
+tagging-rules.form.tags.add-tag: Create tag
+tagging-rules.form.submit: Create rule
+tagging-rules.update.title: Update tagging rule
+tagging-rules.update.error: Failed to update tagging rule
+tagging-rules.update.submit: Update rule
+tagging-rules.update.cancel: Cancel
+
+demo.popup.description: This is a demo environment, all data is save to your browser local storage.
+demo.popup.discord: Join the {{ discordLink }} to get support, propose features or just chat.
+demo.popup.discord-link-label: Discord server
+demo.popup.reset: Reset demo data
+demo.popup.hide: Hide
+
+trash.delete-all.button: Delete all
+trash.delete-all.confirm.title: Permanently delete all documents?
+trash.delete-all.confirm.description: Are you sure you want to permanently delete all documents from the trash? This action cannot be undone.
+trash.delete-all.confirm.label: Delete
+trash.delete-all.confirm.cancel: Cancel
+trash.delete.button: Delete
+trash.delete.confirm.title: Permanently delete document?
+trash.delete.confirm.description: Are you sure you want to permanently delete this document from the trash? This action cannot be undone.
+trash.delete.confirm.label: Delete
+trash.delete.confirm.cancel: Cancel
+trash.deleted.success.title: Document deleted
+trash.deleted.success.description: The document has been permanently deleted.
+
+import-documents.title.error: '{{ count }} documents failed'
+import-documents.title.success: '{{ count }} documents imported'
+import-documents.title.pending: '{{ count }} / {{ total }} documents imported'
+import-documents.title.none: Import documents
+import-documents.no-import-in-progress: No document import in progress
+
+api-errors.document.already_exists: The document already exists
+api-errors.document.file_too_big: The document file is too big
+api-errors.intake_email.limit_reached: The maximum number of intake emails for this organization has been reached. Please upgrade your plan to create more intake emails.
+api-errors.user.max_organization_count_reached: You have reached the maximum number of organizations you can create, if you need to create more, please contact support.
+api-errors.default: An error occurred while processing your request.
+api-errors.organization.invitation_already_exists: An invitation for this email already exists in this organization.
+api-errors.user.already_in_organization: This user is already in this organization.
+api-errors.user.organization_invitation_limit_reached: The maximum number of invitations has been reached for today. Please try again tomorrow.
+api-errors.demo.not_available: This feature is not available in demo
+
+api-keys.permissions.documents.title: Documents
+api-keys.permissions.documents.documents:create: Create documents
+api-keys.permissions.documents.documents:read: Read documents
+api-keys.permissions.documents.documents:update: Update documents
+api-keys.permissions.documents.documents:delete: Delete documents
+api-keys.permissions.tags.title: Tags
+api-keys.permissions.tags.tags:create: Create tags
+api-keys.permissions.tags.tags:read: Read tags
+api-keys.permissions.tags.tags:update: Update tags
+api-keys.permissions.tags.tags:delete: Delete tags
+api-keys.create.title: Create API key
+api-keys.create.description: Create a new API key to access the Papra API.
+api-keys.create.success: The API key has been created successfully.
+api-keys.create.back: Back to API keys
+api-keys.create.form.name.label: Name
+api-keys.create.form.name.placeholder: 'Example: My API key'
+api-keys.create.form.name.required: Please enter a name for the API key
+api-keys.create.form.permissions.label: Permissions
+api-keys.create.form.permissions.required: Please select at least one permission
+api-keys.create.form.submit: Create API key
+api-keys.create.created.title: API key created
+api-keys.create.created.description: The API key has been created successfully. Save it in a secure location as it will not be displayed again.
+api-keys.list.title: API keys
+api-keys.list.description: Manage your API keys here.
+api-keys.list.create: Create API key
+api-keys.list.empty.title: No API keys
+api-keys.list.empty.description: Create an API key to access the Papra API.
+api-keys.list.card.last-used: Last used
+api-keys.list.card.never: Never
+api-keys.list.card.created: Created
+api-keys.delete.success: The API key has been deleted successfully
+api-keys.delete.confirm.title: Delete API key
+api-keys.delete.confirm.message: Are you sure you want to delete this API key? This action cannot be undone.
+api-keys.delete.confirm.confirm-button: Delete
+api-keys.delete.confirm.cancel-button: Cancel
+
+webhooks.list.title: Webhooks
+webhooks.list.description: Manage your organization webhooks
+webhooks.list.empty.title: No webhooks
+webhooks.list.empty.description: Create your first webhook to start receiving events
+webhooks.list.create: Create webhook
+webhooks.list.card.last-triggered: Last triggered
+webhooks.list.card.never: Never
+webhooks.list.card.created: Created
+
+webhooks.create.title: Create webhook
+webhooks.create.description: Create a new webhook to receive events
+webhooks.create.success: Webhook created successfully
+webhooks.create.back: Back
+webhooks.create.form.submit: Create webhook
+webhooks.create.form.name.label: Webhook name
+webhooks.create.form.name.placeholder: Enter webhook name
+webhooks.create.form.name.required: Name is required
+webhooks.create.form.url.label: Webhook URL
+webhooks.create.form.url.placeholder: Enter webhook URL
+webhooks.create.form.url.required: URL is required
+webhooks.create.form.url.invalid: URL is invalid
+webhooks.create.form.secret.label: Secret
+webhooks.create.form.secret.placeholder: Enter webhook secret
+webhooks.create.form.events.label: Events
+webhooks.create.form.events.required: At least one event is required
+webhooks.update.title: Edit webhook
+webhooks.update.description: Update your webhook details
+webhooks.update.success: Webhook updated successfully
+webhooks.update.submit: Update webhook
+webhooks.update.cancel: Cancel
+webhooks.update.form.secret.placeholder: Enter new secret
+webhooks.update.form.secret.placeholder-redacted: '[Redacted secret]'
+webhooks.update.form.rotate-secret.button: Rotate secret
+webhooks.delete.success: Webhook deleted successfully
+webhooks.delete.confirm.title: Delete webhook
+webhooks.delete.confirm.message: Are you sure you want to delete this webhook?
+webhooks.delete.confirm.confirm-button: Delete
+webhooks.delete.confirm.cancel-button: Cancel
+
+webhooks.events.documents.document:created.description: Document created
+webhooks.events.documents.document:deleted.description: Document deleted
+
+organizations.members.title: Members
+organizations.members.description: Manage your organization members
+organizations.members.invite-member: Invite member
+organizations.members.invite-member-disabled-tooltip: Only admins or owners can invite members to the organization
+organizations.members.remove-from-organization: Remove from organization
+organizations.members.role: Role
+organizations.members.roles.owner: Owner
+organizations.members.roles.admin: Admin
+organizations.members.roles.member: Member
+organizations.members.delete.confirm.title: Remove member
+organizations.members.delete.confirm.message: Are you sure you want to remove this member from the organization?
+organizations.members.delete.confirm.confirm-button: Remove
+organizations.members.delete.confirm.cancel-button: Cancel
+organizations.members.delete.success: Member removed from organization
+organizations.members.update-role.success: Member role updated
+
+organizations.invite-member.title: Invite member
+organizations.invite-member.description: Invite a member to your organization
+organizations.invite-member.form.email.label: Email
+organizations.invite-member.form.email.placeholder: 'Example: ada@papra.app'
+organizations.invite-member.form.email.required: Please enter a valid email address
+organizations.invite-member.form.role.label: Role
+organizations.invite-member.form.submit: Invite to organization
+organizations.invite-member.success.message: Member invited
+organizations.invite-member.success.description: The email has been invited to the organization.
+organizations.invite-member.error.message: Failed to invite member
+
+invitations.list.title: Invitations
+invitations.list.description: Manage your organization invitations
+invitations.list.empty.title: No pending invitations
+invitations.list.empty.description: You haven't been invited to any organizations yet.
+invitations.list.headers.organization: Organization
+invitations.list.headers.created: Created
+invitations.list.headers.actions: Actions
+invitations.list.actions.accept: Accept
+invitations.list.actions.reject: Reject
+invitations.list.actions.accept.success.message: Invitation accepted
+invitations.list.actions.accept.success.description: The invitation has been accepted.
+invitations.list.actions.reject.success.message: Invitation rejected
+invitations.list.actions.reject.success.description: The invitation has been rejected.

apps/papra-client/src/locales/fr.yml

@@ -1,35 +1,202 @@
-auth:
-  login:
-    title: Connexion à Papra
-    description: Entrez votre adresse e-mail ou utilisez un service tiers pour accéder à votre compte Papra.
-    login-with-provider: Connexion via {{ provider }}
-    no-account: Vous n'avez pas de compte ?
-    register: S'inscrire
-  email-validation-required:
-    title: Vérifiez votre adresse e-mail
-    description: Un e-mail de vérification a été envoyé à votre adresse. Veuillez vérifier votre adresse en cliquant sur le lien dans l'e-mail.
-  legal-links:
-    description: En continuant, vous reconnaissez que vous comprenez et acceptez les {{ terms }} et la {{ privacy }}.
-    terms: Conditions d'utilisation
-    privacy: Politique de confidentialité
+auth.request-password-reset.title: Réinitialiser votre mot de passe
+auth.request-password-reset.description: Entrez votre email pour réinitialiser votre mot de passe.
+auth.request-password-reset.requested: Si un compte existe pour cet email, nous vous avons envoyé un email pour réinitialiser votre mot de passe.
+auth.request-password-reset.back-to-login: Retour à la connexion
+auth.request-password-reset.form.email.label: Email
+auth.request-password-reset.form.email.placeholder: 'Exemple: ada@papra.app'
+auth.request-password-reset.form.email.required: Veuillez entrer votre adresse email
+auth.request-password-reset.form.email.invalid: Cette adresse email est invalide
+auth.request-password-reset.form.submit: Réinitialiser le mot de passe
 
-tags:
-  no-tags:
-    title: Aucun tag pour le moment
-    description: Cette organisation n'a pas encore de tags. Les tags sont utilisés pour catégoriser les documents. Vous pouvez ajouter des tags à vos documents pour les rendre plus faciles à trouver et à organiser.
-    create-tag: Créer un tag
+auth.reset-password.title: Réinitialiser votre mot de passe
+auth.reset-password.description: Entrez votre nouveau mot de passe pour réinitialiser votre mot de passe.
+auth.reset-password.reset: Votre mot de passe a été réinitialisé.
+auth.reset-password.back-to-login: Retour à la connexion
+auth.reset-password.form.new-password.label: Nouveau mot de passe
+auth.reset-password.form.new-password.placeholder: 'Exemple: **********'
+auth.reset-password.form.new-password.required: Veuillez entrer votre nouveau mot de passe
+auth.reset-password.form.new-password.min-length: Le mot de passe doit contenir au moins {{ minLength }} caractères
+auth.reset-password.form.new-password.max-length: Le mot de passe doit contenir moins de {{ maxLength }} caractères
+auth.reset-password.form.submit: Réinitialiser le mot de passe
 
-layout:
-  menu:
-    home: Accueil
-    documents: Documents
-    tags: Tags
-    integrations: Intégrations
-    deleted-documents: Documents supprimés
-    organization-settings: Paramètres de l'organisation
+auth.email-provider.open: Ouvrir {{ provider }}
 
-demo:
-  popup:
-    description: Ceci est un environnement de démo, toutes les données sont enregistrées dans le local storage de votre navigateur.
-    reset: Réinitialiser la démo
-    hide: Masquer
+auth.login.title: Connexion à Papra
+auth.login.description: Entrez votre email ou utilisez une connexion sociale pour accéder à votre compte Papra.
+auth.login.login-with-provider: Connexion avec {{ provider }}
+auth.login.no-account: Je n'ai pas de compte
+auth.login.register: S'inscrire
+auth.login.form.email.label: Email
+auth.login.form.email.placeholder: 'Exemple: ada@papra.app'
+auth.login.form.email.required: Veuillez entrer votre adresse email
+auth.login.form.email.invalid: Cette adresse email est invalide
+auth.login.form.password.label: Mot de passe
+auth.login.form.password.placeholder: Définir un mot de passe
+auth.login.form.password.required: Veuillez entrer votre mot de passe
+auth.login.form.remember-me.label: Se souvenir de moi
+auth.login.form.forgot-password.label: Mot de passe oublié ?
+auth.login.form.submit: Connexion
+
+auth.register.title: S'inscrire à Papra
+auth.register.description: Créez un compte pour commencer à utiliser Papra.
+auth.register.register-with-email: S'inscrire avec email
+auth.register.register-with-provider: S'inscrire avec {{ provider }}
+auth.register.providers.google: Google
+auth.register.providers.github: GitHub
+auth.register.have-account: Je possède déjà un compte
+auth.register.login: Connexion
+auth.register.registration-disabled.title: Inscription désactivée
+auth.register.registration-disabled.description: La création de nouveaux comptes est actuellement désactivée sur cette instance de Papra. Seuls les utilisateurs avec un compte existant peuvent se connecter. Si vous pensez que c'est une erreur, veuillez contacter l'administrateur de cette instance.
+auth.register.form.email.label: Email
+auth.register.form.email.placeholder: 'Exemple: ada@papra.app'
+auth.register.form.email.required: Veuillez entrer votre adresse email
+auth.register.form.email.invalid: Cette adresse email est invalide
+auth.register.form.password.label: Mot de passe
+auth.register.form.password.placeholder: Définir un mot de passe
+auth.register.form.password.required: Veuillez entrer votre mot de passe
+auth.register.form.password.min-length: Le mot de passe doit contenir au moins {{ minLength }} caractères
+auth.register.form.password.max-length: Le mot de passe doit contenir moins de {{ maxLength }} caractères
+auth.register.form.name.label: Nom
+auth.register.form.name.placeholder: 'Exemple: Ada Lovelace'
+auth.register.form.name.required: Veuillez entrer votre nom
+auth.register.form.name.max-length: Le nom doit contenir moins de {{ maxLength }} caractères
+auth.register.form.submit: S'inscrire
+
+auth.email-validation-required.title: Vérifier votre email
+auth.email-validation-required.description: Un email de vérification a été envoyé à votre adresse email. Veuillez vérifier votre adresse email en cliquant sur le lien dans l'email.
+
+auth.legal-links.description: En continuant, vous reconnaissez que vous comprenez et acceptez les {{ terms }} et {{ privacy }}.
+auth.legal-links.terms: Conditions d'utilisation
+auth.legal-links.privacy: Politique de confidentialité
+
+tags.no-tags.title: Aucun tag
+tags.no-tags.description: Cette organisation n'a pas de tags. Les tags sont utilisés pour catégoriser les documents. Vous pouvez ajouter des tags à vos documents pour les rendre plus faciles à trouver et à organiser.
+tags.no-tags.create-tag: Créer un tag
+
+layout.menu.home: Accueil
+layout.menu.documents: Documents
+layout.menu.tags: Tags
+layout.menu.tagging-rules: Règles de catégorisation
+layout.menu.deleted-documents: Documents supprimés
+layout.menu.organization-settings: Paramètres
+layout.menu.api-keys: API keys
+layout.menu.settings: Paramètres
+layout.menu.account: Compte
+
+tagging-rules.field.name: nom du document
+tagging-rules.field.content: contenu du document
+
+tagging-rules.operator.equals: égal à
+tagging-rules.operator.not-equals: différent de
+tagging-rules.operator.contains: contient
+tagging-rules.operator.not-contains: ne contient pas
+tagging-rules.operator.starts-with: commence par
+tagging-rules.operator.ends-with: finit par
+
+tagging-rules.list.title: Règles de catégorisation
+tagging-rules.list.description: Gérez vos règles de catégorisation, pour catégoriser automatiquement les documents en fonction de conditions que vous définissez.
+tagging-rules.list.demo-warning: 'Note: Cette instance est une démo, les règles de catégorisation ne seront pas appliquées aux documents ajoutés.'
+tagging-rules.list.no-tagging-rules.title: Aucune règle de catégorisation
+tagging-rules.list.no-tagging-rules.description: Créez une règle de catégorisation pour catégoriser automatiquement vos documents en fonction de conditions que vous définissez.
+tagging-rules.list.no-tagging-rules.create-tagging-rule: Créer une règle de catégorisation
+tagging-rules.list.card.no-conditions: Aucune condition
+tagging-rules.list.card.one-condition: 1 condition
+tagging-rules.list.card.conditions: '{{ count }} conditions'
+tagging-rules.list.card.delete: Supprimer la règle
+tagging-rules.list.card.edit: Modifier la règle
+tagging-rules.create.title: Créer une règle de catégorisation
+tagging-rules.create.success: Règle de catégorisation créée avec succès
+tagging-rules.create.error: Échec de la création de la règle de catégorisation
+tagging-rules.create.submit: Créer la règle
+tagging-rules.form.name.label: Nom
+tagging-rules.form.name.placeholder: 'Exemple: Catégoriser les factures'
+tagging-rules.form.name.min-length: Veuillez entrer un nom pour la règle
+tagging-rules.form.name.max-length: Le nom doit contenir moins de 64 caractères
+tagging-rules.form.description.label: Description
+tagging-rules.form.description.placeholder: "Exemple: Catégoriser les documents avec 'facture' dans le nom"
+tagging-rules.form.description.max-length: La description doit contenir moins de 256 caractères
+tagging-rules.form.conditions.label: Conditions
+tagging-rules.form.conditions.description: Définissez les conditions que doivent remplir la règle pour qu'elle s'applique. Toutes les conditions doivent être remplies pour que la règle s'applique.
+tagging-rules.form.conditions.add-condition: Ajouter une condition
+tagging-rules.form.conditions.no-conditions.title: Aucune condition
+tagging-rules.form.conditions.no-conditions.description: Vous n'avez pas ajouté de conditions à cette règle. Cette règle appliquera ses tags à tous les documents.
+tagging-rules.form.conditions.no-conditions.confirm: Appliquer la règle sans conditions
+tagging-rules.form.conditions.no-conditions.cancel: Annuler
+tagging-rules.form.conditions.value.placeholder: 'Exemple: facture'
+tagging-rules.form.conditions.value.min-length: Veuillez entrer une valeur pour la condition
+tagging-rules.form.tags.label: Tags
+tagging-rules.form.tags.description: Sélectionnez les tags à appliquer aux documents ajoutés qui correspondent aux conditions
+tagging-rules.form.tags.min-length: Au moins un tag à appliquer est requis
+tagging-rules.form.tags.add-tag: Créer un tag
+tagging-rules.form.submit: Créer la règle
+tagging-rules.update.title: Mettre à jour la règle de catégorisation
+tagging-rules.update.error: Échec de la mise à jour de la règle de catégorisation
+tagging-rules.update.submit: Mettre à jour la règle
+tagging-rules.update.cancel: Annuler
+
+demo.popup.description: Cette instance est une démo, toutes les données sont sauvegardées dans le stockage local de votre navigateur.
+demo.popup.discord: Rejoignez le {{ discordLink }} pour obtenir de l'aide, proposer des fonctionnalités ou simplement discuter.
+demo.popup.discord-link-label: Serveur Discord
+demo.popup.reset: Réinitialiser les données de la démo
+demo.popup.hide: Masquer
+
+trash.delete-all.button: Supprimer tous les documents
+trash.delete-all.confirm.title: Supprimer définitivement tous les documents ?
+trash.delete-all.confirm.description: Êtes-vous sûr de vouloir supprimer définitivement tous les documents de la corbeille ? Cette action est irréversible.
+trash.delete-all.confirm.label: Supprimer
+trash.delete-all.confirm.cancel: Annuler
+trash.delete.button: Supprimer
+trash.delete.confirm.title: Supprimer définitivement le document ?
+trash.delete.confirm.description: Êtes-vous sûr de vouloir supprimer définitivement ce document de la corbeille ? Cette action est irréversible.
+trash.delete.confirm.label: Supprimer
+trash.delete.confirm.cancel: Annuler
+trash.deleted.success.title: Document supprimé
+trash.deleted.success.description: Le document a été supprimé définitivement.
+
+import-documents.title.error: '{{ count }} documents ont échoué'
+import-documents.title.success: '{{ count }} documents ont été importés'
+import-documents.title.pending: '{{ count }} / {{ total }} documents importés'
+import-documents.title.none: Importer des documents
+import-documents.no-import-in-progress: Aucune importation de documents en cours
+
+api-errors.document.already_exists: Le document existe déjà
+api-errors.document.file_too_big: Le fichier du document est trop grand
+api-errors.intake_email.limit_reached: Le nombre maximum d'emails de réception pour cette organisation a été atteint. Veuillez mettre à niveau votre plan pour créer plus d'emails de réception.
+api-errors.user.max_organization_count_reached: Vous avez atteint le nombre maximum d'organisations que vous pouvez créer, si vous avez besoin de créer plus, veuillez contacter le support.
+api-errors.default: Une erreur est survenue lors du traitement de votre requête.
+
+api-keys.permissions.documents.title: Documents
+api-keys.permissions.documents.documents:create: Créer des documents
+api-keys.permissions.documents.documents:read: Lire des documents
+api-keys.permissions.documents.documents:update: Mettre à jour des documents
+api-keys.permissions.documents.documents:delete: Supprimer des documents
+api-keys.permissions.tags.title: Tags
+api-keys.permissions.tags.tags:create: Créer des tags
+api-keys.permissions.tags.tags:read: Lire des tags
+api-keys.permissions.tags.tags:update: Mettre à jour des tags
+api-keys.permissions.tags.tags:delete: Supprimer des tags
+api-keys.create.title: Créer une clé API
+api-keys.create.description: Créer une nouvelle clé API pour accéder à l'API de Papra.
+api-keys.create.success: La clé API a été créée avec succès.
+api-keys.create.back: Retour aux clés API
+api-keys.create.form.name.label: Nom
+api-keys.create.form.name.placeholder: 'Exemple: Ma clé API'
+api-keys.create.form.name.required: Veuillez entrer un nom pour la clé API
+api-keys.create.form.permissions.label: Permissions
+api-keys.create.form.permissions.required: Veuillez sélectionner au moins une permission
+api-keys.create.form.submit: Créer la clé API
+api-keys.create.created.title: Clé API créée
+api-keys.create.created.description: La clé API a été créée avec succès. Enregistrez-la dans un endroit sûr car elle ne sera plus affichée.
+api-keys.list.title: Clés API
+api-keys.list.description: Gérez vos clés API ici.
+api-keys.list.create: Créer une clé API
+api-keys.list.empty.title: Aucune clé API
+api-keys.list.empty.description: Créez une clé API pour accéder à l'API de Papra.
+api-keys.list.card.last-used: Dernière utilisation
+api-keys.list.card.never: Jamais
+api-keys.list.card.created: Créée
+api-keys.delete.success: La clé API a été supprimée avec succès
+api-keys.delete.confirm.title: Supprimer la clé API
+api-keys.delete.confirm.message: Êtes-vous sûr de vouloir supprimer cette clé API ? Cette action est irréversible.
+api-keys.delete.confirm.confirm-button: Supprimer
+api-keys.delete.confirm.cancel-button: Annuler

apps/papra-client/src/modules/api-keys/api-keys.constants.ts

@@ -0,0 +1,28 @@
+// export const API_KEY_PERMISSIONS = {
+//   documents: {
+//     create: 'documents:create',
+//   },
+// } as const;
+
+export const API_KEY_PERMISSIONS = [
+  {
+    section: 'documents',
+    permissions: [
+      'documents:create',
+      'documents:read',
+      'documents:update',
+      'documents:delete',
+    ],
+  },
+  {
+    section: 'tags',
+    permissions: [
+      'tags:create',
+      'tags:read',
+      'tags:update',
+      'tags:delete',
+    ],
+  },
+] as const;
+
+export const API_KEY_PERMISSIONS_LIST = API_KEY_PERMISSIONS.flatMap(permission => permission.permissions);

apps/papra-client/src/modules/api-keys/api-keys.services.ts

@@ -0,0 +1,56 @@
+import type { ApiKey } from './api-keys.types';
+import { apiClient } from '../shared/http/api-client';
+import { coerceDates } from '../shared/http/http-client.models';
+
+export async function createApiKey({
+  name,
+  permissions,
+  organizationIds,
+  allOrganizations,
+  expiresAt,
+}: {
+  name: string;
+  permissions: string[];
+  organizationIds: string[];
+  allOrganizations: boolean;
+  expiresAt?: Date;
+}) {
+  const { apiKey, token } = await apiClient<{
+    apiKey: ApiKey;
+    token: string;
+  }>({
+    path: '/api/api-keys',
+    method: 'POST',
+    body: {
+      name,
+      permissions,
+      organizationIds,
+      allOrganizations,
+      expiresAt,
+    },
+  });
+
+  return {
+    apiKey: coerceDates(apiKey),
+    token,
+  };
+}
+
+export async function fetchApiKeys() {
+  const { apiKeys } = await apiClient<{
+    apiKeys: ApiKey[];
+  }>({
+    path: '/api/api-keys',
+  });
+
+  return {
+    apiKeys: apiKeys.map(coerceDates),
+  };
+}
+
+export async function deleteApiKey({ apiKeyId }: { apiKeyId: string }) {
+  await apiClient({
+    path: `/api/api-keys/${apiKeyId}`,
+    method: 'DELETE',
+  });
+}

apps/papra-client/src/modules/api-keys/api-keys.types.ts

@@ -0,0 +1,12 @@
+export type ApiKey = {
+  id: string;
+  name: string;
+  permissions: string[];
+  organizationIds: string[];
+  allOrganizations: boolean;
+  expiresAt?: Date;
+  prefix: string;
+  lastUsedAt?: Date;
+  createdAt: Date;
+  updatedAt: Date;
+};

apps/papra-client/src/modules/api-keys/components/api-key-permissions-picker.component.tsx

@@ -0,0 +1,75 @@
+import type { Component } from 'solid-js';
+import type { LocaleKeys } from '@/modules/i18n/locales.types';
+import { createSignal, For } from 'solid-js';
+import { useI18n } from '@/modules/i18n/i18n.provider';
+import { Checkbox, CheckboxControl, CheckboxLabel } from '@/modules/ui/components/checkbox';
+import { API_KEY_PERMISSIONS } from '../api-keys.constants';
+
+export const ApiKeyPermissionsPicker: Component<{ permissions: string[]; onChange: (permissions: string[]) => void }> = (props) => {
+  const [permissions, setPermissions] = createSignal<string[]>(props.permissions);
+  const { t } = useI18n();
+
+  const getPermissionsSections = () => {
+    return API_KEY_PERMISSIONS.map(section => ({
+      ...section,
+      title: t(`api-keys.permissions.${section.section}.title`),
+      permissions: section.permissions.map((permission) => {
+        const [prefix, suffix] = permission.split(':');
+
+        return {
+          name: permission,
+          prefix,
+          suffix,
+          description: t(`api-keys.permissions.${section.section}.${permission}` as LocaleKeys),
+        };
+      }),
+    }));
+  };
+
+  const isPermissionSelected = (permission: string) => {
+    return permissions().includes(permission);
+  };
+
+  const togglePermission = (permission: string) => {
+    setPermissions((prev) => {
+      if (prev.includes(permission)) {
+        return prev.filter(p => p !== permission);
+      }
+
+      return [...prev, permission];
+    });
+
+    props.onChange(permissions());
+  };
+
+  return (
+    <div class="grid grid-cols-1 sm:grid-cols-2 gap-4">
+      <For each={getPermissionsSections()}>
+        {section => (
+          <div>
+            <p class="text-muted-foreground text-xs">{section.title}</p>
+
+            <div class="pl-4 flex flex-col gap-4 mt-4">
+              <For each={section.permissions}>
+                {permission => (
+                  <Checkbox
+                    class="flex items-center gap-2"
+                    checked={isPermissionSelected(permission.name)}
+                    onChange={() => togglePermission(permission.name)}
+                  >
+                    <CheckboxControl />
+                    <div class="flex flex-col gap-1">
+                      <CheckboxLabel class="text-sm leading-none">
+                        {permission.description}
+                      </CheckboxLabel>
+                    </div>
+                  </Checkbox>
+                )}
+              </For>
+            </div>
+          </div>
+        )}
+      </For>
+    </div>
+  );
+};

apps/papra-client/src/modules/api-keys/pages/api-keys.page.tsx

@@ -0,0 +1,140 @@
+import type { Component } from 'solid-js';
+import type { ApiKey } from '../api-keys.types';
+import { A } from '@solidjs/router';
+import { createMutation, createQuery } from '@tanstack/solid-query';
+import { format } from 'date-fns';
+import { For, Match, Show, Suspense, Switch } from 'solid-js';
+import { useI18n } from '@/modules/i18n/i18n.provider';
+import { useConfirmModal } from '@/modules/shared/confirm';
+import { queryClient } from '@/modules/shared/query/query-client';
+import { Button } from '@/modules/ui/components/button';
+import { EmptyState } from '@/modules/ui/components/empty';
+import { createToast } from '@/modules/ui/components/sonner';
+import { deleteApiKey, fetchApiKeys } from '../api-keys.services';
+
+export const ApiKeyCard: Component<{ apiKey: ApiKey }> = ({ apiKey }) => {
+  const { t } = useI18n();
+  const { confirm } = useConfirmModal();
+
+  const deleteApiKeyMutation = createMutation(() => ({
+    mutationFn: deleteApiKey,
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['api-keys'] });
+      createToast({
+        message: t('api-keys.delete.success'),
+      });
+    },
+  }));
+
+  const handleDelete = async () => {
+    const confirmed = await confirm({
+      title: t('api-keys.delete.confirm.title'),
+      message: t('api-keys.delete.confirm.message'),
+      confirmButton: {
+        text: t('api-keys.delete.confirm.confirm-button'),
+        variant: 'destructive',
+      },
+      cancelButton: {
+        text: t('api-keys.delete.confirm.cancel-button'),
+      },
+    });
+
+    if (!confirmed) {
+      return;
+    }
+
+    deleteApiKeyMutation.mutate({ apiKeyId: apiKey.id });
+  };
+
+  return (
+    <div class="bg-card rounded-lg border p-4 flex items-center gap-4">
+      <div class="rounded-lg bg-muted p-2">
+        <div class="i-tabler-key text-muted-foreground size-5 text-primary" />
+      </div>
+      <div class="flex-1">
+        <h2 class="text-sm font-medium leading-tight">{apiKey.name}</h2>
+        <p class="text-muted-foreground text-xs font-mono">{`${apiKey.prefix}...`}</p>
+      </div>
+
+      <div>
+        <p class="text-muted-foreground text-xs">
+          {t('api-keys.list.card.last-used')}
+          {' '}
+          {apiKey.lastUsedAt ? format(apiKey.lastUsedAt, 'MMM d, yyyy') : t('api-keys.list.card.never')}
+        </p>
+        <p class="text-muted-foreground text-xs">
+          {t('api-keys.list.card.created')}
+          {' '}
+          {format(apiKey.createdAt, 'MMM d, yyyy')}
+        </p>
+      </div>
+
+      <div class="flex items-center gap-2">
+        <Button
+          variant="outline"
+          size="icon"
+          isLoading={deleteApiKeyMutation.isPending}
+          onClick={handleDelete}
+        >
+          <div class="i-tabler-trash text-muted-foreground size-4" />
+        </Button>
+      </div>
+    </div>
+  );
+};
+
+export const ApiKeysPage: Component = () => {
+  const { t } = useI18n();
+  const query = createQuery(() => ({
+    queryKey: ['api-keys'],
+    queryFn: () => fetchApiKeys(),
+  }));
+
+  return (
+    <div class="p-6 mt-12 pb-32 mx-auto max-w-xl w-full">
+      <div class="border-b pb-4 flex items-center justify-between">
+        <div>
+          <h1 class="text-2xl font-semibold mb-1">{t('api-keys.list.title')}</h1>
+          <p class="text-muted-foreground">{t('api-keys.list.description')}</p>
+        </div>
+        <div>
+          <Show when={query.data?.apiKeys?.length}>
+            <Button as={A} href="/api-keys/create" class="gap-2">
+              <div class="i-tabler-plus size-4" />
+              {t('api-keys.list.create')}
+            </Button>
+          </Show>
+        </div>
+      </div>
+
+      <Suspense>
+        <Switch>
+          <Match when={query.data?.apiKeys?.length === 0}>
+            <EmptyState
+              title={t('api-keys.list.empty.title')}
+              description={t('api-keys.list.empty.description')}
+              icon="i-tabler-key"
+              cta={(
+                <Button as={A} href="/api-keys/create" class="gap-2">
+                  <div class="i-tabler-plus size-4" />
+                  {t('api-keys.list.create')}
+                </Button>
+              )}
+            />
+          </Match>
+
+          <Match when={query.data?.apiKeys?.length}>
+
+            <div class="mt-6 flex flex-col gap-2">
+              <For each={query.data?.apiKeys}>
+                {apiKey => (
+                  <ApiKeyCard apiKey={apiKey} />
+                )}
+              </For>
+            </div>
+          </Match>
+        </Switch>
+      </Suspense>
+    </div>
+  );
+};

apps/papra-client/src/modules/api-keys/pages/create-api-key.page.tsx

@@ -0,0 +1,118 @@
+import type { Component } from 'solid-js';
+import { setValue } from '@modular-forms/solid';
+import { A } from '@solidjs/router';
+import { createSignal, Show } from 'solid-js';
+import * as v from 'valibot';
+import { useI18n } from '@/modules/i18n/i18n.provider';
+import { createForm } from '@/modules/shared/form/form';
+import { queryClient } from '@/modules/shared/query/query-client';
+import { CopyButton } from '@/modules/shared/utils/copy';
+import { Button } from '@/modules/ui/components/button';
+import { createToast } from '@/modules/ui/components/sonner';
+import { TextField, TextFieldLabel, TextFieldRoot } from '@/modules/ui/components/textfield';
+import { API_KEY_PERMISSIONS_LIST } from '../api-keys.constants';
+import { createApiKey } from '../api-keys.services';
+import { ApiKeyPermissionsPicker } from '../components/api-key-permissions-picker.component';
+
+export const CreateApiKeyPage: Component = () => {
+  const { t } = useI18n();
+  const [getToken, setToken] = createSignal<string | null>(null);
+
+  const { form, Form, Field } = createForm({
+    onSubmit: async ({ name, permissions }) => {
+      const { token } = await createApiKey({
+        name,
+        permissions,
+        organizationIds: [],
+        allOrganizations: false,
+      });
+
+      await queryClient.invalidateQueries({ queryKey: ['api-keys'] });
+
+      setToken(token);
+
+      createToast({
+        type: 'success',
+        message: t('api-keys.create.success'),
+      });
+    },
+    schema: v.object({
+      name: v.pipe(
+        v.string(),
+        v.nonEmpty(t('api-keys.create.form.name.required')),
+      ),
+      permissions: v.pipe(
+        v.array(v.picklist(API_KEY_PERMISSIONS_LIST as string[])),
+        v.nonEmpty(t('api-keys.create.form.permissions.required')),
+      ),
+    }),
+    initialValues: {
+      name: '',
+      permissions: API_KEY_PERMISSIONS_LIST,
+    },
+  });
+
+  return (
+    <div class="p-6 mt-12 pb-32 mx-auto max-w-xl w-full">
+      <div class="border-b pb-4 mb-6">
+        <h1 class="text-2xl font-bold">{t('api-keys.create.title')}</h1>
+        <p class="text-sm text-muted-foreground">{t('api-keys.create.description')}</p>
+      </div>
+
+      <Show when={getToken()}>
+        <div class="bg-card border p-6 rounded-md mt-6">
+          <h2 class="text-lg font-semibold mb-2">{t('api-keys.create.created.title')}</h2>
+          <p class="text-sm text-muted-foreground mb-4">{t('api-keys.create.created.description')}</p>
+
+          <TextFieldRoot class="flex items-center gap-2 space-y-0">
+            <TextField type="text" placeholder={t('api-keys.create.form.name.placeholder')} value={getToken() ?? ''} />
+            <CopyButton text={getToken() ?? ''} />
+          </TextFieldRoot>
+        </div>
+
+        <div class="flex justify-end mt-6">
+          <Button type="button" variant="secondary" as={A} href="/api-keys">
+            {t('api-keys.create.back')}
+          </Button>
+        </div>
+      </Show>
+
+      <Show when={!getToken()}>
+        <Form>
+          <Field name="name">
+            {(field, inputProps) => (
+
+              <TextFieldRoot class="flex flex-col mb-6">
+                <TextFieldLabel for="name">{t('api-keys.create.form.name.label')}</TextFieldLabel>
+                <TextField type="text" id="name" placeholder={t('api-keys.create.form.name.placeholder')} {...inputProps} autoFocus value={field.value} aria-invalid={Boolean(field.error)} />
+                {field.error && <div class="text-red-500 text-sm">{field.error}</div>}
+              </TextFieldRoot>
+
+            )}
+          </Field>
+
+          <Field name="permissions" type="string[]">
+            {field => (
+              <div>
+                <p class="text-sm font-bold">{t('api-keys.create.form.permissions.label')}</p>
+
+                <div class="p-6 pb-8 border rounded-md mt-2">
+                  <ApiKeyPermissionsPicker permissions={field.value ?? []} onChange={permissions => setValue(form, 'permissions', permissions)} />
+                </div>
+
+                {field.error && <div class="text-red-500 text-sm">{field.error}</div>}
+              </div>
+
+            )}
+          </Field>
+
+          <div class="flex justify-end mt-6">
+            <Button type="submit" isLoading={form.submitting}>
+              {t('api-keys.create.form.submit')}
+            </Button>
+          </div>
+        </Form>
+      </Show>
+    </div>
+  );
+};

apps/papra-client/src/modules/auth/auth.models.ts

@@ -1,4 +1,5 @@
 import type { Config } from '../config/config';
+import type { SsoProviderConfig } from './auth.types';
 import { get } from 'lodash-es';
 import { ssoProviders } from './auth.constants';
 
@@ -8,8 +9,15 @@ export function isAuthErrorWithCode({ error, code }: { error: unknown; code: str
 
 export const isEmailVerificationRequiredError = ({ error }: { error: unknown }) => isAuthErrorWithCode({ error, code: 'EMAIL_NOT_VERIFIED' });
 
-export function getEnabledSsoProviderConfigs({ config }: { config: Config }) {
-  const enabledSsoProviders = ssoProviders.filter(({ key }) => get(config, `auth.providers.${key}.isEnabled`));
+export function getEnabledSsoProviderConfigs({ config }: { config: Config }): SsoProviderConfig[] {
+  const enabledSsoProviders: SsoProviderConfig[] = [
+    ...ssoProviders.filter(({ key }) => get(config, `auth.providers.${key}.isEnabled`)),
+    ...config.auth.providers.customs.map(({ providerId, providerName, providerIconUrl }) => ({
+      key: providerId,
+      name: providerName,
+      icon: providerIconUrl ?? 'i-tabler-login-2',
+    })),
+  ];
 
   return enabledSsoProviders;
 }

apps/papra-client/src/modules/auth/auth.services.ts

@@ -1,5 +1,8 @@
-import { createAuthClient as createBetterAuthClient } from 'better-auth/solid';
+import type { Config } from '../config/config';
 
+import type { SsoProviderConfig } from './auth.types';
+import { genericOAuthClient } from 'better-auth/client/plugins';
+import { createAuthClient as createBetterAuthClient } from 'better-auth/solid';
 import { buildTimeConfig } from '../config/config';
 import { trackingServices } from '../tracking/tracking.services';
 import { createDemoAuthClient } from './auth.demo.services';
@@ -7,6 +10,9 @@ import { createDemoAuthClient } from './auth.demo.services';
 export function createAuthClient() {
   const client = createBetterAuthClient({
     baseURL: buildTimeConfig.baseApiUrl,
+    plugins: [
+      genericOAuthClient(),
+    ],
   });
 
   return {
@@ -38,3 +44,17 @@ export const {
 } = buildTimeConfig.isDemoMode
   ? createDemoAuthClient()
   : createAuthClient();
+
+export async function authWithProvider({ provider, config }: { provider: SsoProviderConfig; config: Config }) {
+  const isCustomProvider = config.auth.providers.customs.some(({ providerId }) => providerId === provider.key);
+
+  if (isCustomProvider) {
+    signIn.oauth2({
+      providerId: provider.key,
+      callbackURL: config.baseUrl,
+    });
+    return;
+  }
+
+  await signIn.social({ provider: provider.key as 'github' | 'google', callbackURL: config.baseUrl });
+}

apps/papra-client/src/modules/auth/auth.types.ts

@@ -1,3 +1,4 @@
 import type { ssoProviders } from './auth.constants';
 
-export type SsoProviderKey = (typeof ssoProviders)[number]['key'];
+export type SsoProviderKey = (typeof ssoProviders)[number]['key'] | string & {};
+export type SsoProviderConfig = { key: SsoProviderKey; name: string; icon: string };

apps/papra-client/src/modules/auth/components/legal-links.component.tsx

@@ -1,9 +1,9 @@
 import type { Component } from 'solid-js';
+import { A } from '@solidjs/router';
 import { useConfig } from '@/modules/config/config.provider';
 import { useI18n } from '@/modules/i18n/i18n.provider';
 import { createVitrineUrl } from '@/modules/shared/utils/urls';
 import { Button } from '@/modules/ui/components/button';
-import { A } from '@solidjs/router';
 
 export const AuthLegalLinks: Component = () => {
   const { config } = useConfig();

apps/papra-client/src/modules/auth/components/open-email-provider.component.tsx

@@ -1,6 +1,8 @@
+import type { Component, ComponentProps } from 'solid-js';
+import { splitProps } from 'solid-js';
+import { useI18n } from '@/modules/i18n/i18n.provider';
 import { cn } from '@/modules/shared/style/cn';
 import { Button } from '@/modules/ui/components/button';
-import { type Component, type ComponentProps, splitProps } from 'solid-js';
 
 const providers = [
   {
@@ -246,6 +248,7 @@ export function getEmailProvider({ email }: { email?: string }) {
 
 export const OpenEmailProvider: Component<{ email?: string } & ComponentProps<typeof Button>> = (props) => {
   const [local, rest] = splitProps(props, ['email', 'class']);
+  const { t } = useI18n();
 
   const { provider } = getEmailProvider({ email: local.email });
 
@@ -256,9 +259,7 @@ export const OpenEmailProvider: Component<{ email?: string } & ComponentProps<ty
   return (
     <Button as="a" href={provider.url} target="_blank" rel="noopener noreferrer" class={cn('w-full', local.class)} {...rest}>
       <div class="i-tabler-external-link mr-2 size-4" />
-      Open
-      {' '}
-      {provider.name}
+      {t('auth.email-provider.open', { provider: provider.name })}
     </Button>
   );
 };

apps/papra-client/src/modules/auth/components/sso-provider-button.component.tsx

@@ -1,19 +1,33 @@
 import type { Component } from 'solid-js';
+import { createSignal, Match, Switch } from 'solid-js';
 import { cn } from '@/modules/shared/style/cn';
 import { Button } from '@/modules/ui/components/button';
-import { createSignal } from 'solid-js';
 
-export const SsoProviderButton: Component<{ name: string; icon: string; onClick: () => Promise<void>; label: string }> = (props) => {
+export const SsoProviderButton: Component<{ name: string; icon?: string; onClick: () => Promise<void>; label: string }> = (props) => {
   const [getIsLoading, setIsLoading] = createSignal(false);
 
-  const navigateToProvider = async () => {
+  const onClick = async () => {
     setIsLoading(true);
     await props.onClick();
   };
 
   return (
-    <Button variant="secondary" class="block w-full flex items-center justify-center" onClick={navigateToProvider} disabled={getIsLoading()}>
-      <span class={cn(`mr-2 size-4.5 inline-block`, getIsLoading() ? 'i-tabler-loader-2 animate-spin' : props.icon)} />
+    <Button variant="secondary" class="block w-full flex items-center justify-center gap-2" onClick={onClick} disabled={getIsLoading()}>
+
+      <Switch>
+        <Match when={getIsLoading()}>
+          <span class="i-tabler-loader-2 animate-spin" />
+        </Match>
+
+        <Match when={props.icon?.startsWith('i-')}>
+          <span class={cn(`size-4.5`, props.icon)} />
+        </Match>
+
+        <Match when={props.icon}>
+          <img src={props.icon} alt={props.name} class="size-4.5" />
+        </Match>
+      </Switch>
+
       {props.label}
     </Button>
   );

apps/papra-client/src/modules/auth/middleware/protected-page.middleware.tsx

@@ -1,5 +1,6 @@
+import type { Component } from 'solid-js';
 import { Navigate } from '@solidjs/router';
-import { type Component, Suspense } from 'solid-js';
+import { Suspense } from 'solid-js';
 import { Dynamic } from 'solid-js/web';
 import { match } from 'ts-pattern';
 import { useSession } from '../auth.services';

apps/papra-client/src/modules/auth/pages/login.page.tsx

@@ -1,4 +1,8 @@
-import type { SsoProviderKey } from '../auth.types';
+import type { Component } from 'solid-js';
+import type { SsoProviderConfig } from '../auth.types';
+import { A, useNavigate } from '@solidjs/router';
+import { createSignal, For, Show } from 'solid-js';
+import * as v from 'valibot';
 import { useConfig } from '@/modules/config/config.provider';
 import { useI18n } from '@/modules/i18n/i18n.provider';
 import { createForm } from '@/modules/shared/form/form';
@@ -6,18 +10,16 @@ import { Button } from '@/modules/ui/components/button';
 import { Checkbox, CheckboxControl, CheckboxLabel } from '@/modules/ui/components/checkbox';
 import { Separator } from '@/modules/ui/components/separator';
 import { TextField, TextFieldLabel, TextFieldRoot } from '@/modules/ui/components/textfield';
-import { A, useNavigate } from '@solidjs/router';
-import { type Component, createSignal, For, Show } from 'solid-js';
-import * as v from 'valibot';
 import { AuthLayout } from '../../ui/layouts/auth-layout.component';
 import { getEnabledSsoProviderConfigs, isEmailVerificationRequiredError } from '../auth.models';
-import { signIn } from '../auth.services';
+import { authWithProvider, signIn } from '../auth.services';
 import { AuthLegalLinks } from '../components/legal-links.component';
 import { SsoProviderButton } from '../components/sso-provider-button.component';
 
 export const EmailLoginForm: Component = () => {
   const navigate = useNavigate();
   const { config } = useConfig();
+  const { t } = useI18n();
 
   const { form, Form, Field } = createForm({
     onSubmit: async ({ email, password, rememberMe }) => {
@@ -35,12 +37,12 @@ export const EmailLoginForm: Component = () => {
       email: v.pipe(
         v.string(),
         v.trim(),
-        v.nonEmpty('Please enter your email address'),
-        v.email('This is not a valid email address'),
+        v.nonEmpty(t('auth.login.form.email.required')),
+        v.email(t('auth.login.form.email.invalid')),
       ),
       password: v.pipe(
-        v.string('Password is required'),
-        v.nonEmpty('Please enter your password'),
+        v.string(t('auth.login.form.password.required')),
+        v.nonEmpty(t('auth.login.form.password.required')),
       ),
       rememberMe: v.boolean(),
     }),
@@ -54,8 +56,8 @@ export const EmailLoginForm: Component = () => {
       <Field name="email">
         {(field, inputProps) => (
           <TextFieldRoot class="flex flex-col gap-1 mb-4">
-            <TextFieldLabel for="email">Email</TextFieldLabel>
-            <TextField type="email" id="email" placeholder="Eg. ada@papra.app" {...inputProps} autoFocus value={field.value} aria-invalid={Boolean(field.error)} />
+            <TextFieldLabel for="email">{t('auth.login.form.email.label')}</TextFieldLabel>
+            <TextField type="email" id="email" placeholder={t('auth.login.form.email.placeholder')} {...inputProps} autoFocus value={field.value} aria-invalid={Boolean(field.error)} />
             {field.error && <div class="text-red-500 text-sm">{field.error}</div>}
           </TextFieldRoot>
         )}
@@ -64,9 +66,9 @@ export const EmailLoginForm: Component = () => {
       <Field name="password">
         {(field, inputProps) => (
           <TextFieldRoot class="flex flex-col gap-1 mb-4">
-            <TextFieldLabel for="password">Password</TextFieldLabel>
+            <TextFieldLabel for="password">{t('auth.login.form.password.label')}</TextFieldLabel>
 
-            <TextField type="password" id="password" placeholder="Your password" {...inputProps} value={field.value} aria-invalid={Boolean(field.error)} />
+            <TextField type="password" id="password" placeholder={t('auth.login.form.password.placeholder')} {...inputProps} value={field.value} aria-invalid={Boolean(field.error)} />
             {field.error && <div class="text-red-500 text-sm">{field.error}</div>}
           </TextFieldRoot>
         )}
@@ -78,18 +80,18 @@ export const EmailLoginForm: Component = () => {
             <Checkbox class="flex items-center gap-2" defaultChecked={field.value}>
               <CheckboxControl inputProps={inputProps} />
               <CheckboxLabel class="text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70">
-                Remember me
+                {t('auth.login.form.remember-me.label')}
               </CheckboxLabel>
             </Checkbox>
           )}
         </Field>
 
         <Button variant="link" as={A} class="inline p-0! h-auto" href="/request-password-reset">
-          Forgot password?
+          {t('auth.login.form.forgot-password.label')}
         </Button>
       </div>
 
-      <Button type="submit" class="w-full">Login</Button>
+      <Button type="submit" class="w-full">{t('auth.login.form.submit')}</Button>
 
       <div class="text-red-500 text-sm mt-4">{form.response.message}</div>
 
@@ -103,8 +105,8 @@ export const LoginPage: Component = () => {
 
   const [getShowEmailLogin, setShowEmailLogin] = createSignal(false);
 
-  const loginWithProvider = async (provider: { key: SsoProviderKey }) => {
-    await signIn.social({ provider: provider.key, callbackURL: config.baseUrl });
+  const loginWithProvider = async (provider: SsoProviderConfig) => {
+    await authWithProvider({ provider, config });
   };
 
   const getHasSsoProviders = () => getEnabledSsoProviderConfigs({ config }).length > 0;

apps/papra-client/src/modules/auth/pages/register.page.tsx

@@ -1,22 +1,24 @@
-import type { ssoProviders } from '../auth.constants';
+import type { Component } from 'solid-js';
+import type { SsoProviderConfig } from '../auth.types';
+import { A, useNavigate } from '@solidjs/router';
+import { createSignal, For, Show } from 'solid-js';
+import * as v from 'valibot';
 import { useConfig } from '@/modules/config/config.provider';
+import { useI18n } from '@/modules/i18n/i18n.provider';
 import { createForm } from '@/modules/shared/form/form';
 import { Button } from '@/modules/ui/components/button';
 import { Separator } from '@/modules/ui/components/separator';
 import { TextField, TextFieldLabel, TextFieldRoot } from '@/modules/ui/components/textfield';
-import { A, useNavigate } from '@solidjs/router';
-import { type Component, createSignal, For, Show } from 'solid-js';
-import * as v from 'valibot';
 import { AuthLayout } from '../../ui/layouts/auth-layout.component';
 import { getEnabledSsoProviderConfigs } from '../auth.models';
-import { signIn, signUp } from '../auth.services';
+import { authWithProvider, signUp } from '../auth.services';
 import { AuthLegalLinks } from '../components/legal-links.component';
 import { SsoProviderButton } from '../components/sso-provider-button.component';
 
 export const EmailRegisterForm: Component = () => {
   const { config } = useConfig();
   const navigate = useNavigate();
-
+  const { t } = useI18n();
   const { form, Form, Field } = createForm({
     onSubmit: async ({ email, password, name }) => {
       const { error } = await signUp.email({
@@ -41,19 +43,19 @@ export const EmailRegisterForm: Component = () => {
       email: v.pipe(
         v.string(),
         v.trim(),
-        v.nonEmpty('Please enter an email address'),
-        v.email('This is not a valid email address'),
+        v.nonEmpty(t('auth.register.form.email.required')),
+        v.email(t('auth.register.form.email.invalid')),
       ),
       password: v.pipe(
-        v.string('Password is required'),
-        v.nonEmpty('Please enter a password'),
-        v.minLength(8, 'Password must be at least 8 characters'),
-        v.maxLength(128, 'Password must be at most 128 characters'),
+        v.string(),
+        v.nonEmpty(t('auth.register.form.password.required')),
+        v.minLength(8, t('auth.register.form.password.min-length', { minLength: 8 })),
+        v.maxLength(128, t('auth.register.form.password.max-length', { maxLength: 128 })),
       ),
       name: v.pipe(
-        v.string('Name is required'),
-        v.nonEmpty('Please enter a name'),
-        v.maxLength(64, 'Name must be at most 64 characters'),
+        v.string(t('auth.register.form.name.label')),
+        v.nonEmpty(t('auth.register.form.name.required')),
+        v.maxLength(64, t('auth.register.form.name.max-length', { maxLength: 64 })),
       ),
     }),
   });
@@ -63,8 +65,8 @@ export const EmailRegisterForm: Component = () => {
       <Field name="email">
         {(field, inputProps) => (
           <TextFieldRoot class="flex flex-col gap-1 mb-4">
-            <TextFieldLabel for="email">Email</TextFieldLabel>
-            <TextField type="email" id="email" placeholder="Eg. ada@papra.app" {...inputProps} autoFocus value={field.value} aria-invalid={Boolean(field.error)} />
+            <TextFieldLabel for="email">{t('auth.register.form.email.label')}</TextFieldLabel>
+            <TextField type="email" id="email" placeholder={t('auth.register.form.email.placeholder')} {...inputProps} autoFocus value={field.value} aria-invalid={Boolean(field.error)} />
             {field.error && <div class="text-red-500 text-sm">{field.error}</div>}
           </TextFieldRoot>
         )}
@@ -73,8 +75,8 @@ export const EmailRegisterForm: Component = () => {
       <Field name="name">
         {(field, inputProps) => (
           <TextFieldRoot class="flex flex-col gap-1 mb-4">
-            <TextFieldLabel for="name">Your full name</TextFieldLabel>
-            <TextField type="text" id="name" placeholder="Eg. Ada Lovelace" {...inputProps} value={field.value} aria-invalid={Boolean(field.error)} />
+            <TextFieldLabel for="name">{t('auth.register.form.name.label')}</TextFieldLabel>
+            <TextField type="text" id="name" placeholder={t('auth.register.form.name.placeholder')} {...inputProps} value={field.value} aria-invalid={Boolean(field.error)} />
             {field.error && <div class="text-red-500 text-sm">{field.error}</div>}
           </TextFieldRoot>
         )}
@@ -83,15 +85,15 @@ export const EmailRegisterForm: Component = () => {
       <Field name="password">
         {(field, inputProps) => (
           <TextFieldRoot class="flex flex-col gap-1 mb-4">
-            <TextFieldLabel for="password">Password</TextFieldLabel>
+            <TextFieldLabel for="password">{t('auth.register.form.password.label')}</TextFieldLabel>
 
-            <TextField type="password" id="password" placeholder="Your password" {...inputProps} value={field.value} aria-invalid={Boolean(field.error)} />
+            <TextField type="password" id="password" placeholder={t('auth.register.form.password.placeholder')} {...inputProps} value={field.value} aria-invalid={Boolean(field.error)} />
             {field.error && <div class="text-red-500 text-sm">{field.error}</div>}
           </TextFieldRoot>
         )}
       </Field>
 
-      <Button type="submit" class="w-full">Register</Button>
+      <Button type="submit" class="w-full">{t('auth.register.form.submit')}</Button>
 
       <div class="text-red-500 text-sm mt-4">{form.response.message}</div>
 
@@ -101,6 +103,7 @@ export const EmailRegisterForm: Component = () => {
 
 export const RegisterPage: Component = () => {
   const { config } = useConfig();
+  const { t } = useI18n();
 
   if (!config.auth.isRegistrationEnabled) {
     return (
@@ -108,17 +111,17 @@ export const RegisterPage: Component = () => {
         <div class="flex items-center justify-center h-full p-6 sm:pb-32">
           <div class="max-w-sm w-full">
             <h1 class="text-xl font-bold">
-              Registration is disabled
+              {t('auth.register.registration-disabled.title')}
             </h1>
             <p class="text-muted-foreground mt-1 mb-4">
-              The creation of new accounts is currently disabled on this instance of Papra. Only users with existing accounts can log in. If you think this is a mistake, please contact the administrator of this instance.
+              {t('auth.register.registration-disabled.description')}
             </p>
 
             <p class="text-muted-foreground mt-4">
-              Already have an account?
+              {t('auth.register.have-account')}
               {' '}
               <Button variant="link" as={A} class="inline px-0" href="/login">
-                Login
+                {t('auth.register.login')}
               </Button>
             </p>
 
@@ -130,8 +133,8 @@ export const RegisterPage: Component = () => {
 
   const [getShowEmailRegister, setShowEmailRegister] = createSignal(false);
 
-  const registerWithProvider = async (provider: typeof ssoProviders[number]) => {
-    await signIn.social({ provider: provider.key });
+  const registerWithProvider = async (provider: SsoProviderConfig) => {
+    await authWithProvider({ provider, config });
   };
 
   const getHasSsoProviders = () => getEnabledSsoProviderConfigs({ config }).length > 0;
@@ -141,10 +144,10 @@ export const RegisterPage: Component = () => {
       <div class="flex items-center justify-center h-full p-6 sm:pb-32">
         <div class="max-w-sm w-full">
           <h1 class="text-xl font-bold">
-            Register to Papra
+            {t('auth.register.title')}
           </h1>
           <p class="text-muted-foreground mt-1 mb-4">
-            Enter your email or use social login to create your Papra account.
+            {t('auth.register.description')}
           </p>
 
           {getShowEmailRegister() || !getHasSsoProviders()
@@ -152,7 +155,7 @@ export const RegisterPage: Component = () => {
             : (
                 <Button onClick={() => setShowEmailRegister(true)} class="w-full">
                   <div class="i-tabler-mail mr-2 size-4.5" />
-                  Register with email
+                  {t('auth.register.register-with-email')}
                 </Button>
               )}
 
@@ -162,17 +165,22 @@ export const RegisterPage: Component = () => {
             <div class="flex flex-col gap-2">
               <For each={getEnabledSsoProviderConfigs({ config })}>
                 {provider => (
-                  <SsoProviderButton name={provider.name} icon={provider.icon} onClick={() => registerWithProvider(provider)} label={`Register with ${provider.name}`} />
+                  <SsoProviderButton
+                    name={provider.name}
+                    icon={provider.icon}
+                    onClick={() => registerWithProvider(provider)}
+                    label={t('auth.register.register-with-provider', { provider: provider.name })}
+                  />
                 )}
               </For>
             </div>
           </Show>
 
           <p class="text-muted-foreground mt-4">
-            Already have an account?
+            {t('auth.register.have-account')}
             {' '}
             <Button variant="link" as={A} class="inline px-0" href="/login">
-              Login
+              {t('auth.register.login')}
             </Button>
           </p>
 

apps/papra-client/src/modules/auth/pages/request-password-reset.page.tsx

@@ -1,24 +1,28 @@
+import type { Component } from 'solid-js';
+import { buildUrl } from '@corentinth/chisels';
+import { A, useNavigate } from '@solidjs/router';
+import { createSignal, onMount } from 'solid-js';
+import * as v from 'valibot';
 import { useConfig } from '@/modules/config/config.provider';
+import { useI18n } from '@/modules/i18n/i18n.provider';
 import { createForm } from '@/modules/shared/form/form';
 import { Button } from '@/modules/ui/components/button';
 import { TextField, TextFieldLabel, TextFieldRoot } from '@/modules/ui/components/textfield';
-import { buildUrl } from '@corentinth/chisels';
-import { A, useNavigate } from '@solidjs/router';
-import { type Component, createSignal, onMount } from 'solid-js';
-import * as v from 'valibot';
 import { AuthLayout } from '../../ui/layouts/auth-layout.component';
 import { forgetPassword } from '../auth.services';
 import { OpenEmailProvider } from '../components/open-email-provider.component';
 
 export const ResetPasswordForm: Component<{ onSubmit: (args: { email: string }) => Promise<void> }> = (props) => {
+  const { t } = useI18n();
+
   const { form, Form, Field } = createForm({
     onSubmit: props.onSubmit,
     schema: v.object({
       email: v.pipe(
         v.string(),
         v.trim(),
-        v.nonEmpty('Please enter your email address'),
-        v.email('This is not a valid email address'),
+        v.nonEmpty(t('auth.request-password-reset.form.email.required')),
+        v.email(t('auth.request-password-reset.form.email.invalid')),
       ),
     }),
   });
@@ -28,15 +32,15 @@ export const ResetPasswordForm: Component<{ onSubmit: (args: { email: string })
       <Field name="email">
         {(field, inputProps) => (
           <TextFieldRoot class="flex flex-col gap-1 mb-4">
-            <TextFieldLabel for="email">Email</TextFieldLabel>
-            <TextField type="email" id="email" placeholder="Eg. ada@papra.app" {...inputProps} autoFocus value={field.value} aria-invalid={Boolean(field.error)} />
+            <TextFieldLabel for="email">{t('auth.request-password-reset.form.email.label')}</TextFieldLabel>
+            <TextField type="email" id="email" placeholder={t('auth.request-password-reset.form.email.placeholder')} {...inputProps} autoFocus value={field.value} aria-invalid={Boolean(field.error)} />
             {field.error && <div class="text-red-500 text-sm">{field.error}</div>}
           </TextFieldRoot>
         )}
       </Field>
 
       <Button type="submit" class="w-full">
-        Request password reset
+        {t('auth.request-password-reset.form.submit')}
       </Button>
 
       <div class="text-red-500 text-sm mt-2">{form.response.message}</div>
@@ -49,6 +53,7 @@ export const RequestPasswordResetPage: Component = () => {
   const [getHasPasswordResetBeenRequested, setHasPasswordResetBeenRequested] = createSignal(false);
   const [getEmail, setEmail] = createSignal<string | undefined>(undefined);
 
+  const { t } = useI18n();
   const { config } = useConfig();
   const navigate = useNavigate();
 
@@ -80,14 +85,14 @@ export const RequestPasswordResetPage: Component = () => {
       <div class="flex items-center justify-center p-6 sm:pb-32">
         <div class="max-w-sm w-full">
           <h1 class="text-xl font-bold">
-            Reset your password
+            {t('auth.request-password-reset.title')}
           </h1>
 
           {getHasPasswordResetBeenRequested()
             ? (
                 <>
                   <div class="text-muted-foreground mt-1 mb-4">
-                    If an account exists for this email, we've sent you an email to reset your password.
+                    {t('auth.request-password-reset.requested')}
                   </div>
 
                   <OpenEmailProvider email={getEmail()} variant="secondary" class="w-full mb-4" />
@@ -96,7 +101,7 @@ export const RequestPasswordResetPage: Component = () => {
             : (
                 <>
                   <p class="text-muted-foreground mt-1 mb-4">
-                    Enter your email to reset your password.
+                    {t('auth.request-password-reset.description')}
                   </p>
 
                   <ResetPasswordForm onSubmit={onPasswordResetRequested} />
@@ -105,7 +110,7 @@ export const RequestPasswordResetPage: Component = () => {
 
           <Button as={A} href="/login" class="w-full" variant={getHasPasswordResetBeenRequested() ? 'default' : 'ghost'}>
             <div class="i-tabler-arrow-left mr-2 size-4" />
-            Back to login
+            {t('auth.request-password-reset.back-to-login')}
           </Button>
         </div>
       </div>

apps/papra-client/src/modules/auth/pages/reset-password.page.tsx

@@ -1,23 +1,26 @@
+import type { Component } from 'solid-js';
+import { A, Navigate, useNavigate, useSearchParams } from '@solidjs/router';
+import { createSignal, onMount } from 'solid-js';
+import * as v from 'valibot';
 import { useConfig } from '@/modules/config/config.provider';
+import { useI18n } from '@/modules/i18n/i18n.provider';
 import { createForm } from '@/modules/shared/form/form';
 import { Button } from '@/modules/ui/components/button';
 import { TextField, TextFieldLabel, TextFieldRoot } from '@/modules/ui/components/textfield';
-import { A, Navigate, useNavigate, useSearchParams } from '@solidjs/router';
-import { type Component, createSignal } from 'solid-js';
-import { onMount } from 'solid-js';
-import * as v from 'valibot';
 import { AuthLayout } from '../../ui/layouts/auth-layout.component';
 import { resetPassword } from '../auth.services';
 
 export const ResetPasswordForm: Component<{ onSubmit: (args: { newPassword: string }) => Promise<void> }> = (props) => {
+  const { t } = useI18n();
+
   const { form, Form, Field } = createForm({
     onSubmit: props.onSubmit,
     schema: v.object({
       newPassword: v.pipe(
         v.string(),
-        v.nonEmpty('Please enter your new password'),
-        v.minLength(8, 'Password must be at least 8 characters long'),
-        v.maxLength(128, 'Password must be at most 128 characters long'),
+        v.nonEmpty(t('auth.reset-password.form.new-password.required')),
+        v.minLength(8, t('auth.reset-password.form.new-password.min-length', { minLength: 8 })),
+        v.maxLength(128, t('auth.reset-password.form.new-password.max-length', { maxLength: 128 })),
       ),
     }),
   });
@@ -27,15 +30,15 @@ export const ResetPasswordForm: Component<{ onSubmit: (args: { newPassword: stri
       <Field name="newPassword">
         {(field, inputProps) => (
           <TextFieldRoot class="flex flex-col gap-1 mb-4">
-            <TextFieldLabel for="newPassword">New password</TextFieldLabel>
-            <TextField type="password" id="newPassword" placeholder="Your new password" {...inputProps} autoFocus value={field.value} aria-invalid={Boolean(field.error)} />
+            <TextFieldLabel for="newPassword">{t('auth.reset-password.form.new-password.label')}</TextFieldLabel>
+            <TextField type="password" id="newPassword" placeholder={t('auth.reset-password.form.new-password.placeholder')} {...inputProps} autoFocus value={field.value} aria-invalid={Boolean(field.error)} />
             {field.error && <div class="text-red-500 text-sm">{field.error}</div>}
           </TextFieldRoot>
         )}
       </Field>
 
       <Button type="submit" class="w-full">
-        Reset password
+        {t('auth.reset-password.form.submit')}
       </Button>
 
       <div class="text-red-500 text-sm mt-2">{form.response.message}</div>
@@ -49,6 +52,8 @@ export const ResetPasswordPage: Component = () => {
   const [searchParams] = useSearchParams();
   const token = searchParams.token;
 
+  const { t } = useI18n();
+
   if (!token || typeof token !== 'string') {
     return <Navigate href="/login" />;
   }
@@ -80,18 +85,18 @@ export const ResetPasswordPage: Component = () => {
       <div class="flex items-center justify-center p-6 sm:pb-32">
         <div class="max-w-sm w-full">
           <h1 class="text-xl font-bold">
-            Reset your password
+            {t('auth.reset-password.title')}
           </h1>
 
           {getHasPasswordBeenReset()
             ? (
                 <>
                   <div class="text-muted-foreground mt-1 mb-4">
-                    Your password has been reset.
+                    {t('auth.reset-password.reset')}
                   </div>
 
                   <Button as={A} href="/login" class="w-full">
-                    Go to login
+                    {t('auth.reset-password.back-to-login')}
                     <div class="i-tabler-login-2 ml-2 size-4" />
                   </Button>
                 </>
@@ -99,7 +104,7 @@ export const ResetPasswordPage: Component = () => {
             : (
                 <>
                   <p class="text-muted-foreground mt-1 mb-4">
-                    Enter your new password.
+                    {t('auth.reset-password.description')}
                   </p>
 
                   <ResetPasswordForm onSubmit={onPasswordResetRequested} />

apps/papra-client/src/modules/config/config.provider.tsx

@@ -1,11 +1,12 @@
 import type { ParentComponent } from 'solid-js';
+import type { Config, RuntimePublicConfig } from './config';
 import { createQuery } from '@tanstack/solid-query';
 import { merge } from 'lodash-es';
 import { createContext, Match, Switch, useContext } from 'solid-js';
 import { Button } from '../ui/components/button';
 import { EmptyState } from '../ui/components/empty';
 import { createToast } from '../ui/components/sonner';
-import { buildTimeConfig, type Config, type RuntimePublicConfig } from './config';
+import { buildTimeConfig } from './config';
 import { fetchPublicConfig } from './config.services';
 
 const ConfigContext = createContext<{

apps/papra-client/src/modules/config/config.ts

@@ -18,6 +18,11 @@ export const buildTimeConfig = {
     providers: {
       github: { isEnabled: asBoolean(import.meta.env.VITE_AUTH_PROVIDERS_GITHUB_IS_ENABLED, false) },
       google: { isEnabled: asBoolean(import.meta.env.VITE_AUTH_PROVIDERS_GOOGLE_IS_ENABLED, false) },
+      customs: [] as {
+        providerId: string;
+        providerName: string;
+        providerIconUrl: string;
+      }[],
     },
   },
   documents: {

apps/papra-client/src/modules/demo/demo-api-mock.ts

@@ -1,10 +1,31 @@
+import type { ApiKey } from '../api-keys/api-keys.types';
+import type { Webhook } from '../webhooks/webhooks.types';
 import { get } from 'lodash-es';
 import { FetchError } from 'ofetch';
 import { createRouter } from 'radix3';
 import { defineHandler } from './demo-api-mock.models';
-import { documentFileStorage, documentStorage, organizationStorage, tagDocumentStorage, tagStorage } from './demo.storage';
+import {
+  apiKeyStorage,
+  documentFileStorage,
+  documentStorage,
+  organizationStorage,
+  tagDocumentStorage,
+  taggingRuleStorage,
+  tagStorage,
+  webhooksStorage,
+} from './demo.storage';
 import { findMany, getValues } from './demo.storage.models';
 
+const corpus = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+
+function randomString({ length = 10 }: { length?: number } = {}) {
+  return Array.from({ length }, () => corpus[Math.floor(Math.random() * corpus.length)]).join('');
+}
+
+function createId({ prefix }: { prefix: string }) {
+  return `${prefix}_${randomString({ length: 24 })}`;
+}
+
 function assert(condition: unknown, { message = 'Error', status }: { message?: string; status?: number } = {}): asserts condition {
   if (!condition) {
     throw Object.assign(new FetchError(message), { status });
@@ -114,12 +135,13 @@ const inMemoryApiMock: Record<string, { handler: any }> = {
       assert(file, { status: 400 });
 
       const document = {
-        id: `doc_${Math.random().toString(36).slice(2)}`,
+        id: createId({ prefix: 'doc' }),
         organizationId,
         name: file.name,
         originalName: file.name,
         originalSize: file.size,
         mimeType: file.type,
+        content: '',
         createdAt: new Date(),
         updatedAt: new Date(),
         tags: [],
@@ -130,10 +152,21 @@ const inMemoryApiMock: Record<string, { handler: any }> = {
       await documentFileStorage.setItem(key, await serializeFile(file));
       await documentStorage.setItem(key, document);
 
+      // Simulate a slow response
+      await new Promise(resolve => setTimeout(resolve, 500));
+
       return { document };
     },
   }),
 
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/customer-portal',
+    method: 'GET',
+    handler: async () => {
+      throw Object.assign(new FetchError('Not available in demo'), { status: 501 });
+    },
+  }),
+
   ...defineHandler({
     path: '/api/organizations/:organizationId/documents/statistics',
     method: 'GET',
@@ -299,7 +332,7 @@ const inMemoryApiMock: Record<string, { handler: any }> = {
       assert(organization, { status: 403 });
 
       const tag = {
-        id: `tag_${Math.random().toString(36).slice(2)}`,
+        id: createId({ prefix: 'tag' }),
         organizationId,
         name: get(body, 'name'),
         color: get(body, 'color'),
@@ -361,7 +394,7 @@ const inMemoryApiMock: Record<string, { handler: any }> = {
       assert(tagId, { status: 400 });
 
       const tagDocument = {
-        id: `tagDoc_${Math.random().toString(36).slice(2)}`,
+        id: createId({ prefix: 'tagDoc' }),
         tagId,
         documentId,
         createdAt: new Date(),
@@ -400,7 +433,7 @@ const inMemoryApiMock: Record<string, { handler: any }> = {
     method: 'POST',
     handler: async ({ body }) => {
       const organization = {
-        id: `org_${Math.random().toString(36).slice(2)}`,
+        id: createId({ prefix: 'org' }),
         name: get(body, 'name'),
         createdAt: new Date(),
         updatedAt: new Date(),
@@ -449,6 +482,255 @@ const inMemoryApiMock: Record<string, { handler: any }> = {
     },
   }),
 
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/tagging-rules',
+    method: 'GET',
+    handler: async ({ params: { organizationId } }) => {
+      const taggingRules = await findMany(taggingRuleStorage, taggingRule => taggingRule.organizationId === organizationId);
+
+      return { taggingRules };
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/tagging-rules',
+    method: 'POST',
+    handler: async ({ params: { organizationId }, body }) => {
+      const taggingRule = {
+        id: createId({ prefix: 'tr' }),
+        organizationId,
+        name: get(body, 'name'),
+        description: get(body, 'description'),
+        conditions: get(body, 'conditions'),
+        actions: get(body, 'tagIds').map((tagId: string) => ({ tagId })),
+        createdAt: new Date(),
+        updatedAt: new Date(),
+      };
+
+      await taggingRuleStorage.setItem(taggingRule.id, taggingRule);
+
+      return { taggingRule };
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/tagging-rules/:taggingRuleId',
+    method: 'GET',
+    handler: async ({ params: { taggingRuleId } }) => {
+      const taggingRule = await taggingRuleStorage.getItem(taggingRuleId);
+
+      assert(taggingRule, { status: 404 });
+
+      return { taggingRule };
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/tagging-rules/:taggingRuleId',
+    method: 'DELETE',
+    handler: async ({ params: { taggingRuleId } }) => {
+      await taggingRuleStorage.removeItem(taggingRuleId);
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/tagging-rules/:taggingRuleId',
+    method: 'PUT',
+    handler: async ({ params: { taggingRuleId }, body }) => {
+      const taggingRule = await taggingRuleStorage.getItem(taggingRuleId);
+
+      assert(taggingRule, { status: 404 });
+
+      await taggingRuleStorage.setItem(taggingRuleId, Object.assign(taggingRule, body, { updatedAt: new Date() }));
+
+      return { taggingRule };
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/documents/trash',
+    method: 'DELETE',
+    handler: async ({ params: { organizationId } }) => {
+      const documents = await findMany(documentStorage, document => document.organizationId === organizationId && Boolean(document.deletedAt));
+
+      await Promise.all(documents.map(document => documentStorage.removeItem(`${organizationId}:${document.id}`)));
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/documents/trash/:documentId',
+    method: 'DELETE',
+    handler: async ({ params: { organizationId, documentId } }) => {
+      const key = `${organizationId}:${documentId}`;
+
+      await documentStorage.removeItem(key);
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/members',
+    method: 'GET',
+    handler: async ({ params: { organizationId } }) => {
+      return {
+        members: [{
+          id: 'mem_1',
+          user: {
+            id: 'usr_1',
+            email: 'jane.doe@papra.app',
+            name: 'Jane Doe',
+          },
+          role: 'owner',
+          organizationId,
+        }],
+      };
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/members/invitations',
+    method: 'POST',
+    handler: async () => {
+      throw Object.assign(new FetchError('Not available in demo'), {
+        status: 501,
+        data: {
+          error: {
+            message: 'This feature is not available in demo',
+            code: 'demo.not_available',
+          },
+        },
+      });
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/members/me',
+    method: 'GET',
+    handler: async ({ params: { organizationId } }) => {
+      return {
+        member: {
+          id: 'mem_1',
+          role: 'owner',
+          organizationId,
+        },
+      };
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/api-keys',
+    method: 'GET',
+    handler: async () => {
+      const apiKeys = await getValues(apiKeyStorage);
+
+      return { apiKeys };
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/api-keys',
+    method: 'POST',
+    handler: async ({ body }) => {
+      const token = `ppapi_${randomString({ length: 64 })}`;
+
+      const apiKey = {
+        id: createId({ prefix: 'apiKey' }),
+        name: get(body, 'name'),
+        permissions: get(body, 'permissions'),
+        organizationIds: get(body, 'organizationIds'),
+        allOrganizations: get(body, 'allOrganizations'),
+        expiresAt: get(body, 'expiresAt'),
+        createdAt: new Date(),
+        updatedAt: new Date(),
+        prefix: token.slice(0, 11),
+      } as ApiKey;
+
+      await apiKeyStorage.setItem(apiKey.id, apiKey);
+
+      return { apiKey, token };
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/api-keys/:apiKeyId',
+    method: 'DELETE',
+    handler: async ({ params: { apiKeyId } }) => {
+      await apiKeyStorage.removeItem(apiKeyId);
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/invitations/count',
+    method: 'GET',
+    handler: async () => ({ pendingInvitationsCount: 0 }),
+  }),
+
+  ...defineHandler({
+    path: '/api/invitations',
+    method: 'GET',
+    handler: async () => ({ invitations: [] }),
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/webhooks',
+    method: 'GET',
+    handler: async ({ params: { organizationId } }) => {
+      const webhooks = await findMany(webhooksStorage, webhook => webhook.organizationId === organizationId);
+
+      return { webhooks };
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/webhooks',
+    method: 'POST',
+    handler: async ({ params: { organizationId }, body }) => {
+      const webhook: Webhook = {
+        id: createId({ prefix: 'webhook' }),
+        organizationId,
+        name: get(body, 'name'),
+        url: get(body, 'url'),
+        enabled: true,
+        events: get(body, 'events'),
+        createdAt: new Date(),
+        updatedAt: new Date(),
+      };
+
+      await webhooksStorage.setItem(webhook.id, webhook);
+
+      return { webhook };
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/webhooks/:webhookId',
+    method: 'GET',
+    handler: async ({ params: { webhookId } }) => {
+      const webhook = await webhooksStorage.getItem(webhookId);
+      return { webhook };
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/webhooks/:webhookId',
+    method: 'DELETE',
+    handler: async ({ params: { webhookId } }) => {
+      await webhooksStorage.removeItem(webhookId);
+    },
+  }),
+
+  ...defineHandler({
+    path: '/api/organizations/:organizationId/webhooks/:webhookId',
+    method: 'PUT',
+    handler: async ({ params: { webhookId }, body }) => {
+      const webhook = await webhooksStorage.getItem(webhookId);
+
+      assert(webhook, { status: 404 });
+
+      await webhooksStorage.setItem(webhookId, Object.assign(webhook, body, { updatedAt: new Date() }));
+
+      return { webhook };
+    },
+  }),
 };
 
 export const router = createRouter({ routes: inMemoryApiMock, strictTrailingSlash: false });

apps/papra-client/src/modules/demo/demo-http-client.ts

@@ -4,7 +4,7 @@ import type { HttpClientOptions, ResponseType } from '../shared/http/http-client
 import { joinUrlPaths } from '@corentinth/chisels';
 import { router } from './demo-api-mock';
 
-export async function demoHttpClient<A, R extends ResponseType = 'json'>(options: HttpClientOptions<R>): Promise<MappedResponseType< R, A>> {
+export async function demoHttpClient<A, R extends ResponseType = 'json'>(options: HttpClientOptions<R>): Promise<MappedResponseType<R, A>> {
   const path = `/${joinUrlPaths(options.method ?? 'GET', options.url)}`;
   const matchedRoute = router.lookup(path);
 

apps/papra-client/src/modules/demo/demo.provider.tsx

@@ -1,5 +1,6 @@
-import { useNavigate } from '@solidjs/router';
-import { type Component, createSignal } from 'solid-js';
+import type { Component } from 'solid-js';
+import { A, useNavigate } from '@solidjs/router';
+import { createSignal } from 'solid-js';
 import { Portal } from 'solid-js/web';
 import { buildTimeConfig } from '../config/config';
 import { useI18n } from '../i18n/i18n.provider';
@@ -9,7 +10,7 @@ import { clearDemoStorage } from './demo.storage';
 export const DemoIndicator: Component = () => {
   const [getIsMinified, setIsMinified] = createSignal(false);
   const navigate = useNavigate();
-  const { t } = useI18n();
+  const { t, te } = useI18n();
 
   const clearDemo = async () => {
     await clearDemoStorage();
@@ -33,6 +34,9 @@ export const DemoIndicator: Component = () => {
                   <p class="text-sm">
                     {t('demo.popup.description')}
                   </p>
+                  <p class="text-sm mt-2">
+                    {te('demo.popup.discord', { discordLink: <A href="https://papra.app/discord" target="_blank" rel="noopener noreferrer" class="underline font-bold">{t('demo.popup.discord-link-label')}</A> })}
+                  </p>
                   <div class="flex justify-end mt-4 gap-2">
                     <Button variant="secondary" onClick={clearDemo} size="sm" class="text-primary shadow-none">
                       {t('demo.popup.reset')}

apps/papra-client/src/modules/demo/demo.storage.models.ts

@@ -8,7 +8,7 @@ export async function getValues<T extends StorageValue>(storage: Storage<T>): Pr
   return values;
 }
 
-export async function findOne<T extends StorageValue>(storage: Storage<T>, predicate: (value: T) => boolean): Promise< T | null> {
+export async function findOne<T extends StorageValue>(storage: Storage<T>, predicate: (value: T) => boolean): Promise<T | null> {
   const values = await getValues(storage);
   const found = values.find(predicate);
 

apps/papra-client/src/modules/demo/demo.storage.ts

@@ -1,6 +1,9 @@
+import type { ApiKey } from '../api-keys/api-keys.types';
 import type { Document } from '../documents/documents.types';
 import type { Organization } from '../organizations/organizations.types';
+import type { TaggingRule } from '../tagging-rules/tagging-rules.types';
 import type { Tag } from '../tags/tags.types';
+import type { Webhook } from '../webhooks/webhooks.types';
 import { createStorage, prefixStorage } from 'unstorage';
 import localStorageDriver from 'unstorage/drivers/localstorage';
 import { trackingServices } from '../tracking/tracking.services';
@@ -14,6 +17,9 @@ export const documentStorage = prefixStorage<Document>(storage, 'documents');
 export const documentFileStorage = prefixStorage(storage, 'documentFiles');
 export const tagStorage = prefixStorage<Omit<Tag, 'documentsCount'>>(storage, 'tags');
 export const tagDocumentStorage = prefixStorage<{ documentId: string; tagId: string; id: string }>(storage, 'tagDocuments');
+export const taggingRuleStorage = prefixStorage<TaggingRule>(storage, 'taggingRules');
+export const apiKeyStorage = prefixStorage<ApiKey>(storage, 'apiKeys');
+export const webhooksStorage = prefixStorage<Webhook>(storage, 'webhooks');
 
 export async function clearDemoStorage() {
   await storage.clear();

apps/papra-client/src/modules/documents/components/document-import-status.component.tsx

@@ -0,0 +1,208 @@
+import type { ParentComponent } from 'solid-js';
+import type { Document } from '../documents.types';
+import { safely } from '@corentinth/chisels';
+import { A } from '@solidjs/router';
+import { throttle } from 'lodash-es';
+import { createContext, createSignal, For, Match, Show, Switch, useContext } from 'solid-js';
+import { Portal } from 'solid-js/web';
+import { useI18n } from '@/modules/i18n/i18n.provider';
+import { promptUploadFiles } from '@/modules/shared/files/upload';
+import { useI18nApiErrors } from '@/modules/shared/http/composables/i18n-api-errors';
+import { cn } from '@/modules/shared/style/cn';
+import { Button } from '@/modules/ui/components/button';
+import { invalidateOrganizationDocumentsQuery } from '../documents.composables';
+import { uploadDocument } from '../documents.services';
+
+const DocumentUploadContext = createContext<{
+  uploadDocuments: (args: { files: File[]; organizationId: string }) => Promise<void>;
+}>();
+
+export function useDocumentUpload({ getOrganizationId }: { getOrganizationId: () => string }) {
+  const context = useContext(DocumentUploadContext);
+
+  if (!context) {
+    throw new Error('DocumentUploadContext not found');
+  }
+
+  const { uploadDocuments } = context;
+
+  return {
+    uploadDocuments: async ({ files }: { files: File[] }) => uploadDocuments({ files, organizationId: getOrganizationId() }),
+    promptImport: async () => {
+      const { files } = await promptUploadFiles();
+
+      await uploadDocuments({ files, organizationId: getOrganizationId() });
+    },
+  };
+}
+
+type TaskSuccess = {
+  file: File;
+  status: 'success';
+  document: Document;
+};
+
+type TaskError = {
+  file: File;
+  status: 'error';
+  error: Error;
+};
+
+type Task = TaskSuccess | TaskError | {
+  file: File;
+  status: 'pending' | 'uploading';
+};
+
+export const DocumentUploadProvider: ParentComponent = (props) => {
+  const throttledInvalidateOrganizationDocumentsQuery = throttle(invalidateOrganizationDocumentsQuery, 500);
+  const { getErrorMessage } = useI18nApiErrors();
+  const { t } = useI18n();
+
+  const [getState, setState] = createSignal<'open' | 'closed' | 'collapsed'>('closed');
+  const [getTasks, setTasks] = createSignal<Task[]>([]);
+
+  const updateTaskStatus = (args: { file: File; status: 'success'; document: Document } | { file: File; status: 'error'; error: Error } | { file: File; status: 'pending' | 'uploading' }) => {
+    setTasks(tasks => tasks.map(task => task.file === args.file ? { ...task, ...args } : task));
+  };
+
+  const uploadDocuments = async ({ files, organizationId }: { files: File[]; organizationId: string }) => {
+    setTasks(tasks => [...tasks, ...files.map(file => ({ file, status: 'pending' } as const))]);
+    setState('open');
+
+    await Promise.all(files.map(async (file) => {
+      updateTaskStatus({ file, status: 'uploading' });
+
+      const [result, error] = await safely(uploadDocument({ file, organizationId }));
+
+      if (error) {
+        updateTaskStatus({ file, status: 'error', error });
+      } else {
+        const { document } = result;
+
+        updateTaskStatus({ file, status: 'success', document });
+      }
+
+      await throttledInvalidateOrganizationDocumentsQuery({ organizationId });
+    }));
+  };
+
+  const getTitle = () => {
+    if (getTasks().length === 0) {
+      return t('import-documents.title.none');
+    }
+
+    const successCount = getTasks().filter(task => task.status === 'success').length;
+    const errorCount = getTasks().filter(task => task.status === 'error').length;
+    const totalCount = getTasks().length;
+
+    if (errorCount > 0) {
+      return t('import-documents.title.error', { count: errorCount });
+    }
+
+    if (successCount === totalCount) {
+      return t('import-documents.title.success', { count: successCount });
+    }
+
+    return t('import-documents.title.pending', { count: successCount, total: totalCount });
+  };
+
+  const close = () => {
+    setState('closed');
+    setTasks([]);
+  };
+
+  return (
+    <DocumentUploadContext.Provider value={{ uploadDocuments }}>
+      {props.children}
+
+      <Portal>
+        <Show when={getState() !== 'closed'}>
+          <div class="fixed bottom-0 right-0 sm:right-20px w-full sm:w-400px bg-card border-l border-t border-r sm:rounded-t-xl shadow-lg">
+            <div class="flex items-center gap-1 pl-6 pr-4 py-3 border-b">
+              <h2 class="text-base font-bold flex-1">{getTitle()}</h2>
+
+              <Button variant="ghost" size="icon" onClick={() => setState(state => state === 'open' ? 'collapsed' : 'open')}>
+                <div class={cn('i-tabler-chevron-down size-5 transition-transform', getState() === 'collapsed' && 'rotate-180')} />
+              </Button>
+
+              <Button variant="ghost" size="icon" onClick={close}>
+                <div class="i-tabler-x size-5"></div>
+              </Button>
+
+            </div>
+
+            <Show when={getState() === 'open'}>
+              <div class="flex flex-col overflow-y-auto h-[450px] pb-4">
+                <For each={getTasks()}>
+                  {task => (
+
+                    <Switch>
+                      <Match when={task.status === 'success'}>
+                        <A
+                          href={`/organizations/${(task as TaskSuccess).document.organizationId}/documents/${(task as TaskSuccess).document.id}`}
+                          class="text-sm truncate min-w-0 flex items-center gap-4 min-h-48px group hover:bg-muted/50 transition-colors px-6 border-b border-border/80"
+                        >
+                          <div class="flex-1 truncate">
+                            {task.file.name}
+                          </div>
+
+                          <div class="flex-none">
+                            <div class="i-tabler-circle-check text-primary size-5.5 group-hover:hidden"></div>
+                            <div class="i-tabler-arrow-right text-muted-foreground size-5.5 hidden group-hover:block"></div>
+                          </div>
+                        </A>
+                      </Match>
+
+                      <Match when={task.status === 'error'}>
+                        <div class="text-sm truncate min-w-0 flex items-center gap-4 min-h-48px px-6 border-b border-border/80">
+                          <div class="flex-1 truncate">
+                            <div class="flex-1 truncate">{task.file.name}</div>
+
+                            <div class="text-xs text-muted-foreground truncate text-red-500">
+                              {getErrorMessage({ error: (task as TaskError).error })}
+                            </div>
+                          </div>
+
+                          <div class="flex-none">
+                            <div class="i-tabler-circle-x text-red-500 size-5.5"></div>
+                          </div>
+                        </div>
+                      </Match>
+
+                      <Match when={['pending', 'uploading'].includes(task.status)}>
+                        <div class="text-sm truncate min-w-0 flex items-center gap-4 min-h-48px px-6 border-b border-border/80">
+                          <div class="flex-1 truncate">
+                            {task.file.name}
+                          </div>
+
+                          <div class="flex-none">
+                            <div class="i-tabler-loader-2 animate-spin text-muted-foreground size-5.5"></div>
+                          </div>
+                        </div>
+                      </Match>
+                    </Switch>
+
+                  )}
+                </For>
+
+                <Show when={getTasks().length === 0}>
+                  <div class="flex flex-col items-center justify-center gap-2 h-full mb-10">
+                    <div class="flex flex-col items-center justify-center gap-2 ">
+                      <div class="i-tabler-file-import size-10 text-muted-foreground"></div>
+                    </div>
+
+                    <div class="text-sm text-muted-foreground text-center mt-2">
+                      {t('import-documents.no-import-in-progress')}
+                    </div>
+                  </div>
+                </Show>
+              </div>
+
+            </Show>
+
+          </div>
+        </Show>
+      </Portal>
+    </DocumentUploadContext.Provider>
+  );
+};

apps/papra-client/src/modules/documents/components/document-management-dropdown.component.tsx

@@ -1,9 +1,9 @@
 import type { DropdownMenuSubTriggerProps } from '@kobalte/core/dropdown-menu';
 import type { Component } from 'solid-js';
 import type { Document } from '../documents.types';
+import { A } from '@solidjs/router';
 import { Button } from '@/modules/ui/components/button';
 import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from '@/modules/ui/components/dropdown-menu';
-import { A } from '@solidjs/router';
 import { useDeleteDocument } from '../documents.composables';
 
 export const DocumentManagementDropdown: Component<{ document: Document }> = (props) => {

apps/papra-client/src/modules/documents/components/document-preview.component.tsx

@@ -1,7 +1,8 @@
+import type { Component } from 'solid-js';
 import type { Document } from '../documents.types';
-import { Card } from '@/modules/ui/components/card';
 import { createQuery } from '@tanstack/solid-query';
-import { type Component, createResource, Match, Suspense, Switch } from 'solid-js';
+import { createResource, Match, Suspense, Switch } from 'solid-js';
+import { Card } from '@/modules/ui/components/card';
 import { fetchDocumentFile } from '../documents.services';
 import { PdfViewer } from './pdf-viewer.component';
 
@@ -24,7 +25,7 @@ const TextFromBlob: Component<{ blob: Blob }> = (props) => {
   return (
     <Card class="p-6 overflow-auto max-h-800px max-w-full text-xs">
       <Suspense>
-        <pre>{txt()}</pre>
+        <pre class="break-words whitespace-pre-wrap">{txt()}</pre>
       </Suspense>
     </Card>
   );

apps/papra-client/src/modules/documents/components/document-upload-area.component.tsx

@@ -1,10 +1,10 @@
 import type { Component } from 'solid-js';
+import { useParams } from '@solidjs/router';
+import { createSignal } from 'solid-js';
 import { promptUploadFiles } from '@/modules/shared/files/upload';
 import { queryClient } from '@/modules/shared/query/query-client';
 import { cn } from '@/modules/shared/style/cn';
 import { Button } from '@/modules/ui/components/button';
-import { useParams } from '@solidjs/router';
-import { createSignal } from 'solid-js';
 import { uploadDocument } from '../documents.services';
 
 export const DocumentUploadArea: Component<{ organizationId?: string }> = (props) => {

apps/papra-client/src/modules/documents/components/documents-list.component.tsx

@@ -1,7 +1,12 @@
-import type { Tag } from '@/modules/tags/tags.types';
 import type { TooltipTriggerProps } from '@kobalte/core/tooltip';
 import type { ColumnDef } from '@tanstack/solid-table';
+import type { Accessor, Component, Setter } from 'solid-js';
 import type { Document } from '../documents.types';
+import type { Tag } from '@/modules/tags/tags.types';
+import { formatBytes } from '@corentinth/chisels';
+import { A } from '@solidjs/router';
+import { createSolidTable, flexRender, getCoreRowModel, getPaginationRowModel } from '@tanstack/solid-table';
+import { For, Match, Show, Switch } from 'solid-js';
 import { timeAgo } from '@/modules/shared/date/time-ago';
 import { cn } from '@/modules/shared/style/cn';
 import { TagLink } from '@/modules/tags/components/tag.component';
@@ -9,11 +14,7 @@ import { Button } from '@/modules/ui/components/button';
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/modules/ui/components/select';
 import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@/modules/ui/components/table';
 import { Tooltip, TooltipContent, TooltipTrigger } from '@/modules/ui/components/tooltip';
-import { formatBytes } from '@corentinth/chisels';
-import { A } from '@solidjs/router';
-import { createSolidTable, flexRender, getCoreRowModel, getPaginationRowModel } from '@tanstack/solid-table';
-import { type Accessor, type Component, For, Match, type Setter, Show, Switch } from 'solid-js';
-import { getDocumentIcon } from '../document.models';
+import { getDocumentIcon, getDocumentNameExtension, getDocumentNameWithoutExtension } from '../document.models';
 import { DocumentManagementDropdown } from './document-management-dropdown.component';
 
 type Pagination = {
@@ -83,15 +84,11 @@ export const DocumentsPaginatedList: Component<{
                 href={`/organizations/${data.row.original.organizationId}/documents/${data.row.original.id}`}
                 class="font-bold truncate block hover:underline"
               >
-                {data.row.original.name.split('.').slice(0, -1).join('.')}
+                {getDocumentNameWithoutExtension({ name: data.row.original.name })}
               </A>
 
               <div class="text-xs text-muted-foreground lh-tight">
-                {formatBytes({ bytes: data.row.original.originalSize, base: 1000 })}
-                {' '}
-                -
-                {' '}
-                {data.row.original.name.split('.').pop()?.toUpperCase()}
+                {[formatBytes({ bytes: data.row.original.originalSize, base: 1000 }), getDocumentNameExtension({ name: data.row.original.name })].filter(Boolean).join(' - ')}
                 {' '}
                 -
                 {' '}

apps/papra-client/src/modules/documents/components/global-drop-area.component.tsx

@@ -1,6 +1,6 @@
 import type { Component } from 'solid-js';
-import { cn } from '@/modules/shared/style/cn';
 import { createSignal, onCleanup } from 'solid-js';
+import { cn } from '@/modules/shared/style/cn';
 
 export const GlobalDropArea: Component<{ onFilesDrop?: (args: { files: File[] }) => void }> = (props) => {
   const [isDragging, setIsDragging] = createSignal(false);

apps/papra-client/src/modules/documents/document.models.test.ts

@@ -1,7 +1,7 @@
 import { icons as tablerIconSet } from '@iconify-json/tabler';
 import { values } from 'lodash-es';
 import { describe, expect, test } from 'vitest';
-import { getDaysBeforePermanentDeletion, getDocumentIcon, iconByFileType } from './document.models';
+import { getDaysBeforePermanentDeletion, getDocumentIcon, getDocumentNameExtension, getDocumentNameWithoutExtension, iconByFileType } from './document.models';
 
 describe('files models', () => {
   describe('iconByFileType', () => {
@@ -101,4 +101,24 @@ describe('files models', () => {
       expect(daysBeforeDeletion).to.eql(undefined);
     });
   });
+
+  describe('getDocumentNameWithoutExtension', () => {
+    test('get the document name without the extension', () => {
+      expect(getDocumentNameWithoutExtension({ name: 'document.txt' })).to.eql('document');
+      expect(getDocumentNameWithoutExtension({ name: 'document' })).to.eql('document');
+      expect(getDocumentNameWithoutExtension({ name: '.document' })).to.eql('.document');
+      expect(getDocumentNameWithoutExtension({ name: '.document.txt' })).to.eql('.document');
+      expect(getDocumentNameWithoutExtension({ name: 'document.test.txt' })).to.eql('document.test');
+    });
+  });
+
+  describe('getDocumentNameExtension', () => {
+    test('get the document name extension', () => {
+      expect(getDocumentNameExtension({ name: 'document.txt' })).to.eql('txt');
+      expect(getDocumentNameExtension({ name: 'document' })).to.eql(undefined);
+      expect(getDocumentNameExtension({ name: '.document' })).to.eql(undefined);
+      expect(getDocumentNameExtension({ name: '.document.txt' })).to.eql('txt');
+      expect(getDocumentNameExtension({ name: 'document.test.txt' })).to.eql('txt');
+    });
+  });
 });

apps/papra-client/src/modules/documents/document.models.ts

@@ -49,3 +49,33 @@ export function getDaysBeforePermanentDeletion({ document, deletedDocumentsReten
 
   return daysBeforeDeletion;
 }
+
+export function getDocumentNameWithoutExtension({ name }: { name: string }) {
+  const dotSplittedName = name.split('.');
+  const dotCount = dotSplittedName.length - 1;
+
+  if (dotCount === 0) {
+    return name;
+  }
+
+  if (dotCount === 1 && name.startsWith('.')) {
+    return name;
+  }
+
+  return dotSplittedName.slice(0, -1).join('.');
+}
+
+export function getDocumentNameExtension({ name }: { name: string }) {
+  const dotSplittedName = name.split('.');
+  const dotCount = dotSplittedName.length - 1;
+
+  if (dotCount === 0) {
+    return undefined;
+  }
+
+  if (dotCount === 1 && name.startsWith('.')) {
+    return undefined;
+  }
+
+  return dotSplittedName[dotCount];
+}

apps/papra-client/src/modules/documents/documents.composables.tsx

@@ -9,7 +9,7 @@ import { queryClient } from '../shared/query/query-client';
 import { createToast } from '../ui/components/sonner';
 import { deleteDocument, restoreDocument, uploadDocument } from './documents.services';
 
-function invalidateOrganizationDocumentsQuery({ organizationId }: { organizationId: string }) {
+export function invalidateOrganizationDocumentsQuery({ organizationId }: { organizationId: string }) {
   return queryClient.invalidateQueries({
     queryKey: ['organizations', organizationId],
   });
@@ -77,6 +77,34 @@ export function useRestoreDocument() {
   };
 }
 
+function toastUploadError({ error, file }: { error: Error; file: File }) {
+  if (isHttpErrorWithCode({ error, code: 'document.already_exists' })) {
+    createToast({
+      type: 'error',
+      message: 'Document already exists',
+      description: `The document ${file.name} already exists, it has not been uploaded.`,
+    });
+
+    return;
+  }
+
+  if (isHttpErrorWithCode({ error, code: 'document.file_too_big' })) {
+    createToast({
+      type: 'error',
+      message: 'Document too big',
+      description: `The document ${file.name} is too big, it has not been uploaded.`,
+    });
+
+    return;
+  }
+
+  createToast({
+    type: 'error',
+    message: 'Failed to upload document',
+    description: error.message,
+  });
+}
+
 export function useUploadDocuments({ organizationId }: { organizationId: string }) {
   const uploadDocuments = async ({ files }: { files: File[] }) => {
     const throttledInvalidateOrganizationDocumentsQuery = throttle(invalidateOrganizationDocumentsQuery, 500);
@@ -84,12 +112,8 @@ export function useUploadDocuments({ organizationId }: { organizationId: string
     await Promise.all(files.map(async (file) => {
       const [, error] = await safely(uploadDocument({ file, organizationId }));
 
-      if (isHttpErrorWithCode({ error, code: 'document.already_exists' })) {
-        createToast({
-          type: 'error',
-          message: 'Document already exists',
-          description: `The document ${file.name} already exists, it has not been uploaded.`,
-        });
+      if (error) {
+        toastUploadError({ error, file });
       }
 
       await throttledInvalidateOrganizationDocumentsQuery({ organizationId });

apps/papra-client/src/modules/documents/documents.services.ts

@@ -1,6 +1,7 @@
+import type { AsDto } from '../shared/http/http-client.types';
 import type { Document } from './documents.types';
 import { apiClient } from '../shared/http/api-client';
-import { getFormData } from '../shared/http/http-client.models';
+import { coerceDates, getFormData } from '../shared/http/http-client.models';
 
 export async function uploadDocument({
   file,
@@ -9,18 +10,14 @@ export async function uploadDocument({
   file: File;
   organizationId: string;
 }) {
-  const { document } = await apiClient<{ document: Document }>({
+  const { document } = await apiClient<{ document: AsDto<Document> }>({
     method: 'POST',
     path: `/api/organizations/${organizationId}/documents`,
     body: getFormData({ file }),
   });
 
   return {
-    document: {
-      ...document,
-      createdAt: new Date(document.createdAt),
-      updatedAt: document.updatedAt ? new Date(document.updatedAt) : undefined,
-    },
+    document: coerceDates(document),
   };
 }
 
@@ -40,7 +37,7 @@ export async function fetchOrganizationDocuments({
   const {
     documents,
     documentsCount,
-  } = await apiClient<{ documents: Document[]; documentsCount: number }>({
+  } = await apiClient<{ documents: AsDto<Document>[]; documentsCount: number }>({
     method: 'GET',
     path: `/api/organizations/${organizationId}/documents`,
     query: {
@@ -52,11 +49,7 @@ export async function fetchOrganizationDocuments({
 
   return {
     documentsCount,
-    documents: documents.map(document => ({
-      ...document,
-      createdAt: new Date(document.createdAt),
-      updatedAt: document.updatedAt ? new Date(document.updatedAt) : undefined,
-    })),
+    documents: documents.map(coerceDates),
   };
 }
 
@@ -72,7 +65,7 @@ export async function fetchOrganizationDeletedDocuments({
   const {
     documents,
     documentsCount,
-  } = await apiClient<{ documents: Document[]; documentsCount: number }>({
+  } = await apiClient<{ documents: AsDto<Document>[]; documentsCount: number }>({
     method: 'GET',
     path: `/api/organizations/${organizationId}/documents/deleted`,
     query: {
@@ -83,11 +76,7 @@ export async function fetchOrganizationDeletedDocuments({
 
   return {
     documentsCount,
-    documents: documents.map(document => ({
-      ...document,
-      createdAt: new Date(document.createdAt),
-      updatedAt: document.updatedAt ? new Date(document.updatedAt) : undefined,
-    })),
+    documents: documents.map(coerceDates),
   };
 }
 
@@ -124,17 +113,13 @@ export async function fetchDocument({
   documentId: string;
   organizationId: string;
 }) {
-  const { document } = await apiClient<{ document: Document }>({
+  const { document } = await apiClient<{ document: AsDto<Document> }>({
     method: 'GET',
     path: `/api/organizations/${organizationId}/documents/${documentId}`,
   });
 
   return {
-    document: {
-      ...document,
-      createdAt: new Date(document.createdAt),
-      updatedAt: document.updatedAt ? new Date(document.updatedAt) : undefined,
-    },
+    document: coerceDates(document),
   };
 }
 
@@ -167,7 +152,7 @@ export async function searchDocuments({
 }) {
   const {
     documents,
-  } = await apiClient<{ documents: Document[] }>({
+  } = await apiClient<{ documents: AsDto<Document>[] }>({
     method: 'GET',
     path: `/api/organizations/${organizationId}/documents/search`,
     query: {
@@ -178,11 +163,7 @@ export async function searchDocuments({
   });
 
   return {
-    documents: documents.map(document => ({
-      ...document,
-      createdAt: new Date(document.createdAt),
-      updatedAt: document.updatedAt ? new Date(document.updatedAt) : undefined,
-    })),
+    documents: documents.map(coerceDates),
   };
 }
 
@@ -194,3 +175,37 @@ export async function getOrganizationDocumentsStats({ organizationId }: { organi
 
   return { organizationStats };
 }
+
+export async function deleteAllTrashDocuments({ organizationId }: { organizationId: string }) {
+  await apiClient({
+    method: 'DELETE',
+    path: `/api/organizations/${organizationId}/documents/trash`,
+  });
+}
+
+export async function deleteTrashDocument({ documentId, organizationId }: { documentId: string; organizationId: string }) {
+  await apiClient({
+    method: 'DELETE',
+    path: `/api/organizations/${organizationId}/documents/trash/${documentId}`,
+  });
+}
+
+export async function updateDocument({
+  documentId,
+  organizationId,
+  content,
+}: {
+  documentId: string;
+  organizationId: string;
+  content: string;
+}) {
+  const { document } = await apiClient<{ document: AsDto<Document> }>({
+    method: 'PATCH',
+    path: `/api/organizations/${organizationId}/documents/${documentId}`,
+    body: { content },
+  });
+
+  return {
+    document: coerceDates(document),
+  };
+}

apps/papra-client/src/modules/documents/documents.types.ts

@@ -11,5 +11,6 @@ export type Document = {
   isDeleted?: boolean;
   deletedAt?: Date;
   deletedBy?: string;
+  content: string;
   tags: Tag[];
 };

apps/papra-client/src/modules/documents/pages/deleted-documents.page.tsx

@@ -1,14 +1,19 @@
+import type { Component } from 'solid-js';
 import type { Document } from '../documents.types';
+import { useParams } from '@solidjs/router';
+import { createMutation, createQuery, keepPreviousData } from '@tanstack/solid-query';
+import { createSignal, Show, Suspense } from 'solid-js';
 import { useConfig } from '@/modules/config/config.provider';
+import { useI18n } from '@/modules/i18n/i18n.provider';
+import { useConfirmModal } from '@/modules/shared/confirm';
 import { timeAgo } from '@/modules/shared/date/time-ago';
+import { queryClient } from '@/modules/shared/query/query-client';
 import { Alert, AlertDescription } from '@/modules/ui/components/alert';
 import { Button } from '@/modules/ui/components/button';
-import { useParams } from '@solidjs/router';
-import { createQuery, keepPreviousData } from '@tanstack/solid-query';
-import { type Component, createSignal, Show, Suspense } from 'solid-js';
+import { createToast } from '@/modules/ui/components/sonner';
 import { DocumentsPaginatedList } from '../components/documents-list.component';
 import { useRestoreDocument } from '../documents.composables';
-import { fetchOrganizationDeletedDocuments } from '../documents.services';
+import { deleteAllTrashDocuments, deleteTrashDocument, fetchOrganizationDeletedDocuments } from '../documents.services';
 
 const RestoreDocumentButton: Component<{ document: Document }> = (props) => {
   const { getIsRestoring, restore } = useRestoreDocument();
@@ -32,6 +37,113 @@ const RestoreDocumentButton: Component<{ document: Document }> = (props) => {
   );
 };
 
+const PermanentlyDeleteTrashDocumentButton: Component<{ document: Document; organizationId: string }> = (props) => {
+  const { confirm } = useConfirmModal();
+  const { t } = useI18n();
+
+  const deleteMutation = createMutation(() => ({
+    mutationFn: async () => {
+      await deleteTrashDocument({ documentId: props.document.id, organizationId: props.organizationId });
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['organizations', props.organizationId, 'documents', 'deleted'] });
+
+      createToast({
+        message: t('trash.deleted.success.title'),
+        description: t('trash.deleted.success.description'),
+      });
+    },
+  }));
+
+  const handleClick = async () => {
+    if (!await confirm({
+      title: t('trash.delete.confirm.title'),
+      message: t('trash.delete.confirm.description'),
+      confirmButton: {
+        text: t('trash.delete.confirm.label'),
+        variant: 'destructive',
+      },
+      cancelButton: {
+        text: t('trash.delete.confirm.cancel'),
+      },
+    })) {
+      return;
+    }
+
+    deleteMutation.mutate();
+  };
+
+  return (
+    <Button
+      variant="outline"
+      size="sm"
+      onClick={handleClick}
+      isLoading={deleteMutation.isPending}
+      class="text-red-500 hover:text-red-600"
+    >
+      {deleteMutation.isPending
+        ? (<>Deleting...</>)
+        : (
+            <>
+              <div class="i-tabler-trash size-4 mr-2" />
+              {t('trash.delete.button')}
+            </>
+          )}
+    </Button>
+  );
+};
+
+const DeleteAllTrashDocumentsButton: Component<{ organizationId: string }> = (props) => {
+  const { confirm } = useConfirmModal();
+  const { t } = useI18n();
+
+  const deleteAllMutation = createMutation(() => ({
+    mutationFn: async () => {
+      await deleteAllTrashDocuments({ organizationId: props.organizationId });
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['organizations', props.organizationId, 'documents', 'deleted'] });
+    },
+  }));
+
+  const handleClick = async () => {
+    if (!await confirm({
+      title: t('trash.delete-all.confirm.title'),
+      message: t('trash.delete-all.confirm.description'),
+      confirmButton: {
+        text: t('trash.delete-all.confirm.label'),
+        variant: 'destructive',
+      },
+      cancelButton: {
+        text: t('trash.delete-all.confirm.cancel'),
+      },
+    })) {
+      return;
+    }
+
+    deleteAllMutation.mutate();
+  };
+
+  return (
+    <Button
+      variant="outline"
+      size="sm"
+      onClick={handleClick}
+      isLoading={deleteAllMutation.isPending}
+      class="text-red-500 hover:text-red-600"
+    >
+      {deleteAllMutation.isPending
+        ? (<>Deleting...</>)
+        : (
+            <>
+              <div class="i-tabler-trash size-4 mr-2" />
+              {t('trash.delete-all.button')}
+            </>
+          )}
+    </Button>
+  );
+};
+
 export const DeletedDocumentsPage: Component = () => {
   const [getPagination, setPagination] = createSignal({ pageIndex: 0, pageSize: 100 });
   const params = useParams();
@@ -77,6 +189,10 @@ export const DeletedDocumentsPage: Component = () => {
         </Show>
 
         <Show when={query.data && query.data?.documents.length > 0}>
+          <div class="flex items-center justify-end gap-2">
+            <DeleteAllTrashDocumentsButton organizationId={params.organizationId} />
+          </div>
+
           <DocumentsPaginatedList
             documents={query.data?.documents ?? []}
             documentsCount={query.data?.documentsCount ?? 0}
@@ -96,8 +212,9 @@ export const DeletedDocumentsPage: Component = () => {
               {
                 id: 'actions',
                 cell: data => (
-                  <div class="flex items-center justify-end">
+                  <div class="flex items-center justify-end gap-2">
                     <RestoreDocumentButton document={data.row.original} />
+                    <PermanentlyDeleteTrashDocumentButton document={data.row.original} organizationId={params.organizationId} />
                   </div>
                 ),
               },

apps/papra-client/src/modules/documents/pages/document.page.tsx

@@ -1,19 +1,27 @@
-import { useConfig } from '@/modules/config/config.provider';
-import { timeAgo } from '@/modules/shared/date/time-ago';
-import { downloadFile } from '@/modules/shared/files/download';
-import { DocumentTagPicker } from '@/modules/tags/components/tag-picker.component';
-import { addTagToDocument, removeTagFromDocument } from '@/modules/tags/tags.services';
-import { Alert } from '@/modules/ui/components/alert';
-import { Button } from '@/modules/ui/components/button';
-import { Separator } from '@/modules/ui/components/separator';
-import { formatBytes } from '@corentinth/chisels';
+import type { Component, JSX } from 'solid-js';
+import { formatBytes, safely } from '@corentinth/chisels';
 import { useNavigate, useParams } from '@solidjs/router';
 import { createQueries } from '@tanstack/solid-query';
-import { type Component, For, type JSX, Show, Suspense } from 'solid-js';
+import { createSignal, For, Show, Suspense } from 'solid-js';
+import { useConfig } from '@/modules/config/config.provider';
+import { useI18n } from '@/modules/i18n/i18n.provider';
+import { timeAgo } from '@/modules/shared/date/time-ago';
+import { downloadFile } from '@/modules/shared/files/download';
+import { queryClient } from '@/modules/shared/query/query-client';
+import { DocumentTagPicker } from '@/modules/tags/components/tag-picker.component';
+import { CreateTagModal } from '@/modules/tags/pages/tags.page';
+import { addTagToDocument, removeTagFromDocument } from '@/modules/tags/tags.services';
+import { Alert, AlertDescription } from '@/modules/ui/components/alert';
+import { Button } from '@/modules/ui/components/button';
+import { Separator } from '@/modules/ui/components/separator';
+import { createToast } from '@/modules/ui/components/sonner';
+import { Tabs, TabsContent, TabsIndicator, TabsList, TabsTrigger } from '@/modules/ui/components/tabs';
+import { TextArea } from '@/modules/ui/components/textarea';
+import { TextFieldRoot } from '@/modules/ui/components/textfield';
 import { DocumentPreview } from '../components/document-preview.component';
 import { getDaysBeforePermanentDeletion } from '../document.models';
 import { useDeleteDocument, useRestoreDocument } from '../documents.composables';
-import { fetchDocument, fetchDocumentFile } from '../documents.services';
+import { fetchDocument, fetchDocumentFile, updateDocument } from '../documents.services';
 import '@pdfslick/solid/dist/pdf_viewer.css';
 
 type KeyValueItem = {
@@ -43,6 +51,7 @@ const KeyValues: Component<{ data?: KeyValueItem[] }> = (props) => {
 };
 
 export const DocumentPage: Component = () => {
+  const { t } = useI18n();
   const params = useParams();
   const { deleteDocument } = useDeleteDocument();
   const { restore, getIsRestoring } = useRestoreDocument();
@@ -82,6 +91,44 @@ export const DocumentPage: Component = () => {
 
   const getDataUrl = () => queries[1].data ? URL.createObjectURL(queries[1].data) : undefined;
 
+  const [isEditing, setIsEditing] = createSignal(false);
+  const [editedContent, setEditedContent] = createSignal('');
+  const [isSaving, setIsSaving] = createSignal(false);
+
+  const handleEdit = () => {
+    setEditedContent(queries[0].data?.document.content ?? '');
+    setIsEditing(true);
+  };
+
+  const handleCancel = () => {
+    setIsEditing(false);
+    setEditedContent('');
+  };
+
+  const handleSave = async () => {
+    if (!queries[0].data?.document) {
+      return;
+    }
+
+    setIsSaving(true);
+    const [, error] = await safely(updateDocument({
+      documentId: queries[0].data.document.id,
+      organizationId: params.organizationId,
+      content: editedContent(),
+    }));
+    setIsSaving(false);
+    setIsEditing(false);
+
+    if (error) {
+      createToast({ type: 'error', message: 'Failed to update document content' });
+      return;
+    }
+    createToast({ type: 'success', message: 'Document content updated' });
+    await queryClient.invalidateQueries({
+      queryKey: ['organizations', params.organizationId, 'documents', params.documentId],
+    });
+  };
+
   return (
     <div class="p-6 flex gap-6 h-full flex-col md:flex-row max-w-7xl mx-auto">
       <Suspense>
@@ -136,26 +183,38 @@ export const DocumentPage: Component = () => {
                         )}
                   </div>
 
-                  <DocumentTagPicker
-                    organizationId={params.organizationId}
-                    documentId={params.documentId}
-                    tags={getDocument().tags}
-                    onTagAdded={async ({ tag }) => {
-                      await addTagToDocument({
-                        documentId: params.documentId,
-                        organizationId: params.organizationId,
-                        tagId: tag.id,
-                      });
-                    }}
+                  <div class="flex gap-2 sm:items-center sm:flex-row flex-col">
+                    <div class="flex-1">
+                      <DocumentTagPicker
+                        organizationId={params.organizationId}
+                        tagIds={getDocument().tags.map(tag => tag.id)}
+                        onTagAdded={async ({ tag }) => {
+                          await addTagToDocument({
+                            documentId: params.documentId,
+                            organizationId: params.organizationId,
+                            tagId: tag.id,
+                          });
+                        }}
 
-                    onTagRemoved={async ({ tag }) => {
-                      await removeTagFromDocument({
-                        documentId: params.documentId,
-                        organizationId: params.organizationId,
-                        tagId: tag.id,
-                      });
-                    }}
-                  />
+                        onTagRemoved={async ({ tag }) => {
+                          await removeTagFromDocument({
+                            documentId: params.documentId,
+                            organizationId: params.organizationId,
+                            tagId: tag.id,
+                          });
+                        }}
+                      />
+                    </div>
+
+                    <CreateTagModal organizationId={params.organizationId}>
+                      {params => (
+                        <Button variant="outline" {...params}>
+                          <div class="i-tabler-plus size-4 mr-2"></div>
+                          {t('tagging-rules.form.tags.add-tag')}
+                        </Button>
+                      )}
+                    </CreateTagModal>
+                  </div>
 
                   {getDocument().isDeleted && (
                     <Alert variant="destructive" class="mt-6">
@@ -170,41 +229,95 @@ export const DocumentPage: Component = () => {
                     </Alert>
                   )}
 
-                  <Separator class="my-6" />
+                  <Separator class="my-3" />
+
+                  <Tabs defaultValue="info" class="w-full">
+                    <TabsList class="w-full h-8">
+                      <TabsTrigger value="info">Info</TabsTrigger>
+                      <TabsTrigger value="content">Content</TabsTrigger>
+                      <TabsIndicator />
+                    </TabsList>
+
+                    <TabsContent value="info">
+                      <KeyValues data={[
+                        {
+                          label: 'ID',
+                          value: getDocument().id,
+                          icon: 'i-tabler-id',
+                        },
+                        {
+                          label: 'Name',
+                          value: getDocument().name,
+                          icon: 'i-tabler-file-text',
+                        },
+                        {
+                          label: 'Type',
+                          value: getDocument().mimeType,
+                          icon: 'i-tabler-file-unknown',
+                        },
+                        {
+                          label: 'Size',
+                          value: formatBytes({ bytes: getDocument().originalSize, base: 1000 }),
+                          icon: 'i-tabler-weight',
+                        },
+                        {
+                          label: 'Created At',
+                          value: timeAgo({ date: getDocument().createdAt }),
+                          icon: 'i-tabler-calendar',
+                        },
+                        {
+                          label: 'Updated At',
+                          value: getDocument().updatedAt ? timeAgo({ date: getDocument().updatedAt! }) : <span class="text-muted-foreground">Never</span>,
+                          icon: 'i-tabler-calendar',
+                        },
+                      ]}
+                      />
+                    </TabsContent>
+                    <TabsContent value="content">
+                      <Show
+                        when={isEditing()}
+                        fallback={(
+                          <div class="flex flex-col gap-2">
+                            <div class="whitespace-pre-wrap font-mono text-sm bg-muted p-4 rounded-md max-h-[400px] overflow-auto">
+                              {queries[0].data?.document.content}
+                            </div>
+                            <div class="flex justify-end">
+                              <Button variant="outline" onClick={handleEdit}>
+                                <div class="i-tabler-edit size-4 mr-2" />
+                                Edit
+                              </Button>
+                            </div>
+
+                            <Alert variant="muted" class="my-4 flex items-center gap-2">
+                              <div class="i-tabler-info-circle size-8 flex-shrink-0" />
+                              <AlertDescription>
+                                The content of the document is automatically extracted from the document on upload. It is only used for search and indexing purposes.
+                              </AlertDescription>
+                            </Alert>
+                          </div>
+                        )}
+                      >
+                        <div class="flex flex-col gap-2">
+                          <TextFieldRoot>
+                            <TextArea
+                              value={editedContent()}
+                              onInput={e => setEditedContent(e.currentTarget.value)}
+                              class="font-mono min-h-[200px]"
+                            />
+                          </TextFieldRoot>
+                          <div class="flex justify-end gap-2">
+                            <Button variant="outline" onClick={handleCancel} disabled={isSaving()}>
+                              Cancel
+                            </Button>
+                            <Button onClick={handleSave} disabled={isSaving()}>
+                              {isSaving() ? 'Saving...' : 'Save'}
+                            </Button>
+                          </div>
+                        </div>
+                      </Show>
+                    </TabsContent>
+                  </Tabs>
 
-                  <KeyValues data={[
-                    {
-                      label: 'ID',
-                      value: getDocument().id,
-                      icon: 'i-tabler-id',
-                    },
-                    {
-                      label: 'Name',
-                      value: getDocument().name,
-                      icon: 'i-tabler-file-text',
-                    },
-                    {
-                      label: 'Type',
-                      value: getDocument().mimeType,
-                      icon: 'i-tabler-file-unknown',
-                    },
-                    {
-                      label: 'Size',
-                      value: formatBytes({ bytes: getDocument().originalSize, base: 1000 }),
-                      icon: 'i-tabler-weight',
-                    },
-                    {
-                      label: 'Created At',
-                      value: timeAgo({ date: getDocument().createdAt }),
-                      icon: 'i-tabler-calendar',
-                    },
-                    {
-                      label: 'Updated At',
-                      value: getDocument().updatedAt ? timeAgo({ date: getDocument().updatedAt! }) : <span class="text-muted-foreground">Never</span>,
-                      icon: 'i-tabler-calendar',
-                    },
-                  ]}
-                  />
                 </div>
               </div>
             )}

apps/papra-client/src/modules/documents/pages/documents.page.tsx

@@ -1,10 +1,11 @@
-import { fetchOrganization } from '@/modules/organizations/organizations.services';
-import { Tag } from '@/modules/tags/components/tag.component';
-import { fetchTags } from '@/modules/tags/tags.services';
+import type { Component } from 'solid-js';
 import { useParams, useSearchParams } from '@solidjs/router';
 import { createQueries, keepPreviousData } from '@tanstack/solid-query';
 import { castArray } from 'lodash-es';
-import { type Component, createSignal, For, Show, Suspense } from 'solid-js';
+import { createSignal, For, Show, Suspense } from 'solid-js';
+import { fetchOrganization } from '@/modules/organizations/organizations.services';
+import { Tag } from '@/modules/tags/components/tag.component';
+import { fetchTags } from '@/modules/tags/tags.services';
 import { DocumentUploadArea } from '../components/document-upload-area.component';
 import { createdAtColumn, DocumentsPaginatedList, standardActionsColumn, tagsColumn } from '../components/documents-list.component';
 import { fetchOrganizationDocuments } from '../documents.services';

apps/papra-client/src/modules/i18n/i18n.constants.ts

@@ -1,4 +1,4 @@
 export const locales = [
   { key: 'en', name: 'English' },
   { key: 'fr', name: 'Français' },
-];
+] as const;

apps/papra-client/src/modules/i18n/i18n.models.ts

@@ -30,7 +30,13 @@ export function findMatchingLocale({
 
 export function createTranslator<Dict extends Record<string, string>>({ getDictionary }: { getDictionary: () => Dict }) {
   return (key: keyof Dict, args?: Record<string, string | number>) => {
-    let translation: string = getDictionary()[key] ?? key;
+    const translationFromDictionary = getDictionary()[key];
+
+    if (!translationFromDictionary && import.meta.env.DEV) {
+      console.warn(`Translation not found for key: ${String(key)}`);
+    }
+
+    let translation: string = translationFromDictionary ?? key;
 
     if (args) {
       for (const [key, value] of Object.entries(args)) {

apps/papra-client/src/modules/i18n/i18n.provider.tsx

@@ -2,7 +2,7 @@ import type { Accessor, ParentComponent, Setter } from 'solid-js';
 import type { LocaleKeys } from './locales.types';
 import { makePersisted } from '@solid-primitives/storage';
 import { createContext, createEffect, createResource, createSignal, Show, useContext } from 'solid-js';
-import defaultDict from '../../locales/en.yml?flattened';
+import defaultDict from '../../locales/en.yml';
 import { locales } from './i18n.constants';
 import { createFragmentTranslator, createTranslator, findMatchingLocale } from './i18n.models';
 
@@ -28,7 +28,7 @@ export function useI18n() {
 }
 
 async function fetchDictionary(locale: Locale): Promise<Dictionary> {
-  const { default: dict } = await import(`../../locales/${locale}.yml?flattened`);
+  const { default: dict } = await import(`../../locales/${locale}.yml`);
 
   return {
     ...defaultDict,

apps/papra-client/src/modules/i18n/locales.test.ts

@@ -1,10 +1,14 @@
+import { readFile } from 'node:fs/promises';
+import { glob } from 'tinyglobby';
 import { describe, expect, test } from 'vitest';
 
-const rawLocales = import.meta.glob('../../locales/*.yml', { eager: true, query: '?flattened' });
-const { en: defaultLocal, ...locales } = Object.fromEntries(
+const rawLocales = import.meta.glob('../../locales/*.yml', { eager: true });
+const locales = Object.fromEntries(
   Object.entries(rawLocales).map(([key, value]: [string, any]) => [key.replace('../../locales/', '').replace('.yml', ''), value.default]),
 );
 
+const { en: defaultLocal } = locales;
+
 describe('locales', () => {
   for (const [locale, translations] of Object.entries(locales)) {
     describe(locale, () => {
@@ -26,4 +30,39 @@ describe('locales', () => {
       });
     });
   }
+
+  test('all keys in en.yml must be used in the app (dynamic keys are manually excluded)', async () => {
+    const srcFileNames = await glob(['src/**/*.{ts,tsx}', '!src/**/*.test.*', '!src/modules/i18n/locales.types.ts'], { cwd: process.cwd() });
+
+    // Exclude keys that are used in dynamic contexts
+    const dynamicKeysMatchers = [
+      /^api-errors\./, // api-errors.document.already_exists
+      /^auth\.register\.providers\.[a-z0-9:]+$/, // auth.register.providers.google
+      /^webhooks\.events\.documents\.[a-z0-9:]+.description$/, // webhooks.events.organization.organization:created
+      /^api-keys\.permissions\.[a-z0-9:]+\.[a-z0-9:]+$/, // api-keys.permissions.documents.documents:delete
+      /^organizations\.members\.roles\.[a-z0-9]+$/, // organizations.members.roles.admin
+    ];
+
+    const keys = new Set(
+      Object
+        .keys(defaultLocal)
+        .filter(key => !dynamicKeysMatchers.some(matcher => matcher.test(key))),
+    );
+
+    for (const srcFileName of srcFileNames) {
+      const fileContent = await readFile(srcFileName, 'utf-8');
+
+      for (const key of keys) {
+        if (fileContent.includes(key)) {
+          keys.delete(key);
+        }
+      }
+
+      if (keys.size === 0) {
+        break;
+      }
+    }
+
+    expect([...keys]).to.eql([], 'Unused keys found in en.yml, please remove them (or add them to the dynamic keys matchers in locales.test.ts if they are used in dynamic contexts)');
+  });
 });

apps/papra-client/src/modules/i18n/locales.types.ts

@@ -1,2 +1,278 @@
-// Dynamically generated file. Use "pnpm script:generate-i18n-types" to update.
-export type LocaleKeys = 'auth.login.title' | 'auth.login.description' | 'auth.login.login-with-provider' | 'auth.login.no-account' | 'auth.login.register' | 'auth.email-validation-required.title' | 'auth.email-validation-required.description' | 'auth.legal-links.description' | 'auth.legal-links.terms' | 'auth.legal-links.privacy' | 'tags.no-tags.title' | 'tags.no-tags.description' | 'tags.no-tags.create-tag' | 'layout.menu.home' | 'layout.menu.documents' | 'layout.menu.tags' | 'layout.menu.integrations' | 'layout.menu.deleted-documents' | 'layout.menu.organization-settings' | 'demo.popup.description' | 'demo.popup.reset' | 'demo.popup.hide';
+// Do not manually edit this file.
+// This file is dynamically generated when the dev server runs (or using the `pnpm script:generate-i18n-types` command).
+// Keys are extracted from the en.yml file.
+// Source code : src/plugins/i18n-types/i18n-types.services.ts
+
+export type LocaleKeys =
+  | 'auth.request-password-reset.title'
+  | 'auth.request-password-reset.description'
+  | 'auth.request-password-reset.requested'
+  | 'auth.request-password-reset.back-to-login'
+  | 'auth.request-password-reset.form.email.label'
+  | 'auth.request-password-reset.form.email.placeholder'
+  | 'auth.request-password-reset.form.email.required'
+  | 'auth.request-password-reset.form.email.invalid'
+  | 'auth.request-password-reset.form.submit'
+  | 'auth.reset-password.title'
+  | 'auth.reset-password.description'
+  | 'auth.reset-password.reset'
+  | 'auth.reset-password.back-to-login'
+  | 'auth.reset-password.form.new-password.label'
+  | 'auth.reset-password.form.new-password.placeholder'
+  | 'auth.reset-password.form.new-password.required'
+  | 'auth.reset-password.form.new-password.min-length'
+  | 'auth.reset-password.form.new-password.max-length'
+  | 'auth.reset-password.form.submit'
+  | 'auth.email-provider.open'
+  | 'auth.login.title'
+  | 'auth.login.description'
+  | 'auth.login.login-with-provider'
+  | 'auth.login.no-account'
+  | 'auth.login.register'
+  | 'auth.login.form.email.label'
+  | 'auth.login.form.email.placeholder'
+  | 'auth.login.form.email.required'
+  | 'auth.login.form.email.invalid'
+  | 'auth.login.form.password.label'
+  | 'auth.login.form.password.placeholder'
+  | 'auth.login.form.password.required'
+  | 'auth.login.form.remember-me.label'
+  | 'auth.login.form.forgot-password.label'
+  | 'auth.login.form.submit'
+  | 'auth.register.title'
+  | 'auth.register.description'
+  | 'auth.register.register-with-email'
+  | 'auth.register.register-with-provider'
+  | 'auth.register.providers.google'
+  | 'auth.register.providers.github'
+  | 'auth.register.have-account'
+  | 'auth.register.login'
+  | 'auth.register.registration-disabled.title'
+  | 'auth.register.registration-disabled.description'
+  | 'auth.register.form.email.label'
+  | 'auth.register.form.email.placeholder'
+  | 'auth.register.form.email.required'
+  | 'auth.register.form.email.invalid'
+  | 'auth.register.form.password.label'
+  | 'auth.register.form.password.placeholder'
+  | 'auth.register.form.password.required'
+  | 'auth.register.form.password.min-length'
+  | 'auth.register.form.password.max-length'
+  | 'auth.register.form.name.label'
+  | 'auth.register.form.name.placeholder'
+  | 'auth.register.form.name.required'
+  | 'auth.register.form.name.max-length'
+  | 'auth.register.form.submit'
+  | 'auth.email-validation-required.title'
+  | 'auth.email-validation-required.description'
+  | 'auth.legal-links.description'
+  | 'auth.legal-links.terms'
+  | 'auth.legal-links.privacy'
+  | 'tags.no-tags.title'
+  | 'tags.no-tags.description'
+  | 'tags.no-tags.create-tag'
+  | 'layout.menu.home'
+  | 'layout.menu.documents'
+  | 'layout.menu.tags'
+  | 'layout.menu.tagging-rules'
+  | 'layout.menu.deleted-documents'
+  | 'layout.menu.organization-settings'
+  | 'layout.menu.api-keys'
+  | 'layout.menu.settings'
+  | 'layout.menu.account'
+  | 'layout.menu.general-settings'
+  | 'layout.menu.intake-emails'
+  | 'layout.menu.webhooks'
+  | 'layout.menu.members'
+  | 'layout.menu.invitations'
+  | 'tagging-rules.field.name'
+  | 'tagging-rules.field.content'
+  | 'tagging-rules.operator.equals'
+  | 'tagging-rules.operator.not-equals'
+  | 'tagging-rules.operator.contains'
+  | 'tagging-rules.operator.not-contains'
+  | 'tagging-rules.operator.starts-with'
+  | 'tagging-rules.operator.ends-with'
+  | 'tagging-rules.list.title'
+  | 'tagging-rules.list.description'
+  | 'tagging-rules.list.demo-warning'
+  | 'tagging-rules.list.no-tagging-rules.title'
+  | 'tagging-rules.list.no-tagging-rules.description'
+  | 'tagging-rules.list.no-tagging-rules.create-tagging-rule'
+  | 'tagging-rules.list.card.no-conditions'
+  | 'tagging-rules.list.card.one-condition'
+  | 'tagging-rules.list.card.conditions'
+  | 'tagging-rules.list.card.delete'
+  | 'tagging-rules.list.card.edit'
+  | 'tagging-rules.create.title'
+  | 'tagging-rules.create.success'
+  | 'tagging-rules.create.error'
+  | 'tagging-rules.create.submit'
+  | 'tagging-rules.form.name.label'
+  | 'tagging-rules.form.name.placeholder'
+  | 'tagging-rules.form.name.min-length'
+  | 'tagging-rules.form.name.max-length'
+  | 'tagging-rules.form.description.label'
+  | 'tagging-rules.form.description.placeholder'
+  | 'tagging-rules.form.description.max-length'
+  | 'tagging-rules.form.conditions.label'
+  | 'tagging-rules.form.conditions.description'
+  | 'tagging-rules.form.conditions.add-condition'
+  | 'tagging-rules.form.conditions.no-conditions.title'
+  | 'tagging-rules.form.conditions.no-conditions.description'
+  | 'tagging-rules.form.conditions.no-conditions.confirm'
+  | 'tagging-rules.form.conditions.no-conditions.cancel'
+  | 'tagging-rules.form.conditions.value.placeholder'
+  | 'tagging-rules.form.conditions.value.min-length'
+  | 'tagging-rules.form.tags.label'
+  | 'tagging-rules.form.tags.description'
+  | 'tagging-rules.form.tags.min-length'
+  | 'tagging-rules.form.tags.add-tag'
+  | 'tagging-rules.form.submit'
+  | 'tagging-rules.update.title'
+  | 'tagging-rules.update.error'
+  | 'tagging-rules.update.submit'
+  | 'tagging-rules.update.cancel'
+  | 'demo.popup.description'
+  | 'demo.popup.discord'
+  | 'demo.popup.discord-link-label'
+  | 'demo.popup.reset'
+  | 'demo.popup.hide'
+  | 'trash.delete-all.button'
+  | 'trash.delete-all.confirm.title'
+  | 'trash.delete-all.confirm.description'
+  | 'trash.delete-all.confirm.label'
+  | 'trash.delete-all.confirm.cancel'
+  | 'trash.delete.button'
+  | 'trash.delete.confirm.title'
+  | 'trash.delete.confirm.description'
+  | 'trash.delete.confirm.label'
+  | 'trash.delete.confirm.cancel'
+  | 'trash.deleted.success.title'
+  | 'trash.deleted.success.description'
+  | 'import-documents.title.error'
+  | 'import-documents.title.success'
+  | 'import-documents.title.pending'
+  | 'import-documents.title.none'
+  | 'import-documents.no-import-in-progress'
+  | 'api-errors.document.already_exists'
+  | 'api-errors.document.file_too_big'
+  | 'api-errors.intake_email.limit_reached'
+  | 'api-errors.user.max_organization_count_reached'
+  | 'api-errors.default'
+  | 'api-errors.organization.invitation_already_exists'
+  | 'api-errors.user.already_in_organization'
+  | 'api-errors.user.organization_invitation_limit_reached'
+  | 'api-errors.demo.not_available'
+  | 'api-keys.permissions.documents.title'
+  | 'api-keys.permissions.documents.documents:create'
+  | 'api-keys.permissions.documents.documents:read'
+  | 'api-keys.permissions.documents.documents:update'
+  | 'api-keys.permissions.documents.documents:delete'
+  | 'api-keys.permissions.tags.title'
+  | 'api-keys.permissions.tags.tags:create'
+  | 'api-keys.permissions.tags.tags:read'
+  | 'api-keys.permissions.tags.tags:update'
+  | 'api-keys.permissions.tags.tags:delete'
+  | 'api-keys.create.title'
+  | 'api-keys.create.description'
+  | 'api-keys.create.success'
+  | 'api-keys.create.back'
+  | 'api-keys.create.form.name.label'
+  | 'api-keys.create.form.name.placeholder'
+  | 'api-keys.create.form.name.required'
+  | 'api-keys.create.form.permissions.label'
+  | 'api-keys.create.form.permissions.required'
+  | 'api-keys.create.form.submit'
+  | 'api-keys.create.created.title'
+  | 'api-keys.create.created.description'
+  | 'api-keys.list.title'
+  | 'api-keys.list.description'
+  | 'api-keys.list.create'
+  | 'api-keys.list.empty.title'
+  | 'api-keys.list.empty.description'
+  | 'api-keys.list.card.last-used'
+  | 'api-keys.list.card.never'
+  | 'api-keys.list.card.created'
+  | 'api-keys.delete.success'
+  | 'api-keys.delete.confirm.title'
+  | 'api-keys.delete.confirm.message'
+  | 'api-keys.delete.confirm.confirm-button'
+  | 'api-keys.delete.confirm.cancel-button'
+  | 'webhooks.list.title'
+  | 'webhooks.list.description'
+  | 'webhooks.list.empty.title'
+  | 'webhooks.list.empty.description'
+  | 'webhooks.list.create'
+  | 'webhooks.list.card.last-triggered'
+  | 'webhooks.list.card.never'
+  | 'webhooks.list.card.created'
+  | 'webhooks.create.title'
+  | 'webhooks.create.description'
+  | 'webhooks.create.success'
+  | 'webhooks.create.back'
+  | 'webhooks.create.form.submit'
+  | 'webhooks.create.form.name.label'
+  | 'webhooks.create.form.name.placeholder'
+  | 'webhooks.create.form.name.required'
+  | 'webhooks.create.form.url.label'
+  | 'webhooks.create.form.url.placeholder'
+  | 'webhooks.create.form.url.required'
+  | 'webhooks.create.form.url.invalid'
+  | 'webhooks.create.form.secret.label'
+  | 'webhooks.create.form.secret.placeholder'
+  | 'webhooks.create.form.events.label'
+  | 'webhooks.create.form.events.required'
+  | 'webhooks.update.title'
+  | 'webhooks.update.description'
+  | 'webhooks.update.success'
+  | 'webhooks.update.submit'
+  | 'webhooks.update.cancel'
+  | 'webhooks.update.form.secret.placeholder'
+  | 'webhooks.update.form.secret.placeholder-redacted'
+  | 'webhooks.update.form.rotate-secret.button'
+  | 'webhooks.delete.success'
+  | 'webhooks.delete.confirm.title'
+  | 'webhooks.delete.confirm.message'
+  | 'webhooks.delete.confirm.confirm-button'
+  | 'webhooks.delete.confirm.cancel-button'
+  | 'webhooks.events.documents.document:created.description'
+  | 'webhooks.events.documents.document:deleted.description'
+  | 'organizations.members.title'
+  | 'organizations.members.description'
+  | 'organizations.members.invite-member'
+  | 'organizations.members.invite-member-disabled-tooltip'
+  | 'organizations.members.remove-from-organization'
+  | 'organizations.members.role'
+  | 'organizations.members.roles.owner'
+  | 'organizations.members.roles.admin'
+  | 'organizations.members.roles.member'
+  | 'organizations.members.delete.confirm.title'
+  | 'organizations.members.delete.confirm.message'
+  | 'organizations.members.delete.confirm.confirm-button'
+  | 'organizations.members.delete.confirm.cancel-button'
+  | 'organizations.members.delete.success'
+  | 'organizations.members.update-role.success'
+  | 'organizations.invite-member.title'
+  | 'organizations.invite-member.description'
+  | 'organizations.invite-member.form.email.label'
+  | 'organizations.invite-member.form.email.placeholder'
+  | 'organizations.invite-member.form.email.required'
+  | 'organizations.invite-member.form.role.label'
+  | 'organizations.invite-member.form.submit'
+  | 'organizations.invite-member.success.message'
+  | 'organizations.invite-member.success.description'
+  | 'organizations.invite-member.error.message'
+  | 'invitations.list.title'
+  | 'invitations.list.description'
+  | 'invitations.list.empty.title'
+  | 'invitations.list.empty.description'
+  | 'invitations.list.headers.organization'
+  | 'invitations.list.headers.created'
+  | 'invitations.list.headers.actions'
+  | 'invitations.list.actions.accept'
+  | 'invitations.list.actions.reject'
+  | 'invitations.list.actions.accept.success.message'
+  | 'invitations.list.actions.accept.success.description'
+  | 'invitations.list.actions.reject.success.message'
+  | 'invitations.list.actions.reject.success.description';

apps/papra-client/src/modules/intake-emails/intake-emails.services.ts

@@ -1,9 +1,10 @@
+import type { AsDto } from '../shared/http/http-client.types';
 import type { IntakeEmail } from './intake-emails.types';
 import { apiClient } from '../shared/http/api-client';
 import { coerceDates } from '../shared/http/http-client.models';
 
 export async function fetchIntakeEmails({ organizationId }: { organizationId: string }) {
-  const { intakeEmails } = await apiClient<{ intakeEmails: IntakeEmail[] }>({
+  const { intakeEmails } = await apiClient<{ intakeEmails: AsDto<IntakeEmail>[] }>({
     path: `/api/organizations/${organizationId}/intake-emails`,
     method: 'GET',
   });
@@ -14,7 +15,7 @@ export async function fetchIntakeEmails({ organizationId }: { organizationId: st
 }
 
 export async function createIntakeEmail({ organizationId }: { organizationId: string }) {
-  const { intakeEmail } = await apiClient<{ intakeEmail: IntakeEmail }>({
+  const { intakeEmail } = await apiClient<{ intakeEmail: AsDto<IntakeEmail> }>({
     path: `/api/organizations/${organizationId}/intake-emails`,
     method: 'POST',
   });
@@ -42,7 +43,7 @@ export async function updateIntakeEmail({
   isEnabled?: boolean;
   allowedOrigins?: string[];
 }) {
-  const { intakeEmail } = await apiClient<{ intakeEmail: IntakeEmail }>({
+  const { intakeEmail } = await apiClient<{ intakeEmail: AsDto<IntakeEmail> }>({
     path: `/api/organizations/${organizationId}/intake-emails/${intakeEmailId}`,
     method: 'PUT',
     body: {

apps/papra-client/src/modules/intake-emails/intake-emails.types.ts

@@ -6,5 +6,5 @@ export type IntakeEmail = {
   allowedOrigins: string[];
 
   createdAt: Date;
-  updatedAt: Date | undefined;
+  updatedAt: Date;
 };

apps/papra-client/src/modules/intake-emails/pages/intake-emails.page.tsx

@@ -1,5 +1,11 @@
 import type { DialogTriggerProps } from '@kobalte/core/dialog';
+import type { Component, JSX } from 'solid-js';
 import type { IntakeEmail } from '../intake-emails.types';
+import { safely } from '@corentinth/chisels';
+import { useParams } from '@solidjs/router';
+import { createQuery } from '@tanstack/solid-query';
+import { createSignal, For, Show, Suspense } from 'solid-js';
+import * as v from 'valibot';
 import { useConfig } from '@/modules/config/config.provider';
 import { useConfirmModal } from '@/modules/shared/confirm';
 import { createForm } from '@/modules/shared/form/form';
@@ -13,12 +19,6 @@ import { Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle, Di
 import { EmptyState } from '@/modules/ui/components/empty';
 import { createToast } from '@/modules/ui/components/sonner';
 import { TextField, TextFieldLabel, TextFieldRoot } from '@/modules/ui/components/textfield';
-import { safely } from '@corentinth/chisels';
-import { useParams } from '@solidjs/router';
-import { createQuery } from '@tanstack/solid-query';
-import { type Component, For, type JSX, Show, Suspense } from 'solid-js';
-import { createSignal } from 'solid-js';
-import * as v from 'valibot';
 import { createIntakeEmail, deleteIntakeEmail, fetchIntakeEmails, updateIntakeEmail } from '../intake-emails.services';
 
 const AllowedOriginsDialog: Component<{ children: (props: DialogTriggerProps) => JSX.Element; intakeEmails: IntakeEmail }> = (props) => {
@@ -133,12 +133,27 @@ export const IntakeEmailsPage: Component = () => {
 
   if (!config.intakeEmails.isEnabled) {
     return (
-      <Card class="p-6">
-        <h2 class="text-base font-bold">Intake Emails</h2>
+      <div class="p-6 max-w-screen-md mx-auto mt-10">
+
+        <h1 class="text-xl font-semibold">Intake Emails</h1>
+
         <p class="text-muted-foreground mt-1">
-          Intake emails are disabled on this instance. Please contact your administrator to enable them.
+          Intake emails address are used to automatically ingest emails into Papra. Just forward emails to the intake email address and their attachments will be added to your organization's documents.
         </p>
-      </Card>
+        <Card class="px-6 py-4 mt-4 flex items-center gap-4">
+          <div class="i-tabler-mail-off size-12 text-muted-foreground flex-shrink-0" />
+          <div>
+            <h2 class="text-base font-bold text-muted-foreground">Intake Emails are disabled</h2>
+            <p class="text-muted-foreground mt-1">
+              Intake emails are disabled on this instance. Please contact your administrator to enable them. See the
+              {' '}
+              <a href="https://docs.papra.app/guides/intake-emails-with-owlrelay/" target="_blank" class="text-primary">documentation</a>
+              {' '}
+              for more information.
+            </p>
+          </div>
+        </Card>
+      </div>
     );
   }
 
@@ -211,9 +226,9 @@ export const IntakeEmailsPage: Component = () => {
   };
 
   return (
-    <Card class="p-6">
+    <div class="p-6 max-w-screen-md mx-auto mt-10">
 
-      <h2 class="text-base font-bold">Intake Emails</h2>
+      <h1 class="text-xl font-semibold">Intake Emails</h1>
 
       <p class="text-muted-foreground mt-1">
         Intake emails address are used to automatically ingest emails into Papra. Just forward emails to the intake email address and their attachments will be added to your organization's documents.
@@ -264,7 +279,7 @@ export const IntakeEmailsPage: Component = () => {
               <div class="flex flex-col gap-2">
                 <For each={intakeEmails()}>
                   {intakeEmail => (
-                    <div class="flex items-center justify-between border rounded-lg p-4">
+                    <div class="flex items-center justify-between border rounded-lg p-4 bg-card">
                       <div class="flex items-center gap-4">
                         <div class="bg-muted size-9 rounded-lg flex items-center justify-center">
                           <div class={cn('i-tabler-mail size-5', intakeEmail.isEnabled ? 'text-primary' : 'text-muted-foreground')} />
@@ -342,6 +357,6 @@ export const IntakeEmailsPage: Component = () => {
           )}
         </Show>
       </Suspense>
-    </Card>
+    </div>
   );
 };

apps/papra-client/src/modules/invitations/composables/usePendingInvitationsCount.ts

@@ -0,0 +1,15 @@
+import { useQuery } from '@tanstack/solid-query';
+import { fetchPendingInvitationsCount } from '../invitations.services';
+
+export function usePendingInvitationsCount() {
+  const query = useQuery(() => ({
+    queryKey: ['invitations', 'count'],
+    staleTime: 1000 * 60 * 5, // 5 minutes
+    queryFn: fetchPendingInvitationsCount,
+  }));
+
+  return {
+    ...query,
+    getPendingInvitationsCount: () => query.data?.pendingInvitationsCount ?? 0,
+  };
+}

apps/papra-client/src/modules/invitations/invitations.services.ts

@@ -0,0 +1,47 @@
+import type { Organization } from '../organizations/organizations.types';
+import { apiClient } from '../shared/http/api-client';
+import { coerceDates } from '../shared/http/http-client.models';
+
+export async function fetchInvitations() {
+  const { invitations } = await apiClient<{ invitations: { id: string; organization: Organization }[] }>({
+    path: '/api/invitations',
+    method: 'GET',
+  });
+
+  return {
+    invitations: invitations.map(i => ({
+      ...coerceDates(i),
+      organization: coerceDates(i.organization),
+    })),
+  };
+}
+
+export async function fetchPendingInvitationsCount() {
+  const { pendingInvitationsCount } = await apiClient<{ pendingInvitationsCount: number }>({
+    path: '/api/invitations/count',
+    method: 'GET',
+  });
+
+  return { pendingInvitationsCount };
+}
+
+export async function cancelInvitation({ invitationId }: { invitationId: string }) {
+  await apiClient({
+    path: `/api/invitations/${invitationId}`,
+    method: 'DELETE',
+  });
+}
+
+export async function acceptInvitation({ invitationId }: { invitationId: string }) {
+  await apiClient({
+    path: `/api/invitations/${invitationId}/accept`,
+    method: 'POST',
+  });
+}
+
+export async function rejectInvitation({ invitationId }: { invitationId: string }) {
+  await apiClient({
+    path: `/api/invitations/${invitationId}/reject`,
+    method: 'POST',
+  });
+}

apps/papra-client/src/modules/invitations/pages/invitations.page.tsx

@@ -0,0 +1,106 @@
+import type { Component } from 'solid-js';
+import { useMutation, useQuery } from '@tanstack/solid-query';
+import { createSolidTable, flexRender, getCoreRowModel, getPaginationRowModel } from '@tanstack/solid-table';
+import { For, Show } from 'solid-js';
+import { useI18n } from '@/modules/i18n/i18n.provider';
+import { timeAgo } from '@/modules/shared/date/time-ago';
+import { queryClient } from '@/modules/shared/query/query-client';
+import { Button } from '@/modules/ui/components/button';
+import { EmptyState } from '@/modules/ui/components/empty';
+import { createToast } from '@/modules/ui/components/sonner';
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@/modules/ui/components/table';
+import { acceptInvitation, fetchInvitations, rejectInvitation } from '../invitations.services';
+
+export const InvitationsPage: Component = () => {
+  const { t } = useI18n();
+
+  const query = useQuery(() => ({
+    queryKey: ['invitations'],
+    queryFn: fetchInvitations,
+  }));
+
+  const acceptInvitationMutation = useMutation(() => ({
+    mutationFn: acceptInvitation,
+    onSuccess: async () => {
+      await queryClient.invalidateQueries({ queryKey: ['invitations'] });
+      await queryClient.invalidateQueries({ queryKey: ['organizations'] });
+
+      createToast({
+        message: t('invitations.list.actions.accept.success.message'),
+        description: t('invitations.list.actions.accept.success.description'),
+      });
+    },
+  }));
+
+  const rejectInvitationMutation = useMutation(() => ({
+    mutationFn: rejectInvitation,
+    onSuccess: async () => {
+      await queryClient.invalidateQueries({ queryKey: ['invitations'] });
+
+      createToast({
+        message: t('invitations.list.actions.reject.success.message'),
+        description: t('invitations.list.actions.reject.success.description'),
+      });
+    },
+  }));
+
+  const table = createSolidTable({
+    get data() {
+      return query.data?.invitations ?? [];
+    },
+    columns: [
+      {
+        header: t('invitations.list.headers.organization'),
+        accessorKey: 'organization.name',
+      },
+      {
+        header: t('invitations.list.headers.created'),
+        accessorKey: 'createdAt',
+        cell: data => <time dateTime={data.getValue()}>{timeAgo({ date: data.getValue() })}</time>,
+      },
+      {
+        header: () => <div class="text-right">{t('invitations.list.headers.actions')}</div>,
+        id: 'actions',
+        cell: data => (
+          <div class="flex items-center justify-end gap-2">
+            <Button size="sm" onClick={() => acceptInvitationMutation.mutate({ invitationId: data.row.original.id })}>
+              {t('invitations.list.actions.accept')}
+            </Button>
+            <Button size="sm" variant="destructive" onClick={() => rejectInvitationMutation.mutate({ invitationId: data.row.original.id })}>
+              {t('invitations.list.actions.reject')}
+            </Button>
+          </div>
+        ),
+      },
+    ],
+    getCoreRowModel: getCoreRowModel(),
+    getPaginationRowModel: getPaginationRowModel(),
+  });
+  return (
+    <div class="p-6 mt-12 pb-32 mx-auto max-w-xl w-full">
+      <div class="border-b pb-4 mb-6">
+        <h1 class="text-2xl font-semibold mb-1">{t('invitations.list.title')}</h1>
+        <p class="text-muted-foreground">{t('invitations.list.description')}</p>
+      </div>
+
+      <Show when={query.data?.invitations.length} fallback={<EmptyState title={t('invitations.list.empty.title')} icon="i-tabler-mail" description={t('invitations.list.empty.description')} />}>
+        <Table>
+          <TableHeader>
+            <For each={table.getHeaderGroups()}>
+              {headerGroup => (
+                <TableRow>
+                  <For each={headerGroup.headers}>{header => <TableHead>{flexRender(header.column.columnDef.header, header.getContext())}</TableHead>}</For>
+                </TableRow>
+              )}
+            </For>
+          </TableHeader>
+          <TableBody>
+            <For each={table.getRowModel().rows}>
+              {row => <TableRow>{row.getVisibleCells().map(cell => <TableCell>{flexRender(cell.column.columnDef.cell, cell.getContext())}</TableCell>)}</TableRow>}
+            </For>
+          </TableBody>
+        </Table>
+      </Show>
+    </div>
+  );
+};

apps/papra-client/src/modules/organizations/components/create-organization-form.component.tsx

@@ -1,10 +1,10 @@
 import type { Component } from 'solid-js';
+import { safely } from '@corentinth/chisels';
+import * as v from 'valibot';
 import { createForm } from '@/modules/shared/form/form';
 import { isHttpErrorWithCode } from '@/modules/shared/http/http-errors';
 import { Button } from '@/modules/ui/components/button';
 import { TextField, TextFieldLabel, TextFieldRoot } from '@/modules/ui/components/textfield';
-import { safely } from '@corentinth/chisels';
-import * as v from 'valibot';
 import { organizationNameSchema } from '../organizations.schemas';
 
 export const CreateOrganizationForm: Component<{

apps/papra-client/src/modules/organizations/organizations.composables.tsx

@@ -1,7 +1,9 @@
+import { useNavigate, useParams } from '@solidjs/router';
+import { useQuery } from '@tanstack/solid-query';
 import { queryClient } from '@/modules/shared/query/query-client';
 import { createToast } from '@/modules/ui/components/sonner';
-import { useNavigate } from '@solidjs/router';
-import { createOrganization, deleteOrganization, updateOrganization } from './organizations.services';
+import { ORGANIZATION_ROLES } from './organizations.constants';
+import { createOrganization, deleteOrganization, getMembership, updateOrganization } from './organizations.services';
 
 export function useCreateOrganization() {
   const navigate = useNavigate();
@@ -50,3 +52,29 @@ export function useDeleteOrganization() {
     },
   };
 }
+
+export function useCurrentUserRole({ organizationId }: { organizationId?: string } = {}) {
+  const params = useParams();
+
+  const getOrganizationId = () => organizationId ?? params.organizationId;
+
+  const query = useQuery(() => ({
+    queryKey: ['organizations', getOrganizationId(), 'members', 'me'],
+    queryFn: () => getMembership({ organizationId: getOrganizationId() }),
+  }));
+
+  const getRole = () => query.data?.member.role;
+  const getIsMember = () => getRole() === ORGANIZATION_ROLES.MEMBER;
+  const getIsAdmin = () => getRole() === ORGANIZATION_ROLES.ADMIN;
+  const getIsOwner = () => getRole() === ORGANIZATION_ROLES.OWNER;
+  const getIsAtLeastAdmin = () => getIsAdmin() || getIsOwner();
+
+  return {
+    query,
+    getRole,
+    getIsMember,
+    getIsAdmin,
+    getIsOwner,
+    getIsAtLeastAdmin,
+  };
+}

apps/papra-client/src/modules/organizations/organizations.constants.ts

@@ -0,0 +1,7 @@
+export const ORGANIZATION_ROLES = {
+  OWNER: 'owner',
+  ADMIN: 'admin',
+  MEMBER: 'member',
+} as const;
+
+export const ORGANIZATION_ROLES_LIST = Object.values(ORGANIZATION_ROLES);

apps/papra-client/src/modules/organizations/organizations.models.ts

@@ -0,0 +1,26 @@
+import type { OrganizationMemberRole } from './organizations.types';
+import { ORGANIZATION_ROLES } from './organizations.constants';
+
+export function getIsMemberRoleDisabled({
+  currentUserRole,
+  memberRole,
+  targetRole,
+}: {
+  currentUserRole?: OrganizationMemberRole;
+  memberRole: OrganizationMemberRole;
+  targetRole: OrganizationMemberRole;
+}) {
+  if (currentUserRole === ORGANIZATION_ROLES.MEMBER) {
+    return true;
+  }
+
+  if (memberRole === ORGANIZATION_ROLES.OWNER) {
+    return true;
+  }
+
+  if (targetRole === ORGANIZATION_ROLES.OWNER) {
+    return true;
+  }
+
+  return false;
+}

apps/papra-client/src/modules/organizations/organizations.services.ts

@@ -1,65 +1,59 @@
-import type { Organization } from './organizations.types';
+import type { AsDto } from '../shared/http/http-client.types';
+import type { Organization, OrganizationMember, OrganizationMemberRole } from './organizations.types';
 import { apiClient } from '../shared/http/api-client';
+import { coerceDates } from '../shared/http/http-client.models';
+
+export async function inviteOrganizationMember({ organizationId, email, role }: { organizationId: string; email: string; role: OrganizationMemberRole }) {
+  await apiClient({
+    path: `/api/organizations/${organizationId}/members/invitations`,
+    method: 'POST',
+    body: { email, role },
+  });
+}
 
 export async function fetchOrganizations() {
-  const { organizations } = await apiClient<{ organizations: Organization[] }>({
+  const { organizations } = await apiClient<{ organizations: AsDto<Organization>[] }>({
     path: '/api/organizations',
     method: 'GET',
   });
 
   return {
-    organizations: organizations.map(organization => ({
-      ...organization,
-      createdAt: new Date(organization.createdAt),
-      updatedAt: organization.updatedAt ? new Date(organization.updatedAt) : undefined,
-    })),
+    organizations: organizations.map(coerceDates),
   };
 }
 
 export async function createOrganization({ name }: { name: string }) {
-  const { organization } = await apiClient<{ organization: Organization }>({
+  const { organization } = await apiClient<{ organization: AsDto<Organization> }>({
     path: '/api/organizations',
     method: 'POST',
     body: { name },
   });
 
   return {
-    organization: {
-      ...organization,
-      createdAt: new Date(organization.createdAt),
-      updatedAt: organization.updatedAt ? new Date(organization.updatedAt) : undefined,
-    },
+    organization: coerceDates(organization),
   };
 }
 
 export async function updateOrganization({ organizationId, name }: { organizationId: string; name: string }) {
-  const { organization } = await apiClient<{ organization: Organization }>({
+  const { organization } = await apiClient<{ organization: AsDto<Organization> }>({
     path: `/api/organizations/${organizationId}`,
     method: 'PUT',
     body: { name },
   });
 
   return {
-    organization: {
-      ...organization,
-      createdAt: new Date(organization.createdAt),
-      updatedAt: organization.updatedAt ? new Date(organization.updatedAt) : undefined,
-    },
+    organization: coerceDates(organization),
   };
 }
 
 export async function fetchOrganization({ organizationId }: { organizationId: string }) {
-  const { organization } = await apiClient<{ organization: Organization }>({
+  const { organization } = await apiClient<{ organization: AsDto<Organization> }>({
     path: `/api/organizations/${organizationId}`,
     method: 'GET',
   });
 
   return {
-    organization: {
-      ...organization,
-      createdAt: new Date(organization.createdAt),
-      updatedAt: organization.updatedAt ? new Date(organization.updatedAt) : undefined,
-    },
+    organization: coerceDates(organization),
   };
 }
 
@@ -69,3 +63,44 @@ export async function deleteOrganization({ organizationId }: { organizationId: s
     method: 'DELETE',
   });
 }
+
+export async function fetchOrganizationMembers({ organizationId }: { organizationId: string }) {
+  const { members } = await apiClient<{ members: AsDto<OrganizationMember>[] }>({
+    path: `/api/organizations/${organizationId}/members`,
+    method: 'GET',
+  });
+
+  return {
+    members: members.map(({ user, ...rest }) => coerceDates({ user: coerceDates(user), ...rest })),
+  };
+}
+
+export async function removeOrganizationMember({ organizationId, memberId }: { organizationId: string; memberId: string }) {
+  await apiClient({
+    path: `/api/organizations/${organizationId}/members/${memberId}`,
+    method: 'DELETE',
+  });
+}
+
+export async function getMembership({ organizationId }: { organizationId: string }) {
+  const { member } = await apiClient<{ member: AsDto<OrganizationMember> }>({
+    path: `/api/organizations/${organizationId}/members/me`,
+    method: 'GET',
+  });
+
+  return {
+    member: coerceDates(member),
+  };
+}
+
+export async function updateOrganizationMemberRole({ organizationId, memberId, role }: { organizationId: string; memberId: string; role: OrganizationMemberRole }) {
+  const { member } = await apiClient<{ member: AsDto<OrganizationMember> }>({
+    path: `/api/organizations/${organizationId}/members/${memberId}`,
+    method: 'PATCH',
+    body: { role },
+  });
+
+  return {
+    member: coerceDates(member),
+  };
+}

apps/papra-client/src/modules/organizations/organizations.types.ts

@@ -1,6 +1,17 @@
+import type { User } from 'better-auth/types';
+
 export type Organization = {
   id: string;
   name: string;
   createdAt: Date;
-  updatedAt?: Date;
+  updatedAt: Date;
 };
+
+export type OrganizationMember = {
+  id: string;
+  organizationId: string;
+  user: User;
+  role: OrganizationMemberRole;
+};
+
+export type OrganizationMemberRole = 'owner' | 'admin' | 'member';

apps/papra-client/src/modules/organizations/pages/create-first-organization.page.tsx

@@ -1,7 +1,8 @@
-import { useCurrentUser } from '@/modules/users/composables/useCurrentUser';
+import type { Component } from 'solid-js';
 import { useNavigate } from '@solidjs/router';
 import { createQuery } from '@tanstack/solid-query';
-import { type Component, createEffect, on } from 'solid-js';
+import { createEffect, on } from 'solid-js';
+import { useCurrentUser } from '@/modules/users/composables/useCurrentUser';
 import { CreateOrganizationForm } from '../components/create-organization-form.component';
 import { useCreateOrganization } from '../organizations.composables';
 import { fetchOrganizations } from '../organizations.services';

apps/papra-client/src/modules/organizations/pages/create-organization.page.tsx

@@ -1,6 +1,6 @@
 import type { Component } from 'solid-js';
-import { Button } from '@/modules/ui/components/button';
 import { A } from '@solidjs/router';
+import { Button } from '@/modules/ui/components/button';
 import { CreateOrganizationForm } from '../components/create-organization-form.component';
 import { useCreateOrganization } from '../organizations.composables';
 

apps/papra-client/src/modules/organizations/pages/invite-member.page.tsx

@@ -0,0 +1,170 @@
+import type { Component } from 'solid-js';
+import { setValue } from '@modular-forms/solid';
+import { useNavigate, useParams } from '@solidjs/router';
+import { useMutation } from '@tanstack/solid-query';
+import { onMount, Show } from 'solid-js';
+import * as v from 'valibot';
+import { useI18n } from '@/modules/i18n/i18n.provider';
+import { createForm } from '@/modules/shared/form/form';
+import { useI18nApiErrors } from '@/modules/shared/http/composables/i18n-api-errors';
+import { queryClient } from '@/modules/shared/query/query-client';
+import { Button } from '@/modules/ui/components/button';
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from '@/modules/ui/components/select';
+import { createToast } from '@/modules/ui/components/sonner';
+import {
+  TextField,
+  TextFieldLabel,
+  TextFieldRoot,
+} from '@/modules/ui/components/textfield';
+import { useCurrentUserRole } from '../organizations.composables';
+import { ORGANIZATION_ROLES } from '../organizations.constants';
+import { inviteOrganizationMember } from '../organizations.services';
+
+type InvitableRole = 'member' | 'admin';
+
+export const InviteMemberPage: Component = () => {
+  const { t } = useI18n();
+  const params = useParams();
+  const { getErrorMessage } = useI18nApiErrors({ t });
+  const { getIsAtLeastAdmin } = useCurrentUserRole({ organizationId: params.organizationId });
+  const navigate = useNavigate();
+
+  onMount(() => {
+    if (!getIsAtLeastAdmin()) {
+      navigate(`/organizations/${params.organizationId}`);
+    }
+  });
+
+  const tRole = (role: InvitableRole) => t(`organizations.members.roles.${role}`);
+
+  const inviteMemberMutation = useMutation(() => ({
+    mutationFn: ({ email, role }: { email: string; role: InvitableRole }) =>
+      inviteOrganizationMember({
+        organizationId: params.organizationId,
+        email,
+        role,
+      }),
+    onSuccess: () => {
+      queryClient.invalidateQueries({
+        queryKey: ['organizations', params.organizationId, 'invitations'],
+      });
+      createToast({
+        message: t('organizations.invite-member.success.message'),
+        description: t('organizations.invite-member.success.description'),
+      });
+    },
+    onError: (error) => {
+      createToast({
+        message: t('organizations.invite-member.error.message'),
+        description: getErrorMessage({ error }),
+        type: 'error',
+      });
+    },
+  }));
+
+  const { Form, Field, form } = createForm({
+    schema: v.object({
+      email: v.pipe(
+        v.string(),
+        v.trim(),
+        v.email(t('organizations.invite-member.form.email.required')),
+        v.toLowerCase(),
+      ),
+      role: v.picklist([ORGANIZATION_ROLES.MEMBER, ORGANIZATION_ROLES.ADMIN]),
+    }),
+    initialValues: {
+      role: ORGANIZATION_ROLES.MEMBER,
+    },
+    onSubmit: async ({ email, role }) => {
+      inviteMemberMutation.mutate({ email, role });
+    },
+  });
+
+  return (
+    <div class="p-6 max-w-screen-md mx-auto mt-4">
+      <div class="border-b mb-6 pb-4">
+        <h1 class="text-xl font-bold">
+          {t('organizations.invite-member.title')}
+        </h1>
+        <p class="text-sm text-muted-foreground">
+          {t('organizations.invite-member.description')}
+        </p>
+      </div>
+
+      <div class="mt-10 max-w-xs mx-auto">
+        <Form>
+          <Field name="email">
+            {(field, inputProps) => (
+              <TextFieldRoot class="flex flex-col mb-6">
+                <TextFieldLabel for="email">
+                  {t('organizations.invite-member.form.email.label')}
+                </TextFieldLabel>
+                <TextField
+                  type="email"
+                  id="email"
+                  placeholder={t(
+                    'organizations.invite-member.form.email.placeholder',
+                  )}
+                  {...inputProps}
+                />
+                {field.error && (
+                  <div class="text-red-500 text-sm">{field.error}</div>
+                )}
+              </TextFieldRoot>
+            )}
+          </Field>
+
+          <Field name="role">
+            {field => (
+              <div>
+                <label for="role" class="text-sm font-medium mb-1 block">
+                  {t('organizations.invite-member.form.role.label')}
+                </label>
+                <Select
+                  id="role"
+                  options={[
+                    ORGANIZATION_ROLES.MEMBER,
+                    ORGANIZATION_ROLES.ADMIN,
+                  ]}
+                  itemComponent={props => (
+                    <SelectItem item={props.item}>
+                      {tRole(props.item.rawValue)}
+                    </SelectItem>
+                  )}
+                  value={field.value}
+                  onChange={value =>
+                    setValue(form, 'role', value as InvitableRole)}
+                >
+                  <SelectTrigger>
+                    <SelectValue<string>>
+                      {state =>
+                        tRole(state.selectedOption() as InvitableRole)}
+                    </SelectValue>
+                  </SelectTrigger>
+                  <SelectContent />
+                </Select>
+              </div>
+            )}
+          </Field>
+
+          <Button type="submit" class="w-full mt-6">
+            {t('organizations.invite-member.form.submit')}
+            <div class="i-tabler-send size-4 ml-1" />
+          </Button>
+
+          <Show when={inviteMemberMutation.isError}>
+            <div class="text-red-500 text-sm">
+              {getErrorMessage({ error: inviteMemberMutation.error })}
+            </div>
+          </Show>
+        </Form>
+      </div>
+    </div>
+  );
+};