kit serve

​

Usage

kit serve [options]

​

Options

​

Examples

​

Start Both Servers

kit serve

• Backend server on http://localhost:8000
• Frontend Vite server on http://localhost:5173
• Watches for changes and auto-rebuilds
• Generates TypeScript types from Rust structs

​

Custom Ports

kit serve --port 3000 --frontend-port 3001

​

Backend Only

kit serve --backend-only

• Working on API-only features
• Frontend is deployed separately
• Running in production mode

​

Frontend Only

kit serve --frontend-only

• Backend is running elsewhere
• Testing frontend in isolation

​

Skip Type Generation

kit serve --skip-types

​

How It Works

1. Builds the Rust backend - Compiles your application in debug mode
2. Generates TypeScript types - Scans for InertiaProps structs and generates corresponding TypeScript interfaces
3. Starts the backend server - Runs your Rust application with hot-reload using cargo watch
4. Starts the frontend server - Runs Vite development server with HMR (Hot Module Replacement)

​

Development Workflow

# Terminal 1: Start the full development environment
kit serve

# Make changes to your Rust code - backend auto-rebuilds
# Make changes to your React code - frontend auto-updates

# Terminal 2: Generate migrations, run them
kit make:migration create_users_table
kit migrate

​

Environment Variables

# .env
DATABASE_URL=sqlite:./database.db
APP_PORT=8000
APP_HOST=127.0.0.1

​

Troubleshooting

​

Port Already in Use

# Find and kill the process using the port
lsof -i :8000
kill -9 <PID>

# Or use a different port
kit serve --port 8001

​

Frontend Not Connecting