diff --git a/.changeset/railway-url-fix.md b/.changeset/railway-url-fix.md
new file mode 100644
index 0000000..4a664fe
--- /dev/null
+++ b/.changeset/railway-url-fix.md
@@ -0,0 +1,5 @@
+---
+"@dashcommerce/core": patch
+---
+
+Railway/reverse-proxy: use configured public site URL for Stripe success/cancel and portal return URLs instead of request.origin which can be localhost:PORT
diff --git a/LOCALHOST_REDIRECT_FIX.md b/docs/LOCALHOST_REDIRECT_FIX.md
similarity index 100%
rename from LOCALHOST_REDIRECT_FIX.md
rename to docs/LOCALHOST_REDIRECT_FIX.md
diff --git a/OPERATOR_CHECKLIST.md b/docs/OPERATOR_CHECKLIST.md
similarity index 100%
rename from OPERATOR_CHECKLIST.md
rename to docs/OPERATOR_CHECKLIST.md