https://github.com/zbo14/fastify-nuxt-vercel
📐 A GitHub template for a Fastify / Nuxt app that deploys to Vercel
https://github.com/zbo14/fastify-nuxt-vercel
fastify nuxt nuxtjs serverless tailwindcss vercel vue vuejs
Last synced: about 2 months ago
JSON representation
📐 A GitHub template for a Fastify / Nuxt app that deploys to Vercel
- Host: GitHub
- URL: https://github.com/zbo14/fastify-nuxt-vercel
- Owner: zbo14
- Created: 2021-08-18T19:31:07.000Z (almost 5 years ago)
- Default Branch: develop
- Last Pushed: 2021-11-08T03:10:47.000Z (over 4 years ago)
- Last Synced: 2026-01-03T16:33:11.424Z (5 months ago)
- Topics: fastify, nuxt, nuxtjs, serverless, tailwindcss, vercel, vue, vuejs
- Language: JavaScript
- Homepage: https://fastify-nuxt-vercel.vercel.app
- Size: 202 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# fastify-nuxt-vercel
GitHub template for a [Fastify](https://www.fastify.io/) + [Nuxt](https://nuxtjs.org/) app that deploys to [Vercel](https://vercel.com)!
This project is intended for apps that require server-side rendering and/or business logic. If you don't have these requirements, it's better to stick with a [Jamstack](https://jamstack.org/) framework like [Gatsby](https://www.gatsbyjs.com/), [Gridsome](https://gridsome.org/), or the like.
[Tailwind CSS](https://tailwindcss.com/) and Google Fonts included.
## Build Setup
```bash
# install dependencies
$ yarn install
# serve with hot reload at localhost:3000
$ yarn dev
# build for production and launch server
$ yarn build
$ yarn start
# generate static project
$ yarn generate
```
## Deployment
You can deploy via the Vercel dashboard *or* install the [CLI](https://vercel.com/cli) and run `vercel --prod`.
Make sure the code repository is linked to the Vercel project so pushes automatically trigger deploys.
## Environment Variables
See `.env.example`. In development, the values are parsed from `.env` (gitignored). In production, you can specify the environment variables in the Vercel dashboard.
### `COOKIE_SECRET`
The secret used to sign cookies (default: none).
You can run `yarn secret:generate` to write a pseudo-random secret to `.env`.
### `SERVER_PORT`
The port the Fastify server listens on (default: 3000).
## Special Directories
You can create the following extra directories, some of which have special behaviors. Only `pages` is required; you can delete them if you don't want to use their functionality.
### `api`
Contains (1) a `common` module with predefined and custom helper functions, and (2) a `routes` subdirectory with your API routes.
To clear the example API routes, run `yarn routes:clear`.
### `assets`
The assets directory contains your uncompiled assets such as Stylus or Sass files, images, or fonts.
More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/assets).
### `components`
The components directory contains your Vue.js components. Components make up the different parts of your page and can be reused and imported into your pages, layouts and even other components.
More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/components).
### `layouts`
Layouts are a great help when you want to change the look and feel of your Nuxt app, whether you want to include a sidebar or have distinct layouts for mobile and desktop.
More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/layouts).
### `pages`
This directory contains your application views and routes. Nuxt will read all the `*.vue` files inside this directory and setup Vue Router automatically.
More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/get-started/routing).
### `plugins`
The plugins directory contains JavaScript plugins that you want to run before instantiating the root Vue.js Application. This is the place to add Vue plugins and to inject functions or constants. Every time you need to use `Vue.use()`, you should create a file in `plugins/` and add its path to plugins in `nuxt.config.js`.
More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/plugins).
### `static`
This directory contains your static files. Each file inside this directory is mapped to `/`.
Example: `/static/robots.txt` is mapped as `/robots.txt`.
More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/static).
### `store`
This directory contains your Vuex store files. Creating a file in this directory automatically activates Vuex.
More information about the usage of this directory in [the documentation](https://nuxtjs.org/docs/2.x/directory-structure/store).