Website and documentation of Cecil Desktop, built with Cecil and Tailwind CSS (compiled by tailwind-builder).
data/home.yml(English) anddata/home.fr.yml(French): all the page content (hero, features, pricing, FAQ)translations/messages.fr.yaml: UI strings of the templates (navigation, buttons, footer)cecil.yml: site options, including the download URL and version (download)assets/images/screenshots/: app screenshotspages/docs/: the documentation (/docs/), rendered with the Docs and FlexSearch themes, styled with the brand colors byassets/tailwind-docs.css; a feature of the homepage links to its page withdocs(a page ID, e.g.docs/content)pages/docs/12-changelog.md: the changelog (/docs/changelog/, layoutlayouts/changelog.html.twig), from the notes of the published releases of the app: itsrelease.ymlworkflow exports them asreleases.jsonnext to the update files (download.manifests), then builds the site again. Each version has an anchor (#v1.2.3), opened by Help › What's New in the app
To test the changelog locally, serve a releases.json ([{version, date, body}], newest first) and point the build at it: CECIL_DOWNLOAD_MANIFESTS=http://127.0.0.1:8099/ php cecil.phar build.
The site is built by Netlify with the Cecil build script (see netlify.toml): it downloads Cecil, runs composer install (which compiles the CSS) then builds the site.
The netlify theme component (installed in themes/ by composer install) generates the _redirects and _headers files; redirects are defined under netlify.redirects in cecil.yml (e.g. /download/* to the installers on Cloudflare R2).
netlify/functions/feedback.mjs (POST /api/feedback) receives the feedback sent from the app (Help › Send feedback) and creates an issue in the private repository of the app, labelled beta and bug / enhancement / question. Environment variables of the Netlify site:
GITHUB_TOKEN: fine-grained token, repositoryCecilapp/Desktoponly, permission "Issues: Read and write" (it expires: renew it)FEEDBACK_REPO(optional):Cecilapp/Desktopby default
Requests are rate limited (5 per minute and IP, config.rateLimit); the app's User-Agent (Cecil Desktop/…) is required.
netlify/functions/license.mjs (POST /api/license/{activate,validate,deactivate}) activates, validates and deactivates the license keys sold with Polar (its public license API, no API token), and answers with a token signed with Ed25519, verified by the app (App\Support\LicenseToken). A key Polar does not know anymore (refunded, revoked, machine deactivated) gives a signed invalid token. Polar's keys do not expire: the updates a license covers are counted here from the purchase. See docs/spikes/licensing.md of the app. Environment variables of the Netlify site:
POLAR_ORGANIZATION_ID: the organization selling the licensesLICENSE_SIGNING_KEY: the private key, its 32 bytes seed in base64 (php artisan license:keygenin the app, whose public key goes into itsconfig/license.php): keep it secretPOLAR_API(optional):https://sandbox-api.polar.shto test with Polar's sandboxPOLAR_BENEFIT_IDS(optional): the license key benefits accepted, separated by commas (default: any of the organization)LICENSE_UPDATES_DAYS(optional): how long the updates are covered after the purchase, 365 by default
Requests are rate limited (20 per minute and IP) and require the app's User-Agent.
Requirements: PHP 8.3+ and Composer.
composer install
curl -LO https://cecil.app/cecil.pharCompile the CSS and preview the site (in two terminals):
composer css:watch # assets/tailwind.css → assets/site.css (homepage)
composer css:watch:docs # assets/tailwind-docs.css → assets/styles.css (documentation, Docs theme)
composer serve # http://localhost:8000composer build # minified CSS + optimized site in _site/