HTMLStarter

static-pwa-boilerplate — HTML Starter Template

By gallaoro

A pure HTML static site starter template with Skeleton CSS, a Web App Manifest, and a Service Worker, ready to deploy to GitHub Pages.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

1 previews
Author preview
Author-provided preview

Preview provided in the project README.

One original preview is available. Open the full image to inspect the design.

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-03View source

What stands out

A quick read of the recorded project description.

01

Pure HTML static structure, editable and deployable without build tools

02

Includes Skeleton CSS and normalize, providing a basic responsive grid and typography

03

Includes manifest.json and a Service Worker registration script, with basic PWA configuration

04

Prebuilt thumbnail assets from 64 to 512 pixels and 1366x768

05

index.js provides initial code to obtain a pushSubscription, easing Web Push integration

Template Details

This template targets scenarios that need to quickly set up a static progressive web app (PWA). The repository provides index.html, manifest.json, serviceworker.js, and css, js, and img directories. The css directory contains Skeleton CSS, normalize, and custom styles, while img/thumb includes prebuilt thumbnails at 64, 144, 192, 512, and 1366x768 sizes.

Functionally, the template is already configured with a Web App Manifest and a basic Service Worker plus its registration script, and includes initial code to obtain a pushSubscription for integrating Web Push. Push notifications require external server support; the template itself does not provide a server-side implementation.

Usage is to clone the repository, rename the directory, modify manifest.json as needed, and then start writing pages; to add a page, simply add an HTML file in the root directory and link to it via /<page>.html. Deployment can follow the GitHub Pages instructions. The repository uses the MIT license, and third-party assets such as demo images must be checked separately for their own licensing.

HTMLStarter

Is it right for your project?

Use Cases

  • Quickly set up an installable static PWA site for personal or small projects
  • Serve as a starting point for learning Service Worker registration and Web App Manifest configuration
  • Publish static pages on GitHub Pages and test the PWA installation flow
  • Projects that need to reserve front-end code for later Web Push notification integration

Suitable For

  • Developers familiar with HTML and basic JavaScript who want manual control over file structure
  • Developers who need a lightweight static template without introducing frameworks or bundlers
  • Personal projects planning to use GitHub Pages for free static site hosting

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    After cloning the repository, rename the directory and modify the app information in manifest.json as needed

  2. 2

    To add a page, create an HTML file in the project root and link to it via the /<page>.html path

  3. 3

    Web Push notifications require setting up your own external server; the template only provides front-end subscription code

  4. 4

    For deployment, refer to the official GitHub Pages instructions and publish static files to the gh-pages branch

  5. 5

    Third-party assets such as demo images, fonts, and icons must be checked separately under their respective licenses

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version of a public repository under the MIT license; the free scope applies to that version's code and does not imply that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Web Push notification functionality requires setting up your own external server; the template only provides front-end subscription code and does not include a server-side implementation.
  • Deployment depends on the GitHub Pages service and requires a GitHub account; the template itself does not provide hosting.
  • Demo images, fonts, icons, and other third-party assets must be checked under their respective licenses; the code's MIT license alone cannot be used to judge them.
  • External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

Initial web push notification support (you will need a external server)

Original README

Follow the simple instructions on [Github pages website](https://pages.github.com/) to know how to deploy your pwa for free

Original README
https://github.com/gallaoro/static-pwa-boilerplate/blob/master/LICENSEhttps://github.com/gallaoro/static-pwa-boilerplate/blob/master/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-03. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
Partly documented · 68 / 100
Technologies
HTML
Website type
Starter
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2021-05-11
Screenshot last checked
2026-10-03

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies HTML as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Review declaration: [email protected] · 2026-10-04

Inspect the recorded source material

SHA-256: aa8486cb4aabce5455152afb7f854e95ce272f33b43522db6ed0ee8d33d94f91

2026-10-03T16:30:44.736Z

Source file / repository
# Basic html template for modern static progressive web apps

Ready to create a static [progressive web app](https://developers.google.com/web/progressive-web-apps/) with a manifest and a serviceworker, easily deployable with [Github pages](https://pages.github.com/).

Includes:

* Thumbnail images
* [Skeleton CSS](http://getskeleton.com/) + normalize
* Web app manifest
* Basic service worker + registration companion
* Initial web push notification support (you will need a external server)

#### DEMO: [https://gallaoro.github.io/static_pwa_boilerplate/](https://gallaoro.github.io/static_pwa_boilerplate/) or visit the gh-pages branch of this repository

![demo application](static.png "Installation prompt -> Installed notification -> PWA in application list -> PWA loading screen")

### Installation

* Install git `sudo apt-get install git`
* Clone the repo: `git clone https://github.com/lellefood/static_pwa_boilerplate.git`
* Rename directory: `mv static_pwa_boilerplate <new_project_name>`
* Change directory: `cd <new_project_name>`
* Modify the `manifest.json` with your informations
* Start writing your website

### Developing

#### Project folder stucture

```
root
├── css
│   └── skeleton.css
│   └── normalize.css
│   └── index.css
│
├── js
│   └── index.js
│
├── img
│   └── thumb
│       └── 64.png
│       └── 144.png
│       └── 192.png
│       └── 512.png
│       └── 1366x768.png
│
├── index.html
├── manifest.json
├── README.md
└── serviceworker.js
```

#### FAQ

* **How can I add a new page?** Add a new file `<new_page_name>.html` in the root of the project.  
Link to it with `/<new_page_name>.html`

* **How can I add web push notifications?** The initial code to get a pushSubscription is already given in the `index.js` script, follow [this tutorial](https://web-push-book.gauntface.com/) to know how web push work.

### Deploy

Follow the simple instructions on [Github pages website](https://pages.github.com/) to know how to deploy your pwa for free
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.