Skip to content

avadhesh18/iosPWASplash

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 

Repository files navigation

ios-pwa-splash

Generate iOS Progressive Web App (PWA) splash screens with ease. Save yourself the hassle of writing multiple meta tags for Apple iPhone and iPad devices. Just provide one icon.png file and a background color.

NPM Version

Installation

Using jsdelivr CDN

<script src="https://cdn.jsdelivr.net/npm/ios-pwa-splash@1.0.0/cdn.min.js"></script>
<script>iosPWASplash('icon.png', '#000000');</script>

Using UNPKG CDN

<script src="https://unpkg.com/ios-pwa-splash@1.0.0/cdn.min.js"></script>
<script>iosPWASplash('icon.png', '#000000');</script>    

Usage

// Generate iOS PWA splash screens
iosPWASplash('path/to/icon.png', 'background-color');
// Make sure the image is hosted on the same domain.
  • icon: URL or local path to the app icon image (recommended size: 512px x 512px, will be resized based on device pixel ratio).
  • background-color: Background color for the splash screen (optional, defaults to 'white').

The iosPWASplash function generates iOS PWA splash screens for both portrait and landscape orientations and automatically adds them to the HTML head element.

Example

// Generate iOS PWA splash screens with a custom background color
iosPWASplash('path/to/icon.png', '#3498db');

Test PWA

Visit https://avadhesh18.github.io/iosPWASplashtest/ from your Apple iPhone or iPad device to test.

Error Handling

  • If the provided icon URL is invalid or empty, an error will be thrown.
  • If there's an issue loading the icon image, an error will be thrown.

License

This project is licensed under the MIT License.

Releases

No releases published

Packages

No packages published