Quick Start
Build a native Rust backend using pure JavaScript in minutes
Welcome to Titan — a JavaScript-first backend framework that compiles your JavaScript routes and actions into a native Rust + Axum server.
You write zero Rust. Titan handles routing, bundling, runtime execution, hot reload, and deployment — all powered by Rust under the hood.
⚙ Requirements
Before installing Titan, make sure you have the following installed:
Node.js v18+
Required for the Titan CLI, bundler, and JavaScript compilation pipeline.
Rust (latest stable)
Used to compile the native Rust + Axum server.
Package Manager
Use npm, pnpm, or yarn — whichever you prefer.
Verify your setup:
node -v
npm -v
rustc -V📦 Installation
Install the Titan CLI globally using your preferred package manager.
npm install -g @ezetgalaxy/titanpnpm add -g @ezetgalaxy/titanyarn global add @ezetgalaxy/titanVerify the installation:
titan --version🚀 Create first server
Create your fist titan server using titan init
titan init my-app
# Follow the interactive prompt to choose:
# - JavaScript (Standard)
# - TypeScript (Beta)
# - Rust + JavaScript (Beta)
# - Rust + TypeScript (Beta)Inside your project:
cd my-app
titan devYou'll see the Titan Dev Server spin up:
Titan Planet v26.12.1 [ Dev Mode ]
Type: Rust + TS Actions
Hot Reload: Enabled
Strict Mode: Active 🛡️
• Preparing runtime... Done
• A new orbit is ready for your app in 0.9s
• Your app is now orbiting Titan PlanetTitan will:
- Build routes
- Bundle actions
- Start Rust dev server
- Trigger instant reload
Note: Titan automatically generates a
.gitignoreduringtitan initwith all the necessary exclusions (likenode_modules,.titan_test_run, and your native build artifacts), so you don't need to add them manually.
Migrating to Hybrid Actions
To use Rust Actions in an existing project:
- Update CLI:
npm install -g @ezetgalaxy/titan - Enable Template: Add to
package.json:"titan": { "template": "rust" } - Sync Orbit: Run
titan updateto scaffold the native core.