Butterflies is an open-source Next.js marketplace starter kit from Tradly Platform that connects to the Tradly Headless API to power product marketplaces, event marketplaces, SaaS app directories, and single-store ecommerce sites.
What is Butterflies?
Butterflies is an open-source business website template built on Next.js with Tailwind CSS, developed by Tradly Platform. It serves marketplace content from the Tradly Headless API, taking an API key as its primary input and delivering a functional storefront or marketplace website as output. The project is licensed under the MIT License and includes advanced SEO methods that allow page meta tags to be changed programmatically.
Key Features
- Next.js framework — Built on Next.js for server-side rendering and static generation; one-click deploy buttons are provided for Vercel and Netlify.
- Tailwind CSS styling — The UI is styled with Tailwind CSS utility classes, covering landing, listing, and storefront layouts.
- Tradly Headless API integration — Uses the Tradly JS SDK to fetch products, events, ticket types, schedules, and collections from the API.
- Multiple marketplace use cases — Configure it as a product marketplace, event marketplace with booking, SaaS app directory/partner pages, or a single D2C/B2C store.
- Environment-based setup — Separate environment files for production and sandbox API keys: env/.env.prod and env/.env.sandbox.
- Advanced SEO — Page meta can be templated and updated programmatically, making the site Google-friendly.
Who is it for?
- Marketplace founders — Launch a product or event marketplace without writing frontend code; connect a Tradly backend to handle listings, tickets, and booking.
- SaaS companies — Build an app directory or partner pages to showcase integrations and partner services.
- D2C/B2C retailers — Run a single online storefront for own-brand products, with content served from the Tradly Headless API.
- Developers — Customize the Next.js/Tailwind codebase and deploy rapidly using the built-in Vercel and Netlify buttons.
What can you do with Butterflies?
- Product marketplace — Display products from the Tradly API with categories and search, creating a complete ecommerce marketplace.
- Event marketplace — Leverage ticket types, schedules, and booking APIs to sell event tickets and manage collections.
- SaaS app directory — List partner apps or integrations in a directory-style layout.
- Single store — Launch a direct-to-consumer or B2C storefront with the same codebase.
How does Butterflies work?
First, obtain a Tradly API key from the Superadmin sandbox at superadmin.sandbox.tradly.app. Then clone the repository, run npm install, and set your API key in either the production or sandbox environment file. The template then retrieves marketplace content automatically through the Tradly Headless API.
FAQ
Is Butterflies free?
Yes, Butterflies is open source and distributed under the MIT License, so you can use, modify, and distribute it freely.
What do I need to run Butterflies?
You need Node.js and npm, plus a Tradly API key from the Superadmin dashboard. You can use either the sandbox key or a production key by placing it in the corresponding environment file.
Can I deploy Butterflies to Vercel or Netlify?
Yes, the repository includes one-click deploy buttons for both Vercel and Netlify. You can clone the repo and use these buttons to deploy directly, or deploy manually after setting your environment variables.
