English | Français | Español | Deutsch | 日本語 | 简体中文 | 繁體中文 | Português | Русский | العربية | हिन्दी | Bahasa Indonesia | Italiano | 한국어 | Türkçe | Tiếng Việt | ไทย
Themes, admin utilities, and provider integrations for the Spwig e-commerce platform.
Website • Documentation • Community • Live Demos
This repository is the open-source component library for Spwig, a self-hosted e-commerce platform. It contains three kinds of components that a Spwig installation can use:
| Themes | Ready-to-use storefront designs |
| Utilities | Admin UI helpers (color picker, gradient editor, focal point picker, etc.) |
| Integrations | Payment, shipping, SMS, email, translation, SEO, and social providers |
Every component is designed to be installed and updated through the Spwig admin — no code required — but the source lives here so you can inspect it, contribute, or fork.
| Theme | Style |
|---|---|
| Default | Clean, professional, versatile |
| Apparel | Fashion and clothing stores |
| Artisan | Handcrafted goods |
| Bold | High-contrast, statement-making |
| Botanica | Plants, garden, natural products |
| Elegant Shop | Premium, luxury |
| Modern Dark | Dark-mode-first design |
| Modern Shop | Contemporary general store |
| Nature | Outdoor, sustainable brands |
| Space | Tech, gadgets, futuristic |
| Starter | Minimal starting point for custom themes |
| Tech | Electronics and hardware |
| Vivid | Vibrant, colorful |
Reusable UI pieces used across the Spwig admin interface — including a color picker, gradient creator, focal-point selector, shadow editor, typography editor, background editor, border editor, spacing editor, icon picker, unit selector, visibility rules editor, form selector, translation editor, and a shared utility base.
| Category | Providers |
|---|---|
| Payments | Stripe, Adyen, PayPal Checkout, Airwallex, Revolut, Square |
| Payouts | PayPal, Airwallex Payouts, Wise |
| Shipping | FedEx, UPS, USPS, Canada Post, Australia Post, NinjaVan |
| Terminals | Stripe Terminal, Square Terminal, Adyen Terminal, Revolut Terminal, SumUp, Zettle |
| Gmail API, SMTP (Gmail / Outlook / SendGrid / SES / any) | |
| SMS | Twilio, Twilio WhatsApp |
| Exchange Rates | Fixer, currencylayer, XE, Open Exchange Rates, exchangerate-api, exchangeratesapi |
| Translation | DeepL, AWS Translate, Azure Translator, Google Translate, Generic API |
| SEO | Semrush, DataForSEO, AI SEO |
| Social | Facebook Pages, Instagram Business, LinkedIn Company, Twitter |
| Product Feeds | Google Merchant Center |
| License Servers | Cryptlex, LicenseSpring, Keygen, Custom API, Spwig Built-in |
Components install with a click from your Spwig store's admin:
Admin → Marketplace → Components
The marketplace shows every component in this repository, plus premium and third-party ones. Click Install, and Spwig fetches the component, wires it into your site, and applies any required migrations.
If you're running a customised Spwig setup or developing offline, you can install components manually:
git clone https://github.com/Spwig/components.git
cp -r components/themes/botanica /path/to/spwig/media/components/themes/Then, in the Spwig admin, run Marketplace → Rescan Local Components.
Building a new theme, utility, or integration? Start with one of our SDKs — each is a small, well-documented framework with an example provider you can fork:
| SDK | For building |
|---|---|
theme-sdk |
Themes with tokens, critical CSS, and page-builder support |
provider-sdks |
Payment, shipping, SMS, email, and other provider integrations |
headless-sdk |
Headless storefronts calling the Spwig API |
react |
React hooks and components for headless storefronts |
Every component in this repository follows the same manifest format (manifest.json) so it can be discovered by the Spwig marketplace.
Contributions are welcome. To keep things simple we use the Developer Certificate of Origin (DCO) instead of a CLA — just add a sign-off line to your commits:
git commit -s -m "Add support for X"Please see CONTRIBUTING.md for details on how to submit a PR, the manifest format, and coding conventions.
Ideas for contribution:
- New themes for underserved verticals (food & drink, health, education, real estate)
- Additional payment or shipping providers by region
- Bug fixes and improvements to existing components
- Translations of the README and component setup instructions
AGPL-3.0 — see LICENSE. You can use, modify, and distribute this code freely for self-hosted stores. If you run a modified version as a network service, you must make your changes available to your users under the same license.
For terms that suit a proprietary or SaaS use case, contact licensing@spwig.com.
- Documentation: docs.spwig.com
- Community Forum: community.spwig.com
- Email: support@spwig.com
- Issues: github.com/Spwig/components/issues
Built by Spwig and contributors