Salla JS Web Components vs Component Bundles#
Two tools. Two audiences. One platform. Here's how to tell them apart and know which one you should be building.JS Web Components are built by Salla for theme developers. Component Bundles are built by partners for merchants. They are not the same thing.
Twilight JS Web Components are ready-made UI building blocks provided by Salla for developers building themes on the Twilight engine. You don't install them — the Twilight engine injects them automatically into every page.Just drop the tag in your Twig template:They cover everything: search, filters, product cards, sliders, modals, loyalty popups, cart, reviews, gifting, installments, and more. All styled with Tailwind CSS, all customizable via CSS variables, all maintained by Salla's core team.Always include the Twilight components safe-list in your Tailwind config or styles will be purged in production:
JS Web Components are theme-bound. When a merchant switches themes, these components change with the theme. Merchants cannot install them independently.
Component Bundles — Your Product, Sold to 60,000+ Merchants#
Component Bundles are standalone packages built by partners and sold on the Salla Themes Marketplace. Unlike JS Web Components, bundles are completely independent of any theme, a merchant installs your bundle once and it works regardless of which theme they use, now or in the future.This is where the business opportunity is. Build a component once, publish it to the marketplace, and earn revenue from every merchant who purchases it, across the entire Salla merchants.
Theme-Independent
Your bundle works on any Salla theme. Merchants keep it even when they switch themes.
Earn Revenue
Set your price and sell to all Salla merchants directly through the themes marketplace.
Build Once, Scale Infinitely
One bundle serves the entire Salla merchant base.Get Started in 4 Steps#
3
Build and test
Use your demo store to test the bundle across different themes before publishing.
4
Publish to the marketplace
Your bundle is now available for all merchants to discover and purchase. Before publishing your Theme Bundle, you can preview and test it locally using the NPM package.1.
Install dependencies: pnpm i
2.
Run the development server: pnpm dev
Which One Is for You?#
Use JS Web Components. Drop them into your Twig templates, customise their styles, and ship. Salla maintains them — you just use them.
JS Web Components are Salla's toolkit for building themes. Component Bundles are your opportunity to build a product and sell it to the entire Salla merchant base.One is a tool. The other is a business.
