=== Paper Companions ===
Contributors: markdavidgan
Requires at least: 6.6
Tested up to: 6.8
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A calm block theme for a small shelf of printable companions to the Return and Near iPhone apps.

== Description ==

Paper Companions is a block theme built for WooCommerce. Paper background, hairline rules, Instrument Serif display type and printer's crop marks as its one ornament. Two shelf accents: petrol for the Return shelf, amber on jade for the Near shelf.

* theme.json version 3: palette, fluid type scale, spacing scale, element and block styles.
* Section styles (styles/sections) for the Return shelf, the Near shelf and a raised "sheet".
* Templates for the front page, pages, posts, 404, the shop, product categories ("shelves"), single products, cart, checkout and order confirmation.
* WooCommerce blocks throughout: Product Collection, Product Image Gallery, Add to Cart form, Product Description, block Cart, block Checkout and the Order Confirmation blocks. No PHP template overrides.
* Patterns: home hero, two shelves, how printing works, questions, companion apps, colophon and footer.
* Self-hosted fonts; no requests to third-party font services.

The companion plugin, Paper Companions Core, provides the blocks used on product and shelf pages (companion app, print notes, shelf intro), pay what you want pricing and the catalog seeder. Without it the theme still renders; those blocks are simply absent.

== Installation ==

1. Upload the theme folder to wp-content/themes, or upload paper-companions-theme.zip in Appearance > Themes > Add New.
2. Activate WooCommerce and the Paper Companions Core plugin.
3. Activate the theme.

== Accessibility ==

Colour pairs meet WCAG 2.1 AA for text. Amber is used only for rules and decoration; text on the Near shelf uses the deeper amber ink. Every interactive element has a visible focus ring, and motion is limited to one entrance on the home page that is skipped when reduced motion is requested.

== Copyright ==

Paper Companions WordPress Theme, (C) 2026 Mark David Gan.
Paper Companions is distributed under the terms of the GNU GPL v2 or later.

This theme bundles the following third-party resources:

Instrument Serif
Copyright 2022 The Instrument Serif Project Authors (https://github.com/Instrument/instrument-serif)
License: SIL Open Font License, 1.1 (assets/fonts/OFL-instrument-serif.txt)

Hanken Grotesk
Copyright 2021 The Hanken Grotesk Project Authors (https://github.com/marcologous/hanken-grotesk)
License: SIL Open Font License, 1.1 (assets/fonts/OFL-hanken-grotesk.txt)

JetBrains Mono
Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
License: SIL Open Font License, 1.1 (assets/fonts/OFL-jetbrains-mono.txt)

Font files are the Latin subsets distributed by Fontsource (https://fontsource.org).

== Changelog ==

= 1.0.0 =
* First release.
