Installation

Prerequisites

Mage requires Deno 2.0 or later.

# Install Deno (macOS/Linux)
curl -fsSL https://deno.land/install.sh | sh

# Install Deno (Windows)
irm https://deno.land/install.ps1 | iex

Verify your installation:

deno --version

Install Mage

Add Mage to your project:

deno add @mage/app

This adds Mage to your deno.json imports and you're ready to start building.

Verify Installation

Create a simple main.ts to verify everything works:

import { MageApp } from "@mage/app";

const app = new MageApp();

app.get("/", (c) => {
  return c.text("Hello, Mage!");
});

Deno.serve(app.handler);

Run it:

deno run --allow-net main.ts

Visit http://localhost:8000 and you should see "Hello, Mage!"

Next Steps

Head over to Getting Started to build your first real application.