Back to Pake

Pake Action

docs/pake-action.md

3.11.02.6 KB
Original Source

Pake Action

Transform any webpage into a lightweight desktop app with a single GitHub Actions step.

This guide shows how to use Pake as a GitHub Action in your own projects. For using our project's built-in GitHub Actions workflow, see GitHub Actions Usage.

Quick Start

yaml
- name: Build Pake App
  uses: tw93/Pake@v3
  with:
    url: "https://example.com"
    name: "MyApp"

Inputs

ParameterDescriptionRequiredDefault
urlTarget URL to package
nameApplication name
output-dirOutput directorydist
iconCustom app icon URL/path
widthWindow width1200
heightWindow height780
debugEnable debug modefalse

Outputs

OutputDescription
package-pathPath to the generated package

Examples

Basic Usage

yaml
name: Build Web App
on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: tw93/Pake@v3
        with:
          url: "https://weekly.tw93.fun"
          name: "WeeklyApp"

With Custom Icon

yaml
- uses: tw93/Pake@v3
  with:
    url: "https://example.com"
    name: "MyApp"
    icon: "https://example.com/icon.png"
    width: 1400
    height: 900

Multi-Platform Build

yaml
jobs:
  build:
    strategy:
      matrix:
        os: [ubuntu-latest, macos-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - uses: actions/checkout@v4
      - uses: tw93/Pake@v3
        with:
          url: "https://example.com"
          name: "CrossPlatformApp"

How It Works

  1. Auto Setup: Installs Rust, Node.js dependencies, builds Pake CLI
  2. Build App: Runs pake command with your parameters
  3. Package Output: Finds and moves the generated package to output directory

Supported Platforms

  • Linux: .deb packages (Ubuntu runners)
  • macOS: .app and .dmg packages (macOS runners)
  • Windows: .exe and .msi packages (Windows runners)

Use GitHub's matrix strategy to build for multiple platforms simultaneously.