Publish Static Site

Deploy static websites from Forgejo to your Hostsharing domain with zero configuration on our shared infrastructure.

Quickstart

Drop this workflow into your repository to get automatic preview deployments for every pull request on frg.stcld.eu:

name: Deploy Preview
on:
  pull_request:
concurrency:
  group: "pages"
  cancel-in-progress: false

jobs:
  preview:
    if: env.ACTIONS_ID_TOKEN_REQUEST_URL != ''
    runs-on: debian-stable
    enable-openid-connect: true
    steps:
      - uses: https://forge.sebatec.eu/actions/checkout@v7
        with:
          submodules: recursive
          fetch-depth: 0

      - uses: https://forge.sebatec.eu/actions/setup-node@v6

      - name: Install dependencies
        run: npm ci

      - name: Get deploy URL
        id: get-config
        uses: https://forge.sebatec.eu/actions/publish-static-site/get-config@v1

      - name: Build
        run: npm run build
        env:
          ASTRO_SITE: ${{ steps.get-config.outputs.site_url }}

      - name: Deploy to server
        uses: https://forge.sebatec.eu/actions/publish-static-site/deploy@v1
        with:
          directory: dist

Every pull request automatically receives a unique preview URL like https://<owner>-<repo>-<hash>.frg.stcld.eu. These URLs are cleaned up automatically when the pull request is closed.

Use Cases

• Preview pull requests with automatic subdomains.
• Deploy a single site to your own domain.
• Host multiple sites under one domain with custom paths.

Prerequisites

• Forgejo OIDC must be enabled for these actions to work. Set enable-openid-connect: true at the workflow or job level.

Learn More

• Tutorials — Step-by-step guides for first-time users.
• How-To Guides — Customize your deployment setup.
• Explanations — Understand how it works.
• Reference — Technical details for advanced users.

Contributing

1. Fork the repository.
2. Create a new branch:

   git checkout -b feature-branch
   

3. Make your changes and commit them:

   git commit -m "Description of your changes"
   

4. Push to your fork:

   git push origin feature-branch
   

5. Create a pull request.