Open-Source Ecommerce · scottyzen

woonuxt

WooNuxt is a modern, headless e-commerce frontend built on Nuxt 3 that connects to WooCommerce via GraphQL. It provides static or hybrid rendering options, PWA support, and is designed for fast, SEO-friendly storefronts with customizable Nuxt layers.

Talk to DEV.co Discuss Implementation

Source: GitHub — github.com/scottyzen/woonuxt

962

GitHub stars

302

Forks

TypeScript

Primary language

GPL-3.0

License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

Field	Value
Repository	scottyzen/woonuxt
Owner	scottyzen
Primary language	TypeScript
License	GPL-3.0 — OSI-approved
Stars	962
Forks	302
Open issues	48
Latest release	4.26.0 (2026-07-06)
Last updated	2026-07-06
Source	https://github.com/scottyzen/woonuxt

What woonuxt is

TypeScript-based Nuxt 3 application using WPGraphQL to decouple the WooCommerce backend; supports both static generation (nuxt generate) and hybrid rendering with ISR (Incremental Static Regeneration) for large catalogs (10K+ products). Includes Tailwind CSS, PWA scaffolding via @vite-pwa/nuxt, and Nuxt layer-based customization architecture.

Quickstart

Get the woonuxt source

Clone the repository and explore it locally.

terminalbash

1git clone https://github.com/scottyzen/woonuxt.git2cd woonuxt3# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

WooCommerce-based headless storefronts

Organizations running WooCommerce who want a modern, decoupled frontend with fast performance and independent frontend deployment from the WordPress backend.

Static or cached e-commerce sites with moderate to large catalogs

Stores with 1K–10K+ products where ISR hybrid rendering can balance freshness and performance, reducing server load while keeping product data reasonably current.

SEO-optimized, PWA-enabled storefronts

Retailers prioritizing search visibility and offline/repeat-visit experience, with pre-configured PWA manifest generation from WordPress settings and Nuxt-native SEO support.

Implementation considerations

Requires WooNuxt Settings plugin installation and activation on WordPress site to enable WPGraphQL schema extensions and payment gateway detection.
Configure GQL_HOST and NUXT_IMAGE_DOMAINS environment variables before deployment; one-click deploy buttons available for Netlify, Vercel, and PandaStack.
For catalogs >10K products, use Nuxt hybrid mode (nuxt build + ISR route rules) instead of full static generation (nuxt generate) to avoid build time explosion.
Session/cart initialization is deferred by default (storeSettings.initStoreOnUserActionToReduceServerLoad) to optimize first-paint performance; disable only if immediate full cart hydration is business-critical.
Customization uses Nuxt layer inheritance (extends array in nuxt.config.ts); override by shadowing woonuxt_base files in the root or custom layer directory.

When to avoid it — and what to weigh

Not using WooCommerce — WooNuxt is tightly coupled to WooCommerce via WPGraphQL. It is not a generic Nuxt e-commerce template and will require significant refactoring for other backends.
Real-time inventory or dynamic pricing required — Static generation and ISR-based caching introduce inherent staleness windows (default 3600s). Applications requiring immediate inventory sync or price updates should evaluate server-side rendering instead.
Complex custom checkout or payment workflows — WooNuxt supports Stripe and PayPal via the woonuxt-settings plugin. Highly custom payment integrations or complex tax/shipping rules may exceed the standard configuration scope.
GPL-incompatible licensing — GPL-3.0 license requires derived works and customizations to remain open-source. Proprietary extensions or closed-source forks are not permitted without a commercial license agreement (not mentioned in provided data).

License & commercial use

GPL-3.0 (GNU General Public License v3.0). This is a copyleft license requiring any distribution of modified code to remain under GPL-3.0 and be made available to end users. Proprietary or closed-source modifications are not permitted under GPL-3.0 alone.

GPL-3.0 permits commercial use (running a commercial storefront). However, if you modify WooNuxt and distribute the modified code (e.g., as a hosted service or resale), you must make modifications available under GPL-3.0. No commercial license exception is documented in the provided data; verify licensing terms if you plan proprietary customizations or white-label resale.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

Signal	Assessment
Maintenance	Active
Documentation	Adequate
License clarity	Clear
Deployment complexity	Moderate
DEV.co fit	Good
Assessment confidence	High

Security considerations

No security audit data provided. Standard Nuxt and Vue security practices apply. Consider: (1) validate GraphQL queries to prevent injection; (2) sanitize user input in custom components; (3) keep WooCommerce, WPGraphQL, and woonuxt-settings plugins updated; (4) use HTTPS for all frontend-backend traffic; (5) review environment variable handling to avoid exposing sensitive data (GQL_HOST, API keys).

Alternatives to consider

Storefront (WooCommerce block theme)

Official WooCommerce block-based theme; tightly integrated with WordPress admin but offers less frontend customization and decoupling than headless.

Hydrogen (Shopify's headless framework)

Modern headless e-commerce framework with strong performance and DX; requires Shopify backend instead of WooCommerce and has different licensing/cost model.

Medusa (open-source commerce engine)

Decoupled e-commerce backend agnostic to frontend framework; offers more flexibility than WooCommerce but requires full backend setup and custom integration work.

Software development agency

Build on woonuxt with DEV.co software developers

WooNuxt offers a proven headless architecture with strong SEO and performance. Let's assess whether it fits your catalog size, payment workflow, and licensing requirements.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

nextjs-woocommerce commerce svelte-commerce

Related on DEV.co

Explore the category and the services that help you build with it.

Open-Source Ecommerce E-commerce Development Web App Development Cloud Deployment Talk to DEV.co

woonuxt FAQ

Can I use WooNuxt with a non-WooCommerce backend?

Not without substantial refactoring. WooNuxt is tightly integrated with WooCommerce via WPGraphQL. Using another backend would require rewriting data fetching, schema mapping, and component logic.

What is the difference between nuxt generate and nuxt build for ISR?

nuxt generate produces fully static HTML files at build time (suitable for small catalogs). nuxt build enables hybrid rendering; Nitro route rules with ISR revalidate on-demand at runtime (better for 10K+ products). Netlify requires server mode; Vercel natively supports ISR route rules.

How do I customize WooNuxt without forking?

Use Nuxt layers: extend woonuxt_base in nuxt.config.ts, then shadow files (components, pages, config) in your root or custom layer directory. This keeps the base layer upgradeable.

Are modifications to WooNuxt required to be open-source?

Under GPL-3.0, yes: if you distribute modified WooNuxt code (commercially or otherwise), you must provide source and maintain GPL-3.0 licensing. Internal-only modifications used in a hosted service are not automatically subject to this requirement, but consult a lawyer for your specific use case.

Work with a software development agency

From first prototype to production, DEV.co delivers software development services around tools like woonuxt. Our software development agency staffs experienced software developers and web developers for custom software development, web development, integrations, and ongoing support across open-source ecommerce and beyond.

Ready to modernize your WooCommerce storefront?

WooNuxt offers a proven headless architecture with strong SEO and performance. Let's assess whether it fits your catalog size, payment workflow, and licensing requirements.

Talk to DEV.co Schedule a Consultation