# Integration

Macroforge integrates with your development workflow through IDE plugins and build tool integration.

## Overview

| Integration         | Purpose                                                 | Package                           |
| ------------------- | ------------------------------------------------------- | --------------------------------- |
| TypeScript Plugin   | IDE support (errors, completions)                       | `@macroforge/typescript-plugin`   |
| Vite Plugin         | Build-time macro expansion                              | `@macroforge/vite-plugin`         |
| Svelte Preprocessor | Expand macros inside `.svelte` components               | `@macroforge/svelte-preprocessor` |
| CLI                 | Expand, watch, type-check and package from the terminal | `macroforge`                      |
| Deno Plugin         | Expansion for Deno projects (CLI + programmatic API)    | `@macroforge/deno-plugin`         |
| MCP Server          | Macro documentation and tooling for AI assistants       | `@macroforge/mcp-server`          |

## Recommended Setup

For the best development experience, use both integrations:

1. **TypeScript Plugin**: Provides real-time feedback in your IDE
2. **Vite Plugin**: Expands macros during development and production builds

Bash

```
# Install both plugins
npm install -D @macroforge/typescript-plugin @macroforge/vite-plugin
```

## How They Work Together

Your Code

TypeScript with @derive decorators

TypeScript Plugin

Language service integration

IDE Feedback

Errors & completions

Vite Plugin

Build-time transformation

Dev Server

Hot reload

Production Build

Optimized output

## Detailed Guides

- [TypeScript Plugin setup](../docs/integration/typescript-plugin)
- [Vite Plugin configuration](../docs/integration/vite-plugin)
- [Configuration options](../docs/integration/configuration)