![\"TitanPl](\"https://i.ibb.co/VpBsTg6m/tpl-Logo.png\"){kind=logo}
\n \n\n \n \n \n
\n You write zero Rust. TitanPl handles routing, bundling, runtime execution, hot reload, and deployment โ
all powered by Rust under the hood.\n
\n \n ![](\"https://img.shields.io/npm/v/titanpl?style=for-the-badge&logo=npm&logoColor=white\")
![](\"https://img.shields.io/badge/Runtime-Gravity(V8)%20%26%20Rust%20Tokio-1f2937?style=for-the-badge\"){kind=icon}
![](\"https://img.shields.io/badge/Powered%20By%20Rust%20Axum-DEA584?style=for-the-badge&logo=rust&logoColor=black\"){kind=icon}
![](\"https://img.shields.io/badge/Join-5865F2?style=for-the-badge&logo=discord&logoColor=white\"){kind=icon}
![](\"https://img.shields.io/badge/Follow-000000?style=for-the-badge&logo=x&logoColor=white\"){kind=icon}
\n \n ![](\"https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white\"){kind=icon}
![](\"https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black\"){kind=icon}
![](\"https://img.shields.io/badge/Rust-DEA584?style=for-the-badge&logo=rust&logoColor=black\"){kind=icon}
\n\n Gravity Runtime\n \n
\n \n\n \n Drift\n \n
\n\n# ๐ Quick Start\n### 1. Prerequisites\n* **Rust** (latest stable): [Install Rust](https://rust-lang.org/tools/install/) [Optional]\n* **Node.js** (v18+): Required for CLI and JS tooling.\n\n### 2. Install CLI\n**The `titanpl` CLI is used to create and manage all your new projects and everything related to Titan.**\n```bash\nnpm install -g @titanpl/cli@latest\n```\n\n### 3. Initialize & Run\nTitan guides you through selecting the perfect architecture for your needs.\n\n```bash\ntitan init my-app\n```\n\n**Select your language:**\n1. `JavaScript` (Fast, lightweight)\n2. `TypeScript` (Strict, typed)\n\n**Select your architecture:**\n1. `Standard` (Pure JS/TS)\n2. `Rust + JS/TS (Hybrid)` (High-performance native actions)\n\nInside your project:\n```bash\ncd my-app\nnpm run dev\n```\n\nYou'll see the Titan Dev Server spin up:\n```\n โฃ Titan Planet v1.0.0 [ Dev Mode ]\n\n Type: TS Actions\n Hot Reload: Enabled\n Env: Loaded\n\n๐ Starting Titan Engine...\n[Titan] 1 reply route(s) pre-computed\nTitan server running at: http://localhost:5100 (Threads: 32, Stack: 8MB, Dev Mode)\n\n\n```\n\n\n# โก Hybrid Action System\n\nTitan is unique because it allows you to write endpoints in **JavaScript, TypeScript, and Rust** within the same project.\n\n| Feature | Status | Notes |\n| :--- | :--- | :--- |\n| **Standard JavaScript** | โ Stable | Production Ready |\n| **Standard TypeScript** | โ Stable | Production Ready |\n| **Rust + JS (Hybrid)** | ๐งช Experimental | **Dev Only**, Production Under Testing |\n| **Rust + TS (Hybrid)** | ๐งช Experimental | **Dev Only**, Production Under Testing |\n\n### ๐ต TypeScript Actions (`app/actions/hello.ts`)\nFully typed, strict, and auto-compiled.\n\n```typescript\nimport { defineAction } from \"@titanpl/native\";\n\ninterface HelloResponse {\n message: string;\n user_name: string;\n}\n\n// \"defineAction\" provides automatic type inference for \"req\"\nexport const hello = defineAction((req): HelloResponse => {\n t.log(\"Handling request with strict types...\");\n\n return { \n message: \"Hello from TypeScript!\",\n user_name: req.body.name || \"Guest\"\n };\n});\n```\n\n### ๐ก JavaScript Actions (`app/actions/hello.js`)\nPerfect for business logic, rapid prototyping, and IO-bound tasks.\n```javascript\nexport const hello = defineAction((req) => {\n t.log(\"Handling user request...\");\n return { \n message: \"Hello from JavaScript!\",\n user_id: req.params.id \n };\n});\n```\n\n### ๐ด Rust Actions (Beta)\nPerfect for heavy computation, encryption, image processing, or low-level system access.\n> **Note:** The Native Rust Action API is currently in **Beta**.\n```rust\nuse axum::{response::{IntoResponse, Json}, http::Request, body::Body};\nuse serde_json::json;\n\npub async fn run(req: Request) -> impl IntoResponse {\n let result = heavy_computation();\n t.log(\"Processed 1M records in Rust\");\n Json(json!({ \"result\": result }))\n}\n```\n\n**Titan automatically detects, compiles, and routes all types.**\n* `.ts` files are type-checked and compiled with esbuild.\n* `.js` files are bundled with esbuild.\n* `.rs` files are compiled into the native binary.\n* All share the same `routes.json` configuration.\n\n---\n\n# ๐ก๏ธ Strict Type Safety & Error Logs\n\nTitan prioritizes code quality by enforcing **Strict TypeScript** logic during development. \n\nIf `titan dev` detects a type error, the server **will not run**. This ensures you never ship or test broken code.\n\n### Sample Error Output\nWhen a type error occurs, Titan pauses execution and provides a clear, actionable log:\n\n```text\n[Titan] โ TypeScript Error:\napp/actions/payment.ts(12,5): error TS2322: Type 'string' is not assignable to type 'number'.\n\n 10 | const amount: number = req.body.amount;\n 11 | \n > 12 | processPayment( \"100\" ); // Error here\n | ^^^^^^^^^^^^^^^^^^^^^^^\n\n[Titan] ๐ Server paused due to type errors. Fix them to resume.\n```\n\nOnce fixed, the server automatically resumes.\n\n---\n\n# โจ Core Capabilities\n\n### ๐ Unified Runtime API (`t`)\nAll actions (JS/TS/Rust) have access to the powerful `t` namespace:\n\n* `t.fetch(url, options)` โ High-performance HTTP client\n* `t.log(msg)` โ Sandboxed, structured logging\n* `t.jwt.sign / verify` โ Fast JWT operations\n* `t.password.hash / verify` โ Secure password handling\n* `t.db` โ Database access\n---\n\n### ๐งฉ Extensions System\nExtend the runtime with custom Rust engines using **Titan Extensions**.\n* `titan create ext