Watch

No description

Python 78.8%
Jinja 7.1%
Shell 7.1%
CSS 6.5%
Dockerfile 0.5%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
François Pelletier 46df396a21 chore(app): sync source changes		2026-09-08 02:05:05 +00:00
app	chore(app): sync source changes	2026-09-08 02:05:05 +00:00
conf	Add Apache 2.0 copyright headers to all files	2026-08-26 00:31:18 -04:00
scripts	feat: deploy engine and jevalideca themes separately	2026-08-31 22:10:36 +00:00
.env.local.example	feat: manage daily output-cleanup timer from the package (install/upgrade/restore/remove)	2026-08-01 21:06:18 +00:00
.gitignore	feat: manage daily output-cleanup timer from the package (install/upgrade/restore/remove)	2026-08-01 21:06:18 +00:00
apply_local_env.sh	Add Apache 2.0 copyright headers to all files	2026-08-26 00:31:18 -04:00
build.sh	Add Apache 2.0 copyright headers to all files	2026-08-26 00:31:18 -04:00
CHANGELOG.md	chore: sync package version with upstream fabriquedoc v2.6.2	2026-08-31 22:10:06 +00:00
LICENSE	feat: initial YunoHost package for FabriqueDoc v2.0.0	2026-06-26 22:47:12 -04:00
manifest.json	feat: deploy engine and jevalideca themes separately	2026-08-31 22:10:36 +00:00
README.md	feat: deploy engine and jevalideca themes separately	2026-08-31 22:10:36 +00:00

README.md

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 lives in the fabriquedoc-engine repository. The YunoHost scripts clone that engine and then install only the themes from fabriquedoc-theme-jevalideca.

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, Bluesky, Pinterest, Google Business)
Presentation formats (16:9, 4:3)
Print formats (A4, US Letter)
Export to PDF, PNG, JPG, WebP, GIF, MP4, WebM, PPTX, ODP, DOCX, XLSX
Custom dimensions
Gradio web UI at /ui/
REST API at /generer/
MCP protocol support at /mcp/
Engine source from partage/fabriquedoc-engine
Je valide ça themes from francois/fabriquedoc-theme-jevalideca only

Accounts & API Keys

Access to the MCP API is managed with durable API keys:

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

Example MCP configuration:

{
  "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. Configure in the YunoHost web admin (App Configuration > Email) or via CLI:

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

Settings are stored in <install_dir>/fabriquedoc.env and persist across upgrades.

Source repositories

The package deliberately keeps the engine and themes separate:

partage/fabriquedoc-engine              -> install_dir/app
francois/fabriquedoc-theme-jevalideca  -> install_dir/app/backend/themes/*

Only theme repository directories containing theme.yaml are copied. Examples, generated documents, and helper scripts are not installed.

Configuration

The app runs as a systemd service and is proxied through nginx. Configuration is available via the YunoHost admin panel or the config panel at /etc/yunohost/apps/$app/config_panel.toml.