// DOCUMENTATION

Getting Started

Everything you need to start selling with souldust.

// QUICK START

Up and running in 4 steps

01

Create your account

Sign up and connect your Stripe account. Payouts go directly to you — we never hold your money.

02

Add products

Upload images, set prices, write descriptions. Save as draft or publish immediately.

03

Configure your widget

Pick a theme, choose a widget type, and select which products to show. Preview it live.

04

Embed anywhere

Copy one script tag into your site. Shadow DOM keeps styles isolated. Done.

// EMBEDDING

The embed script

Add a single script tag to any HTML page. The widget renders inside a Shadow DOM — your site's styles won't affect it, and it won't affect yours.

your-site.html
<!-- Basic embed -->
<script
  src="https://souldust.xyz/embed/widget.js"
  data-key="sd_your_embed_key"
></script>
with-options.html
<!-- Full configuration -->
<script
  src="https://souldust.xyz/embed/widget.js"
  data-key="sd_your_embed_key"
  data-theme="midnight"
  data-type="product-card"
></script>

Data attributes

Attribute Required Description
data-key Yes Your widget embed key from the dashboard
data-theme No Visual theme: clean, midnight, neon, warm
data-type No Widget type: product-card, storefront, product-carousel
// THEMES

Visual themes

clean

Light, minimal, paper-white. Works on any light-background site. Default theme.

midnight

Dark surfaces, subtle borders, soft glows. Built for dark-mode sites and portfolios.

neon

High contrast, vibrant accents, bold typography. For sites that want widgets that pop.

warm

Cream tones, soft borders, rounded shapes. Friendly and approachable for lifestyle brands.

// WIDGET TYPES

Choose your format

PC

product-card

A rich card showing the product image (or generative art fallback), title, price, and an "Add to cart" button. Best for featuring individual products in blog posts, portfolios, or sidebars.

SF

storefront

A full product grid with filtering and search. Embed your entire catalog on any page. Responsive — adapts from single column on mobile to multi-column on desktop.

// HOSTED STOREFRONT

Your own page on souldust

Every creator gets a hosted storefront at souldust.xyz/username. No setup needed — it works automatically with your published products.

Product listing at souldust.xyz/username — all your active products in a grid.

Product detail at souldust.xyz/username/product-slug — full product page with images, description, and checkout.

Direct checkout — buyers can purchase directly from your hosted storefront. Same Stripe Connect integration, same direct payouts.

Use it as your primary store, or as a fallback for platforms that don't allow embeds. Share the link anywhere — social bios, emails, DMs.