The Node.js framework that makes API development feel like magic

Why Lithia?

# Create a new Lithia projectnpx create-lithia-app my-apicd my-apinpm run dev

The Problem Lithia Solves

Quick Start

Create Your First API

npx create-lithia-app my-apicd my-apinpm run dev

Create Your First Route

// src/routes/users/route.get.tsexportdefaultasync(req,res)=>{constusers=[{id:1,name:'Alice'},{id:2,name:'Bob'},];returnres.json(users);};

Add a Dynamic Route

// src/routes/users/[id]/route.get.tsexportdefaultasync(req,res)=>{const{ id}=req.params;// Your database logic hereconstuser=awaitdb.users.findById(id);if(!user){returnres.status(404).json({error:'User not found'});}returnres.json(user);};

File-based Routing

src/routes/├── users/│   ├── route.ts          # Handles ALL methods on /users│   ├── route.post.ts     # Handles ONLY POST /users│   └── [id]/│       ├── route.ts      # All methods /users/:id│       └── route.put.ts  # Only PUT /users/:id├── products/│   ├── route.get.ts      # GET /products│   └── [slug]/│       └── route.ts      # All methods /products/:slug└── api/    └── health/        └── route.get.ts  # GET /api/health

Routing Conventions

Method-Specific Routes

// src/routes/posts/route.post.tsexportdefaultasync(req,res)=>{const{ title, content}=req.body;constpost=awaitdb.posts.create({ title, content});returnres.status(201).json(post);};

// src/routes/posts/[id]/route.delete.tsexportdefaultasync(req,res)=>{const{ id}=req.params;awaitdb.posts.delete(id);returnres.status(204).send();};

Lithia Studio

What Lithia Studio Gives You:

Real-time Dashboard

Interactive Route Explorer

Visual Route Builder

Interactive Route Tester

Live Logs Viewer

Live Configuration Viewer

Hot Reload Integration

Core Features

TypeScript-First

// src/routes/api/users/route.post.tsimporttype{Request,Response}from'lithia';interfaceCreateUserBody{name:string;email:string;age:number;}exportdefaultasync(req:Request<CreateUserBody>,res:Response)=>{const{ name, email, age}=req.body;// Fully typed!// Your logic herereturnres.json({success:true});};

Hooks System

// lithia.config.tsimport{defineLithiaConfig}from'lithia';importtype{LithiaConfig,LithiaRequest,LithiaResponse}from'lithia/types';constconfig:LithiaConfig={server:{port:3000,},hooks:{'request:before':(req:LithiaRequest,res:LithiaResponse)=>{console.log(`Incoming:${req.method}${req.url}`);},'request:after':(req:LithiaRequest,res:LithiaResponse)=>{console.log(`Completed:${res.statusCode}`);},'request:error':(req:LithiaRequest,res:LithiaResponse,error:Error,)=>{console.error('Request error:',error);},'middleware:beforeExecute':(middleware,req,res)=>{console.log(`Executing middleware:${middleware.name}`);},'middleware:afterExecute':(middleware,req,res)=>{console.log(`Middleware completed:${middleware.name}`);},'middleware:error':(middleware,req,res,error)=>{console.error(`Middleware error in${middleware.name}:`,error);},},};exportdefaultdefineLithiaConfig(config);

Lightning-Fast Hot Reload

Route-Level Middleware

// src/routes/api/users/route.get.ts// Define middlewares for this routeexportconstmiddlewares=[async(req,res,next)=>{// Authentication middlewareif(!req.headers.authorization){returnres.status(401).json({error:'Unauthorized'});}next();},async(req,res,next)=>{// Logging middlewareconsole.log(`${req.method}${req.url}`);next();},];// Your route handlerexportdefaultasync(req,res)=>{constusers=awaitdb.users.findAll();returnres.json(users);};

Comparison

Real-World Example

// src/routes/api/todos/route.get.tsexportdefaultasync(req,res)=>{consttodos=awaitdb.todos.findAll();returnres.json(todos);};// src/routes/api/todos/route.post.tsexportdefaultasync(req,res)=>{const{ title}=req.body;consttodo=awaitdb.todos.create({ title,completed:false});returnres.status(201).json(todo);};// src/routes/api/todos/[id]/route.put.tsexportdefaultasync(req,res)=>{const{ id}=req.params;const{ completed}=req.body;consttodo=awaitdb.todos.update(id,{ completed});returnres.json(todo);};// src/routes/api/todos/[id]/route.delete.tsexportdefaultasync(req,res)=>{const{ id}=req.params;awaitdb.todos.delete(id);returnres.status(204).send();};

Documentation

Contributing

How to Contribute

Types of Contributions

Community & Support

Support the Project

License

Built with ❤️ by the Lithia community

GitHub •Documentation •OpenCollective •Discussions