10.2k GitHub stars and counting — antiwork/gumroad is a Ruby project TopGit is tracking across repositories on the platform. See what sticks
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Gumroad is an e-commerce platform that enables creators to sell products directly to consumers. This repository contains the source code for the Gumroad web application.
Contributing
We don't run an inbound review queue on this repo. To contribute a change: fork the repo, open the pull request on your own fork, then email [email protected] with a link to it. We read every submission and merge the ones we want on our side, keeping your authorship — though we can't promise a reply to each one or a timeline.
Your PR still has to meet the same bar as our own work — visual evidence for anything user-facing, QA steps, test results, and an AI disclosure naming the model. See CONTRIBUTING.md for the full guidelines and the substitutions that apply when working from a fork.
Table of Contents
Contributing
Getting Started
Prerequisites
Installation
Configuration
Running Locally
Testing
Dependencies
Integration tests
Development
Logging in
Resetting Elasticsearch indices
Push Notifications
Common Development Tasks
Linting
Getting Started
Prerequisites
💡 If you're on Windows, follow our Windows setup guide instead.
Before you begin, ensure you have the following installed:
Install a local version of MySQL 8.4.x to match the version running in production.
The local version of MySQL is a dependency of the Ruby mysql2 gem. You do not need to start an instance of the MySQL service locally. The app will connect to a MySQL instance running in the Docker container.
For MacOS:
brew install [email protected] percona-toolkit
brew link --force [email protected]
# to use Homebrew's `openssl`:
brew install openssl
bundle config --global build.mysql2 --with-opt-dir="$(brew --prefix openssl)"
# ensure MySQL is not running as a service
brew services stop [email protected]
We use ffprobe that comes with FFmpeg package to fetch metadata from video files.
For MacOS: brew install ffmpeg
For Linux: sudo apt-get install ffmpeg
PDFtk
We use pdftk to stamp PDF files with the Gumroad logo and the buyers' emails.
For MacOS: Download from here
Note: pdftk may be blocked by Apple's firewall. If this happens, go to Settings > Privacy & Security and click "Open Anyways" to allow the installation.
For Linux: sudo apt-get install pdftk
wkhtmltopdf
While generating invoices, to convert HTML to PDF, PDFKit expects wkhtmltopdf to be installed on your system. Download and install the version 0.12.6 for your platform.
Note similar to pdftk, this may also be blocked by Apple's firewall on MacOS. Follow a similar process as above.
Installation
Bundler and gems
We use Bundler to install Ruby gems.
gem install bundler
Install gems:
bundle install
Also make sure to install dotenv as it is required for some console commands:
gem install dotenv
npm and Node.js dependencies
Make sure the correct version of npm is enabled:
corepack enable
Install dependencies:
npm install
Configuration
Set up Custom credentials
App can be booted without any custom credentials. But if you would like to use services that require custom credentials (e.g. S3, Stripe, Resend, etc.), you can copy the .env.example file to .env and fill in the values.
Running Locally
Start Docker services
If you installed Docker Desktop (on a Mac or Windows machine), you can run the following command to start the Docker services:
make local
If you are on Linux, or installed Docker via a package manager on a mac, you may need superuser access to expose container ports. To do that, use sudo make local instead.
This command will not terminate. You run this in one tab and start the application in another tab.
If you want to run Docker services in the background, use LOCAL_DETACHED=true make local instead.
Set up the database
bin/rails db:prepare
For Linux (Debian / Ubuntu) you might need the following:
apt install libxslt-dev libxml2-dev
Start the application
bin/dev
This starts the Rails server, the JavaScript build system, and a Sidekiq worker.
You can now access the application at http://localhost:3000. Seller subdomains and the asset/api hosts use *.localhost (e.g. http://seller.localhost:3000, http://api.localhost:3000) — modern browsers auto-resolve these to 127.0.0.1, so no /etc/hosts edits are needed.
Local dev limitations
*.localhost over HTTP is treated as a secure context by browsers (so Stripe.js, Stripe Elements, and other secure-context APIs work), but a couple of features that need either HTTPS or a registrable cookie domain don't work in this setup:
Apple Pay — Stripe requires HTTPS for Apple Pay domain registration. Workaround: expose the app over HTTPS with ngrok (ngrok http 3000) and register the resulting hostname in the Stripe Apple Pay dashboard.
Cross-subdomain cookies (affiliate attribution, _gumroad_guid, multi-account "switch seller", session) — browsers reject Domain=localhost, so cookies set on localhost:3000 aren't sent to seller.localhost:3000. Test these flows on a single host, or front the app with a local HTTPS reverse proxy on a registrable hostname (e.g. gumroad.test via mkcert) where Domain=.gumroad.test works.
make local # start Docker services (db, Redis, etc.)
RAILS_ENV=test bin/rails db:setup # set up the test database
RAILS_ENV=test bin/rails js:export # generate JS constants for the test environment
Integration tests
Integration specs use Capybara with Selenium driving Chrome. Install Chrome from google.com/chrome.
See docs/testing.md for details on preventing flaky specs, VCR cassettes, debugging widgets, and purchase testing with Stripe/PayPal.
Development
Logging in
You can log in with the username [email protected] and the password password. The two-factor authentication code is 000000.
Read more about logging in as a user with a different team role at Users & authentication.
Resetting Elasticsearch indices
You will need to explicitly reindex Elasticsearch to populate the indices after setup, otherwise you will see index_not_found_exception errors when you visit the dev application. You can reset them using:
# Run this in a rails console:
DevTools.delete_all_indices_and_reindex_all
Push Notifications
To send push notifications:
INITIALIZE_RPUSH_APPS=true bundle exec rpush start -e development -f
Common Development Tasks
Rails console:
bin/rails c
Rake tasks:
bin/rake task_name
Linting
We use ESLint for JS, and Rubocop for Ruby. Your editor should support displaying and fixing issues reported by these inline, and CI checks these on every push.
If you'd like, you can run git config --local core.hooksPath .githooks to check for these locally when committing.
Common Issues
macOS Error When Running Tests (Related to fork())
objc[11912]: +[__NSCFConstantString initialize] may have been in progress in another thread when fork() was called.
objc[11912]: +[__NSCFConstantString initialize] may have been in progress in another thread when fork() was called. We cannot safely call it or ignore it in the fork() child process. Crashing instead. Set a breakpoint on objc_initializeAfterForkError to debug.
This issue occurs on macOS due to how the fork() system call interacts with multithreaded Objective-C applications—commonly triggered when Spring is enabled during testing.
How to Fix:
Temporarily disable Spring before running your tests to avoid this error.
TopGit's last sync did not record any GitHub topics for antiwork/gumroad. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on antiwork/gumroad?
The most recent commit recorded on antiwork/gumroad was 2 days ago, based on the GitHub push timestamp. The repository has 2.1k forks — one of the better signals of community interest.
How many stars does antiwork/gumroad have?
antiwork/gumroad has 10.2k GitHub stars — refresh the page for the live number, or check github.com/antiwork/gumroad. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is antiwork/gumroad open source?
Yes — antiwork/gumroad ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/antiwork/gumroad.
Where can I see antiwork/gumroad in action?
The project maintains a homepage at https://gumroad.com. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about antiwork/gumroad?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/antiwork/gumroad is the definitive source.
Read full README in the tab above.
Is gumroad worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of gumroad.