npm create browserux@latest

create-browserux scaffolds front-end starter templates built around native web standards: PWA, Web Components, semantic HTML, native CSS, browser APIs, and controlled service workers.

It is not a full-stack framework generator and does not try to replace Next, Nuxt, Astro, Remix, or similar tools. It gives you a production-ready front-end base for static sites, PWAs, and client-side applications where you keep control of the browser platform.

✨ What You Get

• 📴 PWA manifest, icons, service worker registration, and offline page.
• 🎨 BrowserUX CSS base with native user interface patterns.
• 🧩 BrowserUX Web Components for theme switching, native sharing, and PWA install/update UI.
• ⚡ Vite templates with Workbox, image optimization, preload hints, sitemap, and robots generation.
• 🔤 Optional TypeScript setup for Vite templates.
• 🧪 React/Vue templates with routing and Vitest test suites.

📦 Templates

| Logo | Template | What it is for | Stack | |---|---|---|---| | | raw | Pure HTML/CSS/JS with a hand-written service worker. No build step, no npm, no bundler. | HTML, CSS, Vanilla JS, Cache API | | | vite-vanilla | Static multi-page app with Vite, Workbox, optimized assets, sitemap, and full SW control. | Vanilla JS or TS, Vite, Workbox, MPA | | | vite-react | React 19 SPA with React Router v7, data loaders, tests, and BrowserUX Web Components. | React 19, React Router v7, Vite, Workbox, Vitest | | | vite-vue | Vue 3 SPA with Vue Router 4, Composition API, tests, and BrowserUX Web Components. | Vue 3, Vue Router 4, Vite, Workbox, Vitest |

🚀 Usage

npm create browserux@latest

The CLI asks for:

1. Project name: used as the folder name and package.json name.
2. Template: raw, vite-vanilla, vite-react, or vite-vue.
3. TypeScript: optional for Vite templates, not shown for raw.

For Vite templates:

cd my-project
npm install
npm run dev

For the raw template:

cd my-project
# Open index.html in a browser

🔤 TypeScript

When TypeScript is selected, the CLI overlays typed source files onto the JavaScript template and updates devDependencies.

• vite-vanilla: adds typescript.
• vite-react: adds typescript, @types/react, and @types/react-dom.
• vite-vue: adds typescript and vue-tsc.

🧱 Standards-First Foundation

• 📱 PWA: Web App Manifest, Service Worker, Cache API, offline fallback.
• 🧩 Web Components: Custom Elements, Shadow DOM, slots, HTML attributes.
• 🎨 Native CSS: CSS variables, media queries, semantic elements, native user interface patterns.
• 🌐 Browser APIs: Web Share API, beforeinstallprompt, View Transitions API, localStorage.
• 📝 Semantic HTML: native elements and browser behavior before proprietary abstractions.

📁 Folder Handling

If the target folder already exists, the CLI asks for confirmation before merging files and replacing conflicts.

The following entries are excluded while copying templates:

| Excluded item | Reason | |---|---| | node_modules/ | Dependencies should be installed locally | | dist/ | Build output should be regenerated | | .env | Local environment files may contain secrets |

🔗 Links

• Project repository
• Documentation
• npm package

📄 License

MIT © 2026 Effeilo