Documentation
Guides for deploying, self-hosting, and operating Niblr — the open-source, multi-tenant commerce platform.
Getting started
- Add Your First ProductA step-by-step walkthrough of creating your first product in the Niblr admin — title, price, images, stock, and publishing it live to your storefront.
- Create Custom PagesBuild custom pages for your Niblr store — an About page, a lookbook, a landing page — in the page builder. Set the title, address and SEO, stack content blocks, save as a draft or publish live.
- Using Content BlocksBuild store pages in Niblr's page builder — add content blocks, edit their words and styling in the inspector, and watch your real storefront update beside you as you work.
- Custom CSS for your storefrontStyle your Niblr storefront with your own CSS, written against a published set of data-nb-* attributes that survive platform updates. Covers the selector vocabulary, worked examples, what the validator strips on save, and why cart and checkout are excluded.
- Custom sections for your storefrontDesign a section the standard blocks cannot make, from one of Niblr's starting layouts — publish the layout, place it on a page, then fill in your own words and pictures. Covers what's Premium, drafts vs. publishing, and what stays hand-built.
- Connect your AI tool to your storeConnect Claude, ChatGPT, Claude Code or Gemini CLI to your Niblr store in one click: read products and orders, draft products and pages, all from your AI tool.
Integrations
- Accept Payments (Stripe & Razorpay)Connect your own Stripe or Razorpay account to take payments on your Niblr store. Bring-your-own-keys — payouts go straight to you, and Niblr never holds your funds.
- Connect a Custom DomainPoint your own domain (like shop.example.com or example.com) at your Niblr store — add two DNS records, verify, and your storefront runs on your brand's URL.
- Send Marketing Emails (Resend)Connect your own Resend account to send marketing campaigns from your store's address. Order confirmations are handled by Niblr automatically — no setup needed.
- Google Analytics & Tag ManagerAdd your Google Analytics 4 measurement ID (and optionally a Tag Manager container) to track storefront traffic and e-commerce events on your Niblr store.
- Add a voice assistant to your storefrontLet shoppers ask your store questions out loud and be shown around. Connect your own ElevenLabs account — you pay their per-minute rate directly, Niblr takes no cut and never sends your key to a browser. Covers setup, cost, what the assistant can and cannot do, and where it appears.
Your Store
- Import your catalog from Shopify or WooCommerceBring an existing Shopify or WooCommerce catalog into Niblr by pasting your store address — no CSV, no API key, no app to install. Covers what comes across, what doesn't, the review screen, and what happens when you run it twice.
- Charge VAT and issue tax invoicesTurn on VAT for your Niblr storefront — set your rate and TRN, decide whether your prices already include tax, and issue sequential tax invoices. Covers inclusive vs exclusive pricing, invoice design, billing addresses, and what Niblr deliberately does not do.
- Export Your DataDownload your catalog, orders and customers as spreadsheets, any time, on any plan including Free — what's in each file and what isn't.
- Refund an orderSend a customer back all or part of what they paid, from the order you're already looking at. Covers partial refunds, which gateways Niblr can refund through, every reason a refund is refused, and what a refund does and doesn't change on your store.
Deployment
- Deploying to VercelA full production deploy of Niblr on Vercel with Supabase for database and object storage — env vars, migrations, wildcard subdomains, and cron.
- Self-Hosting GuideDeploy Niblr on your own infrastructure — a VPS, Docker host, or any cloud that is not Vercel. Covers wildcard DNS, reverse proxy, TLS, storage, and env vars.