pwa-setup

Configure Next.js TypeScript apps with PWA manifest, safe-area CSS, and install-prompt hook.

1|Updated Nov 9, 2024
One-click install
npx skills add https://github.com/marnec/ripple --skill pwa-setup-marnec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pwa-setup
Source: https://github.com/marnec/ripple/tree/main/.claude/skills/pwa-setup
Command: npx skills add https://github.com/marnec/ripple --skill pwa-setup-marnec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a ready-to-use set of patterns to configure a web app as a Progressive Web App, enabling installability, offline capabilities, and app-like behavior across devices.

Core Features & Use Cases

  • Web App Manifest setup for branding, icons, and start URL
  • Mobile meta tags and safe-area support for notched devices
  • Install prompt integration with a reusable hook and banner
  • End-to-end example integration with Next.js (TypeScript)
  • Suitable for teams building consumer web apps that want installable UX

Quick Start

Add a manifest, configure metadata and safe-area styles, and integrate the install prompt hook to enable install prompts.

Frequently Asked Questions about pwa-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make a Next.js web app installable like a native app?

To make a Next.js web app installable, you configure a web app manifest, root layout metadata, and an install prompt hook to enable native app-like installation and behavior across devices.

What is a web app manifest and why do I need it for a PWA?

A web app manifest provides branding, icons, and start URL configuration. It is needed for a PWA to define how the application appears and behaves when installed on a user's device.

How do I handle safe-area insets for notched devices in a TypeScript PWA?

To handle safe-area insets for notched devices in a TypeScript PWA, you apply safe-area CSS styles and mobile meta tags, ensuring your layout respects device boundaries and avoids visual obstruction.

Does this PWA setup require any specific dependencies or components?

This PWA setup does not require external dependencies or components. It provides a ready-to-use boilerplate pattern targeting TypeScript and Next.js frontend projects without added library overhead.

What's the best way to implement an install prompt banner in a web app?

The best way to implement an install prompt banner is using a reusable hook and banner component, capturing the native install event to present a contextual installation prompt to the user.

When should I add PWA boilerplate to my consumer web app?

You should add PWA boilerplate to your consumer web app when your team seeks an installable UX, offline capabilities, and app-like behavior across devices without building a separate native application.