Skip to content

Latest commit

 

History

History
210 lines (137 loc) · 6.96 KB

File metadata and controls

210 lines (137 loc) · 6.96 KB

Progressive Web App (PWA) Guide

Table of Contents

What is a PWA?

Progressive Web Apps (PWAs) are web applications that can be installed on your device and work like native applications.

Features

Offline Support

Once installed, teXt0wnz works completely offline.

File Handling

Desktop (Chrome/Edge):

  • OS-level "Open With" integration
  • Right-click .ans, .xb, .bin, etc files → "Open with teXt0wnz"

Android:

  • Share sheet integration
  • Share files from Files app directly to teXt0wnz

iOS/iPadOS:

  • No share target support!
  • Manual file picker accepts all file types
  • Drag-and-drop from Files app

Supported File Types: .ans, .ansi, .xb, .xbin, .bin, .txt, .nfo, .diz, .utf8ans

Installation by Platform

This document provides step-by-step instructions for installing a Progressive Web App (PWA), like teXt0wnz across major platforms and browsers. PWAs offer app-like experiences directly from your browser, with offline support and native-like features.

Desktop Chrome

desktop install

Steps:

  1. Navigate to the website you want to install as a PWA in Google Chrome.
  2. If the site is a PWA, you will see a "Install" icon in the address bar (typically a plus (+) symbol inside a monitor).
  3. Click the "Install" icon.
  4. Confirm installation in the prompt.
  5. The app will open in its own window and be accessible from your desktop or app launcher.

What you get after installing:

  • Standalone app window
  • Desktop shortcut
  • OS file association - Right-click text art files → "Open with teXt0wnz"

Reference:

Desktop Safari (MacOS)

safari install

Steps:

  1. Open the website in Safari on your Mac.
  2. Click the "Share" button in the Safari toolbar.
  3. Select "Add to Home Screen."
  4. The PWA will be added to your Launchpad and can be opened like a native app.

Note: As of macOS Sonoma and later, Safari supports installation of web apps to the dock, similar to PWAs. For older versions, home screen installation is limited or unavailable.

Reference:

Desktop Firefox

Steps:

  1. Firefox does not natively support PWA installation as a standalone app on desktop.
  2. You can use a third-party extension like PWAs-For-FireFox
  3. Alternatively, use Chrome or Edge for PWA installation on desktop.

Reference:

iPadOS / iOS (Safari)

ipad install

Steps:

  1. Open the website in Safari on your iPad or iPhone.
  2. Tap the "Share" button (square with an arrow pointing up).
  3. Tap the "More" button (Three dots).
  4. Tap “Add to Home Screen.”
  5. The web app will appear on your home screen and can be launched like any other app.

What you get after installing:

  • Home screen icon
  • Enhanced file picker (accepts all files)
  • No share target or Finder integration (iOS limitation)

References:

Android (Chrome)

android install

Steps:

  1. Open the website in Chrome on your Android device.
  2. If the site is a PWA, a banner or popup may appear prompting installation.
  3. If not, tap the three-dot menu in the top-right corner.
  4. Tap “Install app” or “Add to Home screen.”
  5. Confirm installation; the app icon will appear on your home screen.

What you get after installing:

  • Home screen icon
  • Share sheet integration - Share files directly to teXt0wnz

Reference:

Using File Handling Features

Desktop: "Open With" Integration

After installation, you can open text art files directly from your OS:

  1. Right-click any .ans, .xb, .bin, etc. file
  2. Select "Open with" → "teXt0wnz"
  3. File opens directly in the app

First time setup (Chrome/Edge):

  • The first time you open a file, Chrome may ask to confirm the file association
  • Check "Always use teXt0wnz" to remember your choice

Android: Share Sheet

After installation, you can share files to teXt0wnz:

  1. Open Files app
  2. Long-press a text art file (or the 3 dots from a file manager app)
  3. Tap "Share"
  4. Select "teXt0wnz" from share sheet
  5. File opens in the app

iOS: Manual File Opening

iOS doesn't support share targets, but you can still open files:

Method 1: File Picker

  1. Tap "Open" in teXt0wnz menu
  2. Tap "Browse" in file picker
  3. All files are selectable (not just recognized types)

Method 2: Drag & Drop

  1. Open Files app
  2. Use Split View to show both Files and teXt0wnz
  3. Drag files from Files into teXt0wnz

Additional Information

  • For Microsoft Edge (desktop/mobile), installation steps are nearly identical to Chrome.
  • Some browsers and platforms may not fully support all PWA features or installation flows.

Citations

  1. Google Chrome Help: Install a Progressive Web App
  2. Apple: Add a website icon to your Home Screen
  3. Apple Developer: Web Apps on macOS
  4. Mozilla Bugzilla: PWA Desktop App Support
  5. Web.dev: PWA install prompts