How do I deploy IsoCity on Railway?

You can deploy IsoCity on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: iso-city-42837aed, or join our Discord community for more assistance.

IsoCity Railway Template

Deploy IsoCity, a fully-featured open source isometric city builder, on Railway with one click.

About IsoCity

IsoCity is an open source city building simulation featuring:

🚶 Pedestrians - Citizens walking through your city
🚗 Vehicles - Cars navigating streets
🚢 Water Transport - Boats and maritime traffic
🚂 Rail Systems - Trains and railway networks
✈️ Aviation - Planes and helicopters
🚨 Emergency Services - Fire, police, and medical response
🏗️ Full City Building - Complete urban planning and management

See IsoCity in Action

Watch a demonstration of IsoCity's features:

View Demo Video on X/Twitter

The video showcases the dynamic city simulation with all transportation modes, pedestrians, and emergency services in action.

Deploy and Host

About Hosting

IsoCity is a Next.js application that requires a Node.js runtime environment. Railway provides an ideal hosting platform with:

Automatic Deployment - Push to deploy from GitHub
Scalable Infrastructure - Handle traffic spikes automatically
Zero Configuration - Works out of the box
Generated Domains - Instant public URL
Port Management - Pre-configured on port 8080

Railway handles all server management, SSL certificates, and infrastructure scaling, letting you focus on building your city.

Why Deploy

Deploying IsoCity gives you:

24/7 Availability - Your city is always accessible online
Share with Others - Send a link to friends, colleagues, or communities
Portfolio Showcase - Demonstrate your city building skills
No Local Resources - Free up your local machine
Persistent State - Your city remains online between sessions
Public Access - Anyone can visit and explore your creation
Professional URL - Get a Railway domain or use your custom domain

Common Use Cases

Personal Projects

Experiment with city planning and urban design
Create your dream metropolis
Test different city layouts and traffic patterns

Educational Purposes

Teach urban planning concepts
Demonstrate traffic flow and city logistics
Classroom simulations and exercises

Portfolio & Demonstrations

Showcase to potential employers
Present at conferences or meetups
Share with the open source community

Community & Social

Host multiplayer city viewing sessions
Share city designs with friends
Create themed cities for specific communities

Development & Testing

Test new features and modifications
Contribute to the open source project
Prototype urban planning tools

Dependencies for

Deployment Dependencies

This template requires the following to deploy successfully:

Runtime Environment:

Node.js 18.x or higher (automatically provided by Railway)
npm 9.x or higher (included with Node.js)

Core Dependencies:

Next.js - React framework for the application
React & React DOM - UI rendering
TypeScript - Type-safe JavaScript
Tailwind CSS - Styling framework
Vercel Analytics - Web analytics integration

Build Dependencies:

PostCSS - CSS processing
ESLint - Code linting
TypeScript Compiler - Type checking and compilation

System Requirements:

Port 8080 (configured automatically)
Public domain (auto-generated by Railway)
SSL certificate (handled by Railway)

All dependencies are automatically installed during deployment. No manual intervention required.

One-Click Deployment

This template automatically:

Clones the IsoCity repository
Installs all dependencies
Builds the Next.js application
Configures port 8080 for the service
Generates a public domain for your city
Deploys to Railway's infrastructure

Your city will be accessible at your generated Railway domain immediately after deployment.

Manual Deployment

If you prefer to deploy manually:

# Clone the repository
git clone https://github.com/AnarchistManifesto/isometric-city.git
cd isometric-city

# Install dependencies
npm install

# Build the application
npm run build

# Start the server on port 8080
PORT=8080 npm start

Tech Stack

Framework: Next.js
Styling: Tailwind CSS
Language: TypeScript
Analytics: Vercel Web Analytics
Hosting: Railway

Configuration

The template is pre-configured with:

Port: 8080 (automatically set)
Domain: Auto-generated Railway domain
Build Command: npm install && npm run build
Start Command: npm start

Environment Variables

The following are automatically configured by this template:

PORT=8080 - Service port
NODE_ENV=production - Production environment
Railway will automatically generate a public domain for your deployment

Custom Domain (Optional)

After deployment, you can add a custom domain in your Railway project settings:

Go to your project settings
Navigate to the "Domains" section
Add your custom domain
Update your DNS records as instructed

Repository

Original Repository: AnarchistManifesto/isometric-city

Forked from: amilich/isometric-city

License

Open Source - Check the repository for specific license details

Support

For issues or questions:

Open an issue on GitHub
Check the original repository documentation
For Railway-specific deployment issues, consult Railway's documentation

Note: This is a community-maintained Railway template. Your city will be live at your Railway-generated domain within minutes of deployment.