# Manual installation

> Add GUIJam to a Vite, Next.js, Nuxt, Astro, SvelteKit, React Router or SolidStart app by hand, without running guijam init.

`npx guijam init` does all of this for you. Install by hand when `init` reports that your config is too dynamic to edit safely, or when you prefer to see every change.

## Add the package

```bash
npm install --save-dev guijam
```

The package brings the `gjd` daemon for your platform as an optional dependency, so there is nothing else to install.

## Wire it into your framework

Put GUIJam **first** in your plugins, integrations or modules, before your framework's own plugin.

**Vite**

```ts title="vite.config.ts" {2,6}
import react from '@vitejs/plugin-react';
import { guijam } from 'guijam/vite';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [guijam(), react()],
});
```

**Next.js**

```ts title="next.config.ts"
import { withGuijam } from 'guijam/next';

export default withGuijam({
  reactStrictMode: true,
});
```

**Nuxt**

```ts title="nuxt.config.ts" {2}
export default defineNuxtConfig({
  modules: ['guijam/nuxt'],
});
```

**Astro**

```js title="astro.config.mjs" {3,6}
import react from '@astrojs/react';
import { defineConfig } from 'astro/config';
import guijam from 'guijam/astro';

export default defineConfig({
  integrations: [guijam(), react()],
});
```

**SvelteKit**

```ts title="vite.config.ts" {2,6}
import { sveltekit } from '@sveltejs/kit/vite';
import { guijam } from 'guijam/vite';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [guijam(), sveltekit()],
});
```

**React Router**

```ts title="vite.config.ts" {2,6}
import { reactRouter } from '@react-router/dev/vite';
import { guijam } from 'guijam/vite';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [guijam(), reactRouter()],
});
```

**SolidStart**

```ts title="vite.config.ts" {2,6}
import { solidStart } from '@solidjs/start/config';
import { guijam } from 'guijam/vite';
import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [guijam(), solidStart()],
});
```

## Choose your AI tool

List the AI coding CLIs GUIJam can drive, then pick one:

```bash
npx guijam provider list
npx guijam provider use claude-code
```

The choice is saved for your user and applies to every project. See [AI tools](https://guijam.francistinao.com/docs/ai-tools).

## Ignore the run folder

GUIJam keeps its run state, logs and undo journal in `.guijam/`. Add it to `.gitignore`:

```txt title=".gitignore"
.guijam/
```

## Check the setup

```bash
npx guijam doctor
```
