
Gumroad
Open-source source code for Gumroad, a platform where creators sell products directly to buyers.
- Stars
- 10.1k
- Forks
- 2.1k
- Licence
- MIT
- Language
- Ruby
- Last update
- 4 days ago
- Type
- App
What it is
Gumroad is an e-commerce platform that lets creators sell products directly to consumers. This repository holds the source code for the Gumroad web application, so developers can read it, run it locally, and contribute changes. It is a large Ruby on Rails style app that depends on MySQL, Docker services, and several external tools.
- Run the full web application on your own machine for development
- Run the test suite with bin/rspec
- Explore how payments, products, and seller dashboards are implemented in code
Great for
- Developers who want to study how a production e-commerce web app is built
- Engineers who already know Ruby and Rails and want to run the app locally
- Contributors willing to follow the project's contribution process
Not ideal for
- Creators who just want to sell products; they should use the hosted service at gumroad.com instead
- Beginners with no Ruby or database experience, since the setup involves many moving parts
- People hoping for a quick self-hosted store, because the README describes a development setup rather than a deployment guide
How to get it
- 1
Clone and build from source
You'll need: Ruby (version in .ruby-version) · Node.js (version in .node-version) · Docker · MySQL 8.4.x · ImageMagick
Install Bundler
gem install bundlerInstall Ruby gems
bundle installEnable correct npm version
corepack enableInstall Node dependencies
npm install - 2
Run it
- Start Docker services with make local
- Prepare the database with bin/rails db:prepare
- Start the app with bin/dev
- Open http://localhost:3000 in your browser
- 3
Get the most out of it
- Use the .env.example file as a starting point to add credentials for services like S3, Stripe, or Resend
- Test subdomain flows with seller.localhost:3000, keeping in mind cookie limits described in the README
- Use bin/rspec with a file or line number to run specific tests
- Read docs/testing.md for notes on flaky specs, VCR cassettes, and Stripe/PayPal purchase testing
Downloads
Strengths
- Ships under the MIT license, so the code can be read and reused under permissive terms
- The README documents a fairly complete local setup, including Docker services and a database step
- Includes a dedicated testing section and links to further docs on testing and users
Trade-offs
- Setup requires many system dependencies such as MySQL 8.4, Docker, ImageMagick, FFmpeg, PDFtk, and wkhtmltopdf
- The README says contributions go through a fork and email process, not a normal inbound pull request queue
- The README is truncated, so details of deployment and some features are not covered here
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.