PWAxcode ships as lightweight, framework-agnostic assets. You can self-host the files, use a package manager,
or reference a CDN. Below you’ll find the options, a minimal setup, and a few useful checks.
Tip: keep .css next to your JS, or pipe it through your asset pipeline.
Icons in Containers (Font Awesome 6 required)
To display the toolbar and footer icons inside PWAxcode containers (e.g., play/pause, search, fullscreen), you must include Font Awesome 6 on your page. The library is not bundled to keep the core lightweight.
What to include
- Load FA6 via a CDN or self-host the CSS and webfonts.
- Use v6 families like fa-solid, fa-regular, fa-brands.
CDN (pinned version)
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.7.2/css/all.min.css" integrity="sha512-Evv84Mr4kqVGRNSgIGL/F/aIDqQb7xQ2vcrdIwxfjThSH8CSR7PBEakCr51Ck+w+/U6swU2Im1vVX0SVk9ABhg==" crossorigin="anonymous" referrerpolicy="no-referrer" />
CDN (Font Awesome Kit)
Use your Kit ID from your Font Awesome account.
<script src="https://kit.fontawesome.com/YOUR_KIT_ID.js" crossorigin="anonymous"></script>
Download (self-host)
Download the package and serve all.min.css + webfonts from your own domain.
<!-- Example self-host path --> <link rel="stylesheet" href="/assets/fontawesome/css/all.min.css">
Minimal usage example
<button class="pxc-fbtn"> <i class="fa-solid fa-play" aria-hidden="true"></i> <span class="sr-only">Play</span> </button>
Notes & Tips
- Prefer pinned versions on CDN and include SRI for integrity.
- If you self-host, ensure the webfont paths referenced by
all.min.css resolve correctly (keep default folder structure or update url() paths).
- Use semantic labels for accessibility (e.g., visually hidden
sr-only text alongside the icon).
- Modern evergreen browsers (Chromium, Firefox, Safari, Edge).
- Mobile Safari/Chrome on current iOS/Android.
- Internet Explorer is not supported.
For best results, load the CSS, avoid blocking the main thread during init, and honor
prefers-reduced-motion in your theme CSS.
- Pin a version in production; test upgrades in staging.
- Review the changelog for breaking changes (API/HTML hooks/themes).
- Rebuild custom themes if token names or CSS hooks changed.
PWAxcode is released under the MIT License — a permissive open-source license that allows
use, modification, and redistribution for commercial and non-commercial purposes. Please include the copyright
and permission notice in your distributions. See LICENSE for details.
Start with the minimal setup, then fine-tune options in Usage & Reference. When you’re ready to teach,
script your first tour with the Player and make it yours with custom themes.