FabriqueDoc for YunoHost

SVG-based document generation platform for social media, presentations, and print.

This repository contains only the YunoHost packaging (install/upgrade/restore scripts, systemd unit, nginx config, config panel). The application code itself lives in the upstream fabriquedoc repository and is cloned at install/upgrade time.

Installation

yunohost app install https://git.jevalide.ca/partage/fabriquedoc_ynh.git

Upgrade

yunohost app upgrade fabriquedoc -f https://git.jevalide.ca/partage/fabriquedoc_ynh.git

Features

• Markdown-to-SVG document generation
• Multiple social media formats (Instagram, Facebook, LinkedIn, Twitter, etc.)
• Presentation formats (slides 16:9, 4:3)
• Print formats (A4, Letter)
• PDF, PNG, JPG, WebP, GIF, MP4, WebM, PPTX, ODP export
• Custom dimensions
• Gradio web UI at /ui/
• REST API at /generer/
• MCP protocol support at /mcp/

Accounts & API keys

Access to the MCP API is managed with durable API keys (no more OAuth re-authentication):

1. Create an account at /accounts/register (email + password).
2. Confirm your email via the link sent to your inbox.
3. Log in at /accounts/login and create an API key (valid until revoked, or for one year by default).
4. Use the key as a Bearer token in your MCP client configuration.

Example MCP configuration (OpenCode, Claude Code, etc.):

{
  "mcpServers": {
    "fabriquedoc": {
      "type": "remote",
      "url": "https://your.domain/mcp",
      "headers": {
        "Authorization": "Bearer fd_..."
      }
    }
  }
}

The web UI shows this snippet ready-to-paste for each new key. Keys are stored hashed (SHA-256) and can be revoked at any time from /accounts/keys.

Email (SMTP)

Verification emails are sent via SMTP. The SMTP server and sender address can be set either:

• in the YunoHost web admin (app Configuration → Courriel panel), or

• via the YunoHost CLI, e.g.:

  yunohost app config set fabriquedoc smtp_host mail.your.domain
  yunohost app config set fabriquedoc mail_from noreply@your.domain
  yunohost app config set fabriquedoc smtp_port 587
  yunohost app config set fabriquedoc smtp_user myuser
  yunohost app config set fabriquedoc smtp_pass mypass
  

Both write the same settings file (<install_dir>/fabriquedoc.env), which is kept across app upgrades — your configuration is never reset when updating. The default is the local YunoHost mail server (localhost:25).

Configuration

The app runs as a systemd service and is proxied through nginx.

License

AGPL-3.0-or-later