Installation Guide

⚡ 2 min read

Step-by-step guide for installing and setting up the Web App Kit (PWA)

Current requirement: PWA installability (manifest, service worker, webworker.js) is wired through HTML / CDN—add the tags below to your document (or equivalent early load, e.g. Next.js beforeInteractive). The npm SDK alone does not enable this PWA path. For Authentication-only integration without PWA, see Quick Integration.

Web App Toolkit Cluster (PWA) Setup

For installable PWA with home screen icon and splash screen:

1. Add to your HTML


<link rel="manifest" href="https://cdn.transcodes.link/YOUR_PROJECT_ID/manifest.json" />
<script
  type="module"
  src="https://cdn.transcodes.link/YOUR_PROJECT_ID/webworker.js"
></script>

2. Add Service Worker (sw.js)

sw.js is the Service Worker file required for PWA installability (home screen icon, standalone window). The browser registers it to enable “Add to Home Screen”

Download sw.js from this panel (or the Transcodes Dashboard )
Place it so it is served at https://yourdomain.com/sw.js:
- Vite (React, Vue, Vanilla): put in public/sw.js
- Next.js: put in public/sw.js

Next Steps

Configuration - Configure your app settings
Quick Integration - Framework-specific integration guides