Vercel dev server

Based on discussions on Vercel repository, there is no way to use vercel dev command inside a monorepo.

This package aims to emulate the dev server of vercel in order to make it usable with multiple vercel project inside the same repository.

Setup

You know the song, install the dependency with your favourite package manager.

pnpm add -D vercel-dev-server
yarn add -D vercel-dev-server
npm install -D vercel-dev-server

// dev.js

const { createVercelServer } = require("vercel-dev-server");

createVercelServer().then((server) => {
  const PORT = 8080;
  const HOST = "127.0.0.1";

  // `server` is a basic http server.
  // It can takes all params mentionned in Node.js documentation
  // https://nodejs.org/api/http.html#serverlisten
  // https://nodejs.org/api/net.html#serverlistenoptions-callback
  server.listen({
    host: HOST,
    port: PORT,
  });

  console.log(`🏃‍♂️ Server started on http://${HOST}:${PORT}`);
});

After that you can create a script in your package.json in order to launch it with a short command line

pnpm add -D nodemon

{
  "scripts": {
    "dev": "nodemon dev.js"
  }
}

The last is the creation of a Vercel project. You must have an api folder with your cloud functions inside.

/
├─ node_modules/
├─ api/
│  ├─ [id].js
│  ├─ index.js
│  ├─ info.js
├─ dev.js
├─ package.json

This package doesn't transpile your code. Check examples folder to see how to use it with custom config.