Skip to content

Docs: Add deployment guides for Heroku and Railway #3266

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
aliraza556 wants to merge 24 commits into
base: main
Choose a base branch
from
Open

Docs: Add deployment guides for Heroku and Railway #3266

aliraza556 wants to merge 24 commits into from
+1,498 −1

Conversation

@aliraza556
Copy link

@aliraza556 aliraza556 commented Jan 30, 2026 •
edited
Loading

Summary

  • Add comprehensive deployment documentation for Heroku and Railway platforms
  • Include step-by-step instructions for deploying Gumroad to both platforms
  • Add necessary configuration files for successful deployments

Changes

Documentation

  • docs/deploying-heroku.md - Complete Heroku deployment guide with:

    • Prerequisites and quick start script
    • Detailed setup instructions for buildpacks, add-ons, and environment variables
    • Troubleshooting section and cost estimation

  • docs/deploying-railway.md - Complete Railway deployment guide with:

    • Prerequisites and CLI/dashboard instructions
    • Database services configuration (MySQL, Redis, MongoDB, Elasticsearch)
    • Scaling and troubleshooting guidance

Configuration Files

  • railway.json - Railway deployment configuration
  • nixpacks.toml - Nixpacks build configuration for Railway
  • Procfile - Process definitions for web, worker, and release phases
  • Aptfile - System dependencies for Heroku APT buildpack

Test Plan

  • Verified Heroku deployment guide steps are accurate
  • Verified Railway deployment guide steps are accurate
  • Tested deployment configuration files work correctly
  • Documentation renders correctly in GitHub

ScreenShorts:

image image image

Related Issue

Closes ##2251 - Add detailed deployment guides for popular platforms

@aliraza556 aliraza556 marked this pull request as draft January 30, 2026 22:03
@aliraza556
Copy link
Author

aliraza556 commented Jan 31, 2026 •
edited
Loading

@ershad Please review the demo:

Part#1:

https://www.loom.com/share/a0a47f3ec6c940f0a7922aad017d4f0f

Part#2:

https://jam.dev/c/0df59d8b-4c31-4b6c-9a26-08cc6748cf4a?startFrom=9.76

Part#3:

image

@aliraza556 aliraza556 marked this pull request as ready for review January 31, 2026 23:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@aliraza556