---
title: "Install evlog"
description: "Install evlog in your TypeScript project. Supports Nuxt, Next.js, SvelteKit, Hono, Express, Fastify, Elysia, NestJS, and standalone scripts."
canonical_url: "https://www.evlog.dev/start/installation"
---
# Install evlog
> Install evlog in your TypeScript project. Supports Nuxt, Next.js, SvelteKit, Hono, Express, Fastify, Elysia, NestJS, and standalone scripts.
evlog supports Nuxt, Next.js, SvelteKit, Nitro, NestJS, and any TypeScript server framework.
Add evlog ([https://www.evlog.dev](https://www.evlog.dev)) to this project.
1. Run `npx --yes evlog init --yes`. It detects the framework, installs evlog with this project's package manager, writes evlog.config.ts, wires the integration and adds the evlog rules to AGENTS.md. Do every manual step it prints, and fix what its final check flags.
2. If it reports the framework as unsupported, or you cannot run commands, install `evlog` and follow the framework's guide from [https://www.evlog.dev/llms.txt](https://www.evlog.dev/llms.txt). With no guide for it, use [https://www.evlog.dev/extend/custom-framework](https://www.evlog.dev/extend/custom-framework) for a server, or [https://www.evlog.dev/integrate/frameworks/standalone](https://www.evlog.dev/integrate/frameworks/standalone) for scripts and jobs.
3. In server code from now on: one wide event per request through the integration's logger and `log.set({ ... })`, `throw createError({ message, status, why, fix })` instead of `new Error()`, and no `console.log`.
## Install
```bash [pnpm]
pnpm add evlog
```
```bash [bun]
bun add evlog
```
```bash [yarn]
yarn add evlog
```
```bash [npm]
npm install evlog
```
### Using Agent Skills
If you use an AI assistant (Claude Code, Cursor, etc.), install the evlog skill for guided setup and code review:
```bash [Terminal]
npx skills add https://www.evlog.dev
```
Your AI assistant can then help you set up evlog, review your logging patterns, and migrate existing code to wide events. See [Agent Skills](https://www.evlog.dev/reference/agent-skills) for details.
**Try evlog map.** The `evlog` executable comes with the package. Early days, but one command scores which entry points are still dark:
```bash
npx evlog map
# or: pnpm evlog map
```
See [CLI overview](https://www.evlog.dev/cli/overview) and [`evlog map`](https://www.evlog.dev/cli/map).
## Create the config
Run `npx evlog init`, or add `evlog.config.ts` at the root of your app by hand:
```typescript [evlog.config.ts]
import { defineEvlog } from 'evlog'
export default defineEvlog({
service: 'my-app',
})
```
This one file holds every option: sampling, drains, enrichers, route filters. Your framework guide shows how it loads. See [Configuration](https://www.evlog.dev/reference/configuration).
## Wire it into your framework
Then follow the setup guide for your framework:
Module with auto-imported `useLogger` and `parseError`.
`createEvlog()` factory with `withEvlog()` handler wrapper.
Handle and handleError hooks with `event.locals.log`.
Module for Nitro v2 and v3 with plugin-based hooks.
Uses Nitro v3 module with async context.
Middleware with `context.get(loggerContext)`.
`EvlogModule.forRoot()` with global middleware.
Middleware with `req.log`.
Middleware with `c.get('log')`.
Plugin with `request.log`.
Plugin with `log` in route context.
`withEvlog()` handler wrapper + `evlog()` procedure middleware.
Beta. `routerLayer` for `HttpRouter`, `yield* EvlogLogger` in handlers.
Factory for request-scoped loggers.
See the full [Framework Integrations](https://www.evlog.dev/integrate/frameworks/overview) page for a comparison table and all available integrations including [Standalone TypeScript](https://www.evlog.dev/integrate/frameworks/standalone), [Astro](https://www.evlog.dev/integrate/frameworks/astro), and [Custom Integration](https://www.evlog.dev/extend/custom-framework).
## Type the fields you add
evlog ships with full TypeScript type definitions. No additional configuration is required.
evlog requires TypeScript 5.0 or higher for optimal type inference.
## Next Steps
- [Quick Start](https://www.evlog.dev/start/quick-start) - Learn the core concepts and start using evlog
- [Wide Events](https://www.evlog.dev/learn/wide-events) - Understand the wide event pattern
- [Adapters](https://www.evlog.dev/integrate/adapters/overview) - Send logs to Axiom, PostHog, Sentry, and more
---
- [Frameworks](https://www.evlog.dev/integrate/frameworks/overview)
## Sitemap
See the full [sitemap](https://www.evlog.dev/sitemap.md) for all pages.