Skip to content
beluga

build your own store

Beluga is open-source software for running your own ecommerce site. React, Node.js and Stripe, on a server you control, in code you can change.

Read the docsQuickstartExamples
The Whale Hello There storefront: a periwinkle header, a hero band with a beluga and the words Whale hello there, and a Featured row of three products

what you get

Section titled “what you get”
  • Design your own storeTheme it from the admin, or replace the storefront components outright.
  • Products, variants and collectionsUp to three priced axes per product, images per variant, CSV in and out.
  • Cart and checkoutStripe’s hosted checkout page, so card fields never touch your server.
  • Orders, shipping, tax and refundsZones and weight bands, Stripe Tax, refunds that restock.
  • Email and webhooksOrder emails over any SMTP, and signed webhooks to whatever you run.
  • AccountsStaff invitations, customer logins, abandoned-cart reminders.

example pages

Section titled “example pages”

A product page for Beluga Buffet, with an Animal dropdown, a Gift wrap dropdown, a price and an Add to cart button A product page. Choosing an animal changes the price and the picture; gift wrap is free.

The shop page: two collections with cover images above a searchable, sortable grid of products The catalogue, with collections, search and sorting.

The admin product editor for Beluga Buffet, with Basics, Visibility and Search appearance panels and a greyed-out Publish to Stripe button The admin’s product editor. Press Publish to send the product to Stripe.

a match made in heaven?

Section titled “a match made in heaven?”

🐋 beluga will be your jam if

  • you want to sell products online
  • you want full control over the look and feel of your store
  • you want to save money by hosting your own site
  • you are comfortable working with React and Node.js the database is SQLite or Postgres, your pick
  • you work with an AI assistant and want it to know the real rules the docs ship as one Markdown file for exactly that

you’d be better off with a paid service if

  • you don’t want to write code to create your store the admin covers a lot, but the landing page is a React component
  • you want someone else to host it there is no hosted beluga, and there will not be one
  • you need live carrier rates or shipping labels beluga ships zones and weight bands, not a carrier integration
  • you want customer support while setting up beluga is open-source software, not a paid service

Looking for the original beluga? View the v1 docs.

🎷🐋 beluga is built by rachel binx