Paper
Paper is Saleor’s open-source storefront, built with Next.js and designed to be changed with coding agents. It requires Saleor 3.23 or later. See the live demo or run it locally.
Features
Checkout
Multi-step, server-rendered checkout with Stripe and a dummy gateway for test orders. Guests get an order confirmation page after paying.
Markets
URLs carry the language and channel, e.g. /en/us/products/hoodie. Shoppers switch language, market, and currency in one region picker.
Internationalization
The interface ships in eight languages. Product copy and URL slugs come from Saleor translations, and pages link their other-language versions for search engines.
Product pages
Variant selection across several attributes, such as color and size, with per-variant prices and images.
Caching
Catalog pages are cached and refreshed by webhooks. Cart and checkout are always live.
Images
Images come in several sizes straight from Saleor’s CDN, so the host doesn’t bill for image optimization.
Storefront copy
Homepage, cart, and checkout copy is stored in Saleor Models, so merchants edit it in the Dashboard.
Customer accounts
Sign-in, registration, password reset, address book, order history, and account deletion.
Built for coding agents
Paper is structured so a coding agent can change it quickly and follow the repository’s patterns.
AGENTS.md
An always-on guide that tells agents where to find Next.js, Paper, and Saleor API context for a task.
Paper skill
Task-specific rules for checkout, caching, product pages, design, translations, SEO, and more. Agents load only the rule they need.
Saleor Agent Skills
Paper builds on Saleor’s general storefront skills. pnpm skills:bootstrap installs them with the other pinned skills.
Fork upgrades
Migration guides let an agent bring upstream Paper changes into your customized copy.
Paper app
The Paper app connects the Saleor Dashboard to your Paper storefront. Install it from Dashboard → Extensions.
Instant updates
Registers webhooks that refresh the storefront cache when you change products, categories, collections, pages, menus, promotions, or translations.
Preview on storefront
Opens the product on your storefront from the product page in the Dashboard, in the right language and channel.
Cache purge
Clears the cache for one product, category, collection, or page, for menus, or for the whole storefront.
Storefront Models
Creates the Models that hold Paper’s storefront copy, filled with default content.
Several storefronts
Connects up to five storefronts, such as production and staging, to one Saleor environment.
Event log
Shows the last 50 cache refreshes and checks the connection to the storefront.