Folio Audio Library

Build a refined mobile reading-app interface with white surfaces, black actions, yellow accents and cover-led discovery. Includes Explore, book list and detail screens, three original fictional book covers, a React/TypeScript mobile starter, search and genre filters, bookmarks, a local library, a sample basket and browser-voice excerpt preview. iPhone and Pixel layouts are included. State resets on refresh; no real bookshop, account or full audiobook service is connected.

Usage instructions

Provide the app identity, approved catalog and assets, audience, existing stack and required screens. Ask your coding agent to use folio-audio-library. In assets/starter run npm ci and npm run dev, then open the localhost URL printed by Vite. App-specific code lives in src/Prototype.tsx and src/prototype.css; preserve the included mobile runtime and run npm run check:runtime after edits.

Explore, list and detail navigation work with search, genre filters, bookmarks, a local library and a sample basket. Fictional books, ratings, durations and prices reset on refresh. Browser voice preview reads an original excerpt; it is not a recorded audiobook. No order, charge or ownership entitlement is created. Use npm run build for the verified static build; hosting is a separate authorized action.

Dependencies

The React/TypeScript starter requires compatible Node.js (22.12+ or newer supported LTS) and npm. Run npm ci using the registry or cache, then npm run dev; this is not a standalone HTML file. Pinned dependencies and the original covers are included as source references/assets, but node_modules is not bundled. Voice previews require browser SpeechSynthesis support and available platform voices; text reading remains available. No API keys, backend, account, payment or recorded audiobook assets are required.

Installation

  1. Download and inspect the ZIP containing SKILL.md, the complete mobile starter source, three original covers, design/behavior guides and verification notes.
  2. Extract folio-audio-library into your agent’s documented Skill directory, with SKILL.md directly inside.
  3. In assets/starter run npm ci, npm run check:runtime and npm run dev. Node.js 22.12+ or a newer supported LTS and access to the pinned dependencies are required.
  4. Test the three screens, search/empty states, bookmarks, library, basket totals and voice/text preview. Adapt the approved content and run npm run build; add real catalog, account, payment or full audio services only as separate work.

Version history

1.0.0

Initial release: Explore, book list and detail screens; three original fictional covers; search/genre filtering; bookmarks and library; integer-cent sample basket; browser-voice excerpt preview with text fallback; preserved iPhone/Pixel runtime; React/TypeScript source and verified build. No real commerce, account or full audiobook integration.