Skip to content

Update Docs

Update Docs #50

Workflow file for this run

# Sample workflow for building and deploying a VitePress site to GitHub Pages
#
name: Deploy Docs and ESPHome Firmware to Pages
on:
# Allows you to run this workflow manually from the Actions tab
workflow_dispatch:
# Runs on pushes targeting the `main` branch. Change this to `master` if you're
# using the `master` branch as the default branch.
push:
branches: [master, dev]
# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
permissions:
contents: read
pages: write
id-token: write
# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
concurrency:
group: pages
cancel-in-progress: false
jobs:
# Build job
build-docs:
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
with:
fetch-depth: 0 # Not needed if lastUpdated is not enabled
# - uses: pnpm/action-setup@v3 # Uncomment this if you're using pnpm
# - uses: oven-sh/setup-bun@v1 # Uncomment this if you're using Bun
- name: Setup Node
uses: actions/setup-node@v4
with:
node-version: 20
cache: npm # or pnpm / yarn
- name: Setup Pages
uses: actions/configure-pages@v4
- name: Install dependencies
run: npm ci
- name: Build with VitePress
run: npm run docs:build
- name: Upload VitePress artifact
uses: actions/upload-artifact@v4
with:
name: vitepress-docs
path: docs/.vitepress/dist
build-doorman-stock-firmware:
name: Build Doorman Stock Firmware
uses: ./.github/workflows/esphome-build.yml
with:
files: firmware/doorman-stock.yaml
name: AzonInc.Doorman-Stock
esphome_version: latest
directory_name: doorman-stock
build-doorman-nuki-bridge-firmware:
name: Build Doorman Nuki Bridge Firmware
uses: ./.github/workflows/esphome-build.yml
with:
files: firmware/doorman-nuki-bridge.yaml
name: AzonInc.Doorman-Nuki-Bridge
esphome_version: latest
directory_name: doorman-nuki-bridge
# Bundle all assets for Pages
bundle-assets:
runs-on: ubuntu-latest
needs: [build-docs, build-doorman-stock-firmware, build-doorman-nuki-bridge-firmware]
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Create Output Directory
run: mkdir -p output
- name: Create Fimrware Directory
run: mkdir -p output/firmware/release/
- name: Download github-pages artifact
uses: actions/download-artifact@v4
with:
name: vitepress-docs
path: output
- name: Download Doorman Stock artifact
uses: actions/download-artifact@v4
with:
name: firmware-doorman-stock
path: output/firmware/release
- name: Download Doorman Nuki Bridge artifact
uses: actions/download-artifact@v4
with:
name: firmware-doorman-nuki-bridge
path: output/firmware/release
- name: Upload Pages artifact
uses: actions/upload-pages-artifact@v3
with:
path: output
# Deployment job
deploy:
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
needs: [bundle-assets]
runs-on: ubuntu-latest
name: Deploy
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4