Loading…
Loading…
Full installation of WooNext components into an existing Next.js project
Full installation that generates a complete WooNext storefront. Runs interactive prompts to configure your project.
npx woonext install [path]
woonext.json| Prompt | Description | Default |
|---|---|---|
| Backend domain | WordPress site domain | localhost:8080 |
| Protocol | HTTP or HTTPS | - |
| GraphQL endpoint | WPGraphQL endpoint path | graphql |
| Site name | Store name | My Store |
| Site description | Store tagline | A Fresh NEW Store!!! |
| Prompt | Description |
|---|---|
| Product types | Additional types: grouped, external, subscription, bundle, composite |
| Authentication | withAuth (guests + registered) or withoutAuth (guests only) |
| JWT plugin | wp-graphql-jwt-authentication or wp-graphql-headless-login |
| Credential storage | cookies (recommended) or browser |
| Include cart | Generate cart page and components |
| Include checkout | Generate checkout flow (requires cart enabled) |
| Include account pages | Generate user account dashboard |
If checkout is enabled:
| Prompt | Description |
|---|---|
| Stripe Publishable Key | Client-side Stripe key |
| Stripe Secret Key | Server-side Stripe key |
| Cashier Password | Encrypted application password for order creation |
If checkout is disabled:
| Prompt | Description |
|---|---|
| Nonce Key | Must match WordPress NONCE_KEY |
| Nonce Salt | Must match WordPress NONCE_SALT |
These nonce values are used to generate Session Drop-URLs, which pass the user session to the WordPress backend for cart and checkout functionality.
/api/cart - Cart operations/api/session - Session management/api/auth - Authentication/api/customer - Customer data/api/products - Product queriesSee Components for the full list of generated components.
codegen.ts - GraphQL code generation confignext.config.mjs - Next.js configuration updates.env.local - Environment variableswoonext.json - Saved configuration