{ "version": "https://jsonfeed.org/version/1.1", "title": "Cecil - Deploy", "home_page_url": "https://cecil-945.pages.dev/documentation/deploy/", "feed_url": "https://cecil-945.pages.dev/documentation/deploy/feed.json", "description": "Deploy your static website to Jamstack platforms, through continuous deployment or to a static hosting.", "icon": "https://cecil-945.pages.dev/favicon.7ff4b89eec6dad139a7d2d6561543285.png", "favicon": "https://cecil-945.pages.dev/thumbnails/64x/favicon.7ff4b89eec6dad139a7d2d6561543285.png", "language": "en", "items": [ { "id": "https://cecil-945.pages.dev/documentation/deploy/jamstack-platforms/", "url": "https://cecil-945.pages.dev/documentation/deploy/jamstack-platforms/", "title": "Jamstack platforms", "summary": "Netlify, Vercel, statichost, Cloudflare Pages, Render.", "date_published": "2020-12-19T00:00:00+00:00", "date_modified": "2026-10-14T00:00:00+00:00","content_text": "Jamstack platforms\nJamstack platforms can build and deploy your Cecil site automatically on each push to your Git repository.\nNetlify\n\nA powerful serverless platform with an intuitive git-based workflow. Automated deployments, shareable previews, and much more.\n\n➡️ https:\/\/www.netlify.com\nnetlify.toml:\n[build]\n publish = \"_site\"\n command = \"curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\"\n[context.production.environment]\n CECIL_ENV = \"production\"\n[context.deploy-preview.environment]\n CECIL_ENV = \"preview\"\nOfficial documentation\nVercel\n\nVercel combines the best developer experience with an obsessive focus on end-user performance.\n\n➡️ https:\/\/vercel.com\nvercel.json:\n{\n \"buildCommand\": \"curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\",\n \"outputDirectory\": \"_site\"\n}\nOfficial documentation\nstatichost\n\nModern static site hosting with European servers and absolutely no personal data collection!\n\n➡️ https:\/\/statichost.eu\nstatichost.yml:\nimage: wordpress:cli-php8.4\ncommand: curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\npublic: _site\nOfficial documentation\nCloudflare Pages\nCloudflare Pages doesn’t provide PHP: the build script uses the Cecil standalone binary instead, and installs themes from composer.lock.\n\nCloudflare Pages is a JAMstack platform for frontend developers to collaborate and deploy websites.\n\n➡️ https:\/\/pages.cloudflare.com\nBuild configurations:\n\nFramework preset: None\nBuild command: curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\nBuild output directory: _site\n\nOfficial documentation\nRender\nRender only provides PHP 7.3: the build script uses the Cecil standalone binary instead, and installs themes from composer.lock.\n\nRender is a unified cloud to build and run all your apps and websites with free TLS certificates, global CDN, private networks and auto deploys from Git.\n\n➡️ https:\/\/render.com\nrender.yaml:\npreviewsEnabled: true\nservices:\n - type: web\n name: Cecil\n env: static\n buildCommand: curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\n staticPublishPath: _site\n pullRequestPreviewsEnabled: true\nOfficial documentation", "content_html": "

Jamstack platforms

\n

Jamstack platforms can build and deploy your Cecil site automatically on each push to your Git repository.

\n

Netlify

\n
\n

A powerful serverless platform with an intuitive git-based workflow. Automated deployments, shareable previews, and much more.

\n
\n

➡️ https://www.netlify.com

\n

netlify.toml:

\n
[build]\n  publish = \"_site\"\n  command = \"curl -sSOL https://cecil.app/build.sh && bash ./build.sh\"\n[context.production.environment]\n  CECIL_ENV = \"production\"\n[context.deploy-preview.environment]\n  CECIL_ENV = \"preview\"
\n

Official documentation

\n

Vercel

\n
\n

Vercel combines the best developer experience with an obsessive focus on end-user performance.

\n
\n

➡️ https://vercel.com

\n

vercel.json:

\n
{\n  \"buildCommand\": \"curl -sSOL https://cecil.app/build.sh && bash ./build.sh\",\n  \"outputDirectory\": \"_site\"\n}
\n

Official documentation

\n

statichost

\n
\n

Modern static site hosting with European servers and absolutely no personal data collection!

\n
\n

➡️ https://statichost.eu

\n

statichost.yml:

\n
image: wordpress:cli-php8.4\ncommand: curl -sSOL https://cecil.app/build.sh && bash ./build.sh\npublic: _site
\n

Official documentation

\n

Cloudflare Pages

\n\n
\n

Cloudflare Pages is a JAMstack platform for frontend developers to collaborate and deploy websites.

\n
\n

➡️ https://pages.cloudflare.com

\n

Build configurations:

\n\n

Official documentation

\n

Render

\n\n
\n

Render is a unified cloud to build and run all your apps and websites with free TLS certificates, global CDN, private networks and auto deploys from Git.

\n
\n

➡️ https://render.com

\n

render.yaml:

\n
previewsEnabled: true\nservices:\n  - type: web\n    name: Cecil\n    env: static\n    buildCommand: curl -sSOL https://cecil.app/build.sh && bash ./build.sh\n    staticPublishPath: _site\n    pullRequestPreviewsEnabled: true
\n

Official documentation

", "language": "en" }, { "id": "https://cecil-945.pages.dev/documentation/deploy/continuous-deployment/", "url": "https://cecil-945.pages.dev/documentation/deploy/continuous-deployment/", "title": "Continuous build & deploy", "summary": "GitHub Pages and GitLab CI.", "date_published": "2020-12-19T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Continuous build & deploy\nContinuous integration services can build your site with Cecil and deploy it on each change to your repository.\nGitHub Pages\n\nWebsites for you and your projects, hosted directly from your GitHub repository. Just edit, push, and your changes are live.\n\n➡️ https:\/\/pages.github.com\n.github\/workflows\/build-and-deploy.yml:\nname: Build and deploy to GitHub Pages\non:\n push:\n branches: [master, main]\n workflow_dispatch:\nconcurrency:\n group: pages\n cancel-in-progress: true\njobs:\n build:\n runs-on: ubuntu-latest\n steps:\n - name: Checkout source\n uses: actions\/checkout@v6\n - name: Restore Cecil cache\n uses: actions\/cache\/restore@v5\n with:\n path: .\/.cache\n key: cecil-cache-\n restore-keys: |\n cecil-cache-\n - name: Build site\n uses: Cecilapp\/Cecil-Action@v4\n - name: Save Cecil cache\n uses: actions\/cache\/save@v5\n with:\n path: .\/.cache\n key: cecil-cache-${{ hashFiles('.\/.cache\/**\/*') }}\n deploy:\n needs: build\n permissions:\n pages: write\n id-token: write\n environment:\n name: github-pages\n url: ${{ steps.deployment.outputs.page_url }}\n runs-on: ubuntu-latest\n steps:\n - name: Deploy to GitHub Pages\n id: deployment\n uses: actions\/deploy-pages@v5\nOfficial documentation\nGitLab CI\n\nWith GitLab Pages, you can publish static websites directly from a repository in GitLab.\n\n➡️ https:\/\/about.gitlab.com\/solutions\/continuous-integration\/\n.gitlab-ci.yml:\nimage: wordpress:cli-php8.4\ntest:\n stage: test\n variables:\n CECIL_OUTPUT_DIR: test\n script:\n - curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\n artifacts:\n paths:\n - test\n except:\n - master\npages:\n stage: deploy\n variables:\n CECIL_ENV: production\n CECIL_OUTPUT_DIR: public\n script:\n - curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\n artifacts:\n paths:\n - public\n only:\n - master\ncache:\n paths:\n - composer-cache\/\n - vendor\/\n - .cache\/\nOfficial documentation", "content_html": "

Continuous build & deploy

\n

Continuous integration services can build your site with Cecil and deploy it on each change to your repository.

\n

GitHub Pages

\n
\n

Websites for you and your projects, hosted directly from your GitHub repository. Just edit, push, and your changes are live.

\n
\n

➡️ https://pages.github.com

\n

.github/workflows/build-and-deploy.yml:

\n
name: Build and deploy to GitHub Pages\non:\n  push:\n    branches: [master, main]\n  workflow_dispatch:\nconcurrency:\n  group: pages\n  cancel-in-progress: true\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Checkout source\n        uses: actions/checkout@v6\n      - name: Restore Cecil cache\n        uses: actions/cache/restore@v5\n        with:\n          path: ./.cache\n          key: cecil-cache-\n          restore-keys: |\n            cecil-cache-\n      - name: Build site\n        uses: Cecilapp/Cecil-Action@v4\n      - name: Save Cecil cache\n        uses: actions/cache/save@v5\n        with:\n          path: ./.cache\n          key: cecil-cache-${{ hashFiles('./.cache/**/*') }}\n  deploy:\n    needs: build\n    permissions:\n      pages: write\n      id-token: write\n    environment:\n      name: github-pages\n      url: ${{ steps.deployment.outputs.page_url }}\n    runs-on: ubuntu-latest\n    steps:\n      - name: Deploy to GitHub Pages\n        id: deployment\n        uses: actions/deploy-pages@v5
\n

Official documentation

\n

GitLab CI

\n
\n

With GitLab Pages, you can publish static websites directly from a repository in GitLab.

\n
\n

➡️ https://about.gitlab.com/solutions/continuous-integration/

\n

.gitlab-ci.yml:

\n
image: wordpress:cli-php8.4\ntest:\n  stage: test\n  variables:\n    CECIL_OUTPUT_DIR: test\n  script:\n    - curl -sSOL https://cecil.app/build.sh && bash ./build.sh\n  artifacts:\n    paths:\n     - test\n  except:\n   - master\npages:\n  stage: deploy\n  variables:\n    CECIL_ENV: production\n    CECIL_OUTPUT_DIR: public\n  script:\n    - curl -sSOL https://cecil.app/build.sh && bash ./build.sh\n  artifacts:\n    paths:\n      - public\n  only:\n    - master\ncache:\n  paths:\n    - composer-cache/\n    - vendor/\n    - .cache/
\n

Official documentation

", "language": "en" }, { "id": "https://cecil-945.pages.dev/documentation/deploy/static-hosting/", "url": "https://cecil-945.pages.dev/documentation/deploy/static-hosting/", "title": "Static hosting", "summary": "Deploy to a static hosting (Surge).", "date_published": "2020-12-19T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Static hosting\nThe built site can be uploaded as is to any static hosting service.\nSurge\n\nShipping web projects should be fast, easy, and low risk. Surge is static web publishing for Front-End Developers, right from the CLI.\n\n➡️ https:\/\/surge.sh\nTerminal:\nnpm install -g surge\nsurge _site\/\nOfficial documentation", "content_html": "

Static hosting

\n

The built site can be uploaded as is to any static hosting service.

\n

Surge

\n
\n

Shipping web projects should be fast, easy, and low risk. Surge is static web publishing for Front-End Developers, right from the CLI.

\n
\n

➡️ https://surge.sh

\n

Terminal:

\n
npm install -g surge\nsurge _site/
\n

Official documentation

", "language": "en" } ] }