LLM.coPrivate, self-hosted LLM deployments
Legal AI infrastructure for firms
AI RFP discovery and response drafting
Automatic.coBusiness process automation
Secure AI virtual data roomswoonuxt
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.
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.
Get the woonuxt source
Clone the repository and explore it locally.
git clone https://github.com/scottyzen/woonuxt.gitcd woonuxt# follow the project's README for install & configurationNeed it deployed, integrated, or customized instead? DEV.co ships production installs.
Best use cases
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 |
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.
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.coRelated open-source tools
Surfaced by semantic similarity across the DEV.co open-source index.
Related on DEV.co
Explore the category and the services that help you build with it.
woonuxt FAQ
Can I use WooNuxt with a non-WooCommerce backend?
What is the difference between nuxt generate and nuxt build for ISR?
How do I customize WooNuxt without forking?
Are modifications to WooNuxt required to be open-source?
Custom software development, end to end
Standing up woonuxt properly takes more than a deploy. As a software development agency, DEV.co handles the open-source ecommerce architecture, the web development on top, and the operational work underneath.
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.