docs: simplify app readme

This commit is contained in:
abdus committed 2026-10-10 10:59:38 +00:00
1 parent 819f6a61cd
commit 9d65dc3184
1 file changed
+20 -32
+20 -32
View File
@@ -1,39 +1,27 @@
# ascii PWA # ascii!
A standalone, dependency-free ASCII art app. Rendering, copying and downloads Turn text into ASCII art in your browser. Type something, pick a font, and see
work entirely in the browser. After the first successful online visit, the the result instantly.
service worker caches the interface for offline use. Fonts are cached only when
selected; previously used fonts remain available offline. No Python, API, CDN,
package installation or build step is needed.
Run locally with `npm start` (or `node serve.mjs`), then open - Browse 297 FIGlet fonts and a compact bitmap style with previous/next controls.
`http://localhost:8080`. Run checks with `npm test`. - Copy your art, download it as a text file, or share a link.
- Keep your last-used font and choose light, dark, or system appearance.
- Switch between English and Turkish.
- Install the app and use previously selected fonts offline.
Deploy this directory to any HTTPS static host. The relative paths support both Your text stays on your device. New fonts need a connection the first time you
an origin root and a subdirectory such as `/pwa/`. Serve `index.html`, `sw.js` use them.
and the manifest with `Cache-Control: no-cache`. Serve `sw.js` as JavaScript.
The included development server applies these headers. Direct file opening
does not support service workers; use localhost or HTTPS.
The full font collection from FIGlet.js 1.8.2 is bundled locally, alongside the ## Run locally
original compact bitmap style. FIGlet.js handles rendering, with font-specific
character support and wrapping at 80 columns. Text is limited to 500 characters.
Text links use `?text=...&font=...`; lowercase font names in older links are also
accepted. Text renders automatically as you type or change fonts. Previous/next
buttons cycle through the collection, and the last selected font is remembered.
An explicit font in a shared link overrides the saved preference. The logo and
installed app launch open the homepage. Text is not saved or sent to a server.
English/Turkish and light/dark/system preferences are stored locally when ```sh
storage is available. Your supplied SVG is the favicon and logo, with vector npm start
rendered PNG installation icons and separate maskable artwork. ```
When changing any shell asset, bump `VERSION` in `sw.js`. The new worker caches Open [localhost:8080](http://localhost:8080). No dependency installation or build
the entire shell before offering an update. Accepting the update reloads open step is needed.
clients; closing all existing app tabs also permits activation. Shell cleanup
only removes old versions for this app and installation scope. Previously used
fonts live in a separate cache pinned to the FIGlet.js version and survive shell
updates. A font you have never used needs a connection on its first selection.
Use the browser install action when available. On iOS, use Safari’s Share → Add ## Install
to Home Screen. Installation and device splash rendering need on-device checks.
Use your browser’s install option. On iPhone or iPad, open the app in Safari and
choose **Share → Add to Home Screen**.