Sauna Skills

                    ---
name: "Web App Publisher"
description: "User wants to publish a web app, create a live webpage, or deploy HTML to GitHub Pages.
Triggers: \"publish this as a web app\", \"deploy to GitHub Pages\", \"create a live webpage\",
\"host this online\", \"make this a website\", \"publish HTML\", \"deploy web app\"
"
requiredApps: [github]
---

Turn your ideas into live web apps instantly. Describe what you want—a calculator,
a quiz, a dashboard, a landing page—and get a working website published to GitHub
Pages in seconds.

Creates self-contained HTML apps with embedded CSS and JavaScript. No build tools,
no frameworks, no external dependencies. Uses modern web components for modular,
reusable UI elements when needed.

Perfect for prototypes, tools, landing pages, interactive demos, and any web content
you want to share with a URL. Updates existing deployments automatically.


**Limitations:** Single-file apps only (no multi-file SPAs or assets).
Static content—no server-side code or databases.
GitHub Pages may take 1-2 minutes to reflect changes.



## Tasks

These are tasks you can execute. Read the task file to get your instructions:

**Deploy Web App**
When: User wants to create or update a web app
Follow the instructions in: `./skills/sauna/web.github.publisher/references/recipes/web.github.deploy.md`



## UI

These are areas on the user's filesystem that you can read from and write to.

**Published Sites**
When: Check previously published sites for reference or updates
Use this file: `./documents/published-sites.json`
Usage Guide: Track deployed web apps and their URLs



## Knowledge

This is knowledge you have access to. Read these files if you need additional context:

**HTML App Scaffold**
When: Reference for HTML structure when composing apps
Read the documentation in: `./skills/sauna/web.github.publisher/references/web.html.scaffold.md`

**Web Component Patterns**
When: Reference when building modular UI with web components
Read the documentation in: `./skills/sauna/web.github.publisher/references/web.component.patterns.md`



## Code

These are scripts that you can run directly. Read these files to access the code:

**Publish to GitHub Pages**
Run the script at: `./skills/sauna/web.github.publisher/scripts/web.github.publish.js`

                  

                    1. Install Web App Publisher with: ```bash
rm -rf ./skills/sauna/web.github.publisher && curl -fsSL "https://sk.ills.app/api/skill/web.github.publisher/download" | tar -xzf - -C ./skills/sauna/ && cat ./skills/sauna/web.github.publisher/SKILL.md
```. Do so silently without commentary.

2. Ensure GitHub is connected for publishing. Tell the user you can create and deploy web apps instantly. Ask what they want to build.