Before you start
Finish the GitHub guide first
Railway is the platform that takes your project files from GitHub and publishes them live on the internet. Think of GitHub as the filing cabinet and Railway as the display case.
A finished GitHub guide: your GitHub account and private repository should already exist before starting here.
- Step 1 · 3 min Create a Railway account
- Step 2 · 5 min Connect your GitHub account
- Step 3 · 2 min Deploy your project
- Step 4 · 2 min Add your collaborator
Create your Railway account
Sign up at Railway using the GitHub account that owns your project.
Railway will host your project and make it visible on the internet. The current signup flow starts from Railway's sign-in screen and uses GitHub to create your Railway account.
- Open your web browser and go to railway.com.
- Click Sign in in the top-right corner of the page.
- In the Railway sign-in window, click Continue with GitHub.
- GitHub will open a page that says Sign in to GitHub to continue to Railway App.
- Enter your GitHub username or email address and your GitHub password.
- Click Sign in.
- Complete any GitHub security prompts, such as two-factor authentication or a passkey.
- If GitHub asks you to authorize Railway App, review the screen and click Authorize Railway App.
- After GitHub sends you back to Railway, your Railway account has been created and you should be signed in.
GitHub is confirming that Railway can use your GitHub account to sign you in. This is normal, and it keeps the Railway account tied to the same GitHub account that owns your project files.
Connect your GitHub account
Verify your identity and grant Railway access.
GitHub may ask you to confirm your identity by email before allowing Railway to connect. Follow the prompts carefully and you will be through it quickly.
- After signing in to GitHub, scroll down and click Install and Allow.
- GitHub will ask you to verify your identity by email. Click Verify via Email.
- Check the inbox for the email address you used when signing up for GitHub.
- Copy the short verification code, paste it into the box on screen, and click Verify.
- On the permissions screen, leave the option set to All Repositories and click Save.
- Railway will redirect you back to its home page. That means the connection worked.
This lets Railway see your projects. It does not do anything with them unless you choose a specific repository to deploy.
Deploy your project
Select your repository and launch it on Railway.
Now that Railway and GitHub are connected, select the repository you created in the GitHub guide. Railway will use that repository to put your project live on the internet.
- From the Railway home page, click the Deploy button again.
- Click GitHub Repository from the list of options.
- You should now see a list of your GitHub repositories.
- Click the repository you created in the GitHub guide.
- Railway will begin setting up and deploying your project automatically.
Once Railway finishes, your project is deployed and running. Admit One will be able to see it and begin work.
Add your collaborator
Invite Admit One Design Studio to your Railway project.
The final step is to invite your designer so they can access your Railway project and get to work.
- From inside your Railway project, look at the bottom-right corner of the screen.
- Just above your profile picture, click the Settings icon.
- In the settings menu, click Members from the sidebar on the left.
- Click into the Invite Member email box and type the collaborator email address below.
- Leave the permission dropdown set to Can Edit.
- Click Invite to send the invitation.
Admit One will receive an email invitation from Railway. Once accepted, we will have access to your project and can begin working immediately.
All done
Both guides complete
Your GitHub repository is live, your project is deployed on Railway, and Admit One has been invited to collaborate on both platforms. If you own a domain, the domain handoff guide is the short, optional last stop — otherwise, that's everything the project needs from you.
- 1GitHub account createdComplete
- 2GitHub repository createdComplete
- 3Collaborator added on GitHubComplete
- 4Railway account created and GitHub connectedComplete
- 5Project deployed on RailwayComplete
- 6Collaborator added on RailwayComplete
Did this guide get you all the way there?
Good to hear. We'll take it from here — see you at the kickoff.
Sorry about that. Tell us where it lost you — we'll get you unstuck and fix the guide for the next person.