tidewave_js

Tidewave is the coding agent for full-stack web app development. Integrate Claude Code, OpenAI Codex, and other agents with your web app and web framework at every layer, from UI to database. See our website for more information.

This project supports:

• Next.js 15/16
• TanStack Start with React
• Vite with React/Vue (which includes Astro, VitePress, etc)

If you are using React/Vue with Django, FastAPI, Flask, Phoenix, or Rails, follow the steps here instead.

This project can also be used through the CLI or as a standalone Model Context Protocol server.

If you are using Next.js, install Tidewave with:

$ npx tidewave install
# or
$ yarn dlx tidewave install
# or
$ pnpm dlx tidewave install
# or
$ bunx tidewave install

And you are almost there! Now make sure Tidewave is installed and you are ready to connect Tidewave to your app.

In case the command above do not work, you can toggle the manual installation instructions below

<details> <summary>Show manual installation steps</summary><br />

1. Add Tidewave as a dependency

$ npm install -D tidewave
# or
$ yarn add -D tidewave
# or
$ pnpm add --save-dev tidewave
# or
$ bun add --dev tidewave

2. Create `pages/api/tidewave.ts`

Then create pages/api/tidewave.ts with:

import type { NextApiRequest, NextApiResponse } from 'next';

export default async function handler(
  req: NextApiRequest,
  res: NextApiResponse,
) {
  if (process.env.NODE_ENV === 'development') {
    const { tidewaveHandler } = await import('tidewave/next-js/handler');
    const handler = await tidewaveHandler();
    return handler(req, res);
  } else {
    res.status(404).end();
  }
}

export const config = {
  runtime: 'nodejs',
  api: {
    bodyParser: false, // Tidewave already parses the body internal