Open source CLIHeadless WooCommerce, zero boilerplate
Spin up a Next.js storefront with npx create-woonext-app
A single command scaffolds a fully-configured Next.js commerce app — wired to your WooGraphQL endpoint, typed end-to-end, and shipping with cart, auth, and checkout out of the box.
$npx create-woonext-app <license_key>
// What ships in the box
A storefront-grade stack, preconfigured.
No more an afternoon of npm install incantations. The CLI scaffolds opinionated defaults that the WooGraphQL maintainers actually use in production.
N
Next.js 16
App Router, Server Components, Server Actions, and the latest Next.js — install picks the version with --next-version.
React 19 · Turbopack
◆
WooGraphQL client
graphql-request wired with @woographql/session-utils for session-aware queries. Typed schema, no Apollo runtime.
graphql-request · session-utils
T
shadcn/ui + Tailwind
components.json initialized with Tailwind v4, Sonner toasts, Source Sans 3 + Playfair Display fonts. Add more via npx shadcn add.
shadcn/ui · Tailwind v4
{ }
Type generation
@woographql/codegen runs on dev start, generating a typed graphql-request SDK from your endpoint’s schema.
@woographql/codegen
🔒
Session + auth
Custom SessionProvider on top of WooGraphQL JWT — pick cookie- or browser-storage credentials at install. Guest carts thread into authenticated sessions.
@woographql/session-utils · JWT
≡
Pages + Server Actions
Cart, multi-step checkout, order confirmation, and account pages (orders, subscriptions, addresses, payment methods) — plus 25+ api routes.
App Router · Server Actions
$
Stripe checkout
Optional Stripe Elements integration — @stripe/react-stripe-js, payment-intent and customer routes. Cleanly disabled when you opt out at install.
@stripe/react-stripe-js · optional
✓
Tests + Storybook
Jest + Testing Library for unit, Playwright for end-to-end, Storybook with stories scaffolded for every layout and feature component.
Jest · Playwright · Storybook
// From zero to storefront
Three commands. One working store.
A WooGraphQL Pro license unlocks the CLI and the private @woographql/* packages on YeetSquad’s registry. Then you’re off.
— 01 / Scaffold
Run the CLI
The interactive prompt walks you through template, endpoint, and feature selection. Pick what you need.
$ npx create-woonext-app
--template app-router
--endpoint \
https://shop.acme.com— 02 / Authenticate
Link your license
The CLI writes a project-local .npmrc with your license-scoped @woographql registry token, then runs woonext install to scaffold pages, layouts, api routes, and codegen.
$ cd my-store
$ npx woonext install
# ✓ Pages, layouts, api
# routes, codegen ready— 03 / Ship
Start the dev server
Codegen runs, the schema is introspected, the dev server starts on localhost:3000. You’re live.
$ npm run dev
# ▲ Next.js 16 · Turbopack
# ✓ Ready in 1.2s// @woographql packages
Private packages, maintained alongside the schema.
License holders get access to a curated set of JavaScript libraries on the YeetSquad registry. They’re versioned with WooGraphQL itself — when the schema changes, the types follow.
@woographql/next
App Router server fetchers, RSC-safe session + cart helpers
@woographql/react-hooks
Client-side React hooks — useCart, useSession, useCheckout, useAuth
@woographql/session-utils
WooCommerce session + cart token management with pluggable storage adapters
@woographql/codegen
GraphQL Code Generator preset for WooGraphQL — typed queries, hooks, server fetchers
import { withMarketingSession } from '@woographql/next/server'
import { ProductCard } from '@/components/product-card'
import { GetFeaturedProductsDocument } from '@/graphql/generated'
export default withMarketingSession(async ({ client }) => {
const { data } = await client.query({
query: GetFeaturedProductsDocument,
variables: { first: 12 },
})
return (
{data.products?.nodes.map((product) => (
))}
)
})
// Session token threaded through the request — typed against your
// generated schema. No glue code required.
// See it running
A full storefront, built with create-woonext-app.
Cart, checkout, account, search, filters, subscription products. Every current capability of @woographql/next, deployed live.
// Unlock the CLI
The CLI ships with every paid plan.
A WooGraphQL Pro license gives you access to create-woonext-app and the private @woographql/* packages. Annual subscribers get them on every tier.
Open source
Free
Core plugin, forever
$0
GPL-3 licensed
✓
Core WooCommerce types & mutations
✓
WPGraphQL settings & tuning
✓
WooCommerce cart support
◯
Pro extensions (Bundles, Composite, Subs)
◯
create-woonext-app CLI
◯
@woographql JS packages
✓
Community support
Personal
Solo
For 1 website
$99.99
per year
✓
1 website activation
✓
Unlimited updates
✓
Subscriptions, Bundles, and Composite products support
✓
Product Addons support
✓
create-woonext-app CLI
✓
@woographql packages
✓
Annual consultation call
Professional
Most Popular
Agency
For up to 5 websites
$299.99
per year
✓
5 website activations
✓
Unlimited updates
✓
Subscriptions, Bundles, and Composite products support
✓
Product Addons support
✓
create-woonext-app CLI
✓
@woographql packages
✓
Annual consultation call
Business
Unlimited
Unlimited websites
$449.99
per year
✓
Unlimited activations
✓
Unlimited updates
✓
Subscriptions, Bundles, and Composite products support
✓
Product Addons support
✓
create-woonext-app CLI
✓
@woographql packages
✓
Annual consultation call
From npx to live storefront in under five minutes.
Buy any annual Pro plan to unlock the CLI and the @woographql packages. The free plugin keeps working forever — upgrade only when you’re ready to ship.