Skip to content

Latest commit

 

History

History
88 lines (59 loc) · 2.67 KB

deploy-vercel.md

File metadata and controls

88 lines (59 loc) · 2.67 KB

Vercel Deploy

Vercel is one very tested hosting service and fits with Nullstack serverless feature.

Since v0.11.5 Nullstack already supports the way Vercel deploy apps.

So, simply follow the default guide, with details here and below:

Create api/nullstack.js to export the production application server

import application from '../.production/server'

export default application.server;

Add the following vercel.json to the root folder in order to redirect all requests to nullstack:

{
  "version": 2,
  "functions": {
    "api/nullstack.js": {
      "includeFiles": ".production/**"
    }
  },
  "routes": [
    {
      "handle": "filesystem"
    },
    {
      "src": "(.*)",
      "dest": "api/nullstack.js"
    }
  ]
}

Rename build to vercel-build in package.json scripts

  "scripts": {
    "start": "npx nullstack start",
    "vercel-build": "npx nullstack build --mode=ssr"
  }

And ready to go! You can upload to an repository and integrate Vercel or do a local deploy with Vercel CLI.

Configuring Environment Variables

By default, Nullstack needs variables as the project name and domain.

Variables can be configured when importing an app from Github, or in project's settings page, know more in Vercel documentation.

Deprecated Guide

For compatibility, we'll be mantaining the old tutorials here:

Having your project in a online repository, run in the terminal opened at it's folder:

npx nulla new-ci vercel

It generates the deploy files that Vercel requires.

Manual Deploy

If for some reason you only want to deploy manually from local environment, then there are other steps, take a look at Vercel CLI docs for getting ready and run in the terminal opened at project folder:

vercel dev

It installs dependencies (if needed), run your build command, and make a Vercel deploy (creating project if inexistent).

With everything going nicely, you gonna have the link of your deployed site at clipboard, project at your Vercel Dashboard and even environment variables (if there's a local .env file) configured.

With every change to be deployed you gonna need to run this deploy command.

Tip: it can be used as a package.json script too

Caveats

Currently Vercel only supports deploying Nullstack apps running in serverless mode.

We keep working on research for turning possible deploy of other Nullstack build modes, together with making the whole process easier.