mirror of
https://github.com/nuxt/nuxt.git
synced 2024-11-13 17:43:59 +00:00
115 lines
2.7 KiB
Markdown
115 lines
2.7 KiB
Markdown
---
|
|
icon: LogoFirebase
|
|
---
|
|
|
|
# Firebase Hosting
|
|
|
|
How to deploy Nuxt to Firebase Hosting.
|
|
|
|
::list
|
|
|
|
- Support for serverless build
|
|
- Minimal configuration required
|
|
::
|
|
|
|
## Setup
|
|
|
|
Nitro supports [Firebase Hosting](https://firebase.google.com/docs/hosting) with Cloud Functions out of the box.
|
|
|
|
**Note**: You will need to be on the **Blaze plan** to use Nitro with Cloud Functions.
|
|
|
|
### Using Nitro
|
|
|
|
If you don't already have a `firebase.json` in your root directory, Nitro will create one the first time you run it. All you will need to do is edit this to replace `<your_project_id>` with the project ID that you have chosen on Firebase.
|
|
|
|
This file should then be committed to version control. You can also create a `.firebaserc` file if you don't want to manually pass your project ID to your `firebase` commands (with `--project <your_project_id>`):
|
|
|
|
```json [.firebaserc]
|
|
{
|
|
"projects": {
|
|
"default": "<your_project_id>"
|
|
}
|
|
}
|
|
```
|
|
|
|
Then, just add Firebase dependencies to your project:
|
|
|
|
::code-group
|
|
|
|
```bash [Yarn]
|
|
yarn add --dev firebase-admin firebase-functions firebase-functions-test
|
|
```
|
|
|
|
```bash [NPM]
|
|
npm install -D firebase-admin firebase-functions firebase-functions-test
|
|
```
|
|
|
|
::
|
|
|
|
### Using Firebase CLI
|
|
|
|
You may instead prefer to set up your project with the Firebase CLI, which will fetch your project ID for you, add required dependencies (see above) and even set up automated deployments via GitHub Actions.
|
|
|
|
#### Install Firebase CLI globally
|
|
|
|
::code-group
|
|
|
|
```bash [Yarn]
|
|
yarn global add firebase-tools
|
|
```
|
|
|
|
```bash [NPM]
|
|
npm install -g firebase-tools
|
|
```
|
|
|
|
::
|
|
|
|
#### Initialize your Firebase project
|
|
|
|
```bash
|
|
firebase login
|
|
firebase init hosting
|
|
```
|
|
|
|
When prompted, you can enter `.output/public` as the public directory. In the next step, **do not** configure your project as a single-page app.
|
|
|
|
Once complete, add the following to your `firebase.json` to enable server rendering in Cloud Functions:
|
|
|
|
```json [firebase.json]
|
|
{
|
|
"functions": { "source": ".output/server" },
|
|
"hosting": [
|
|
{
|
|
"site": "<your_project_id>",
|
|
"public": ".output/public",
|
|
"cleanUrls": true,
|
|
"rewrites": [{ "source": "**", "function": "server" }]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
You can find more details in the [Firebase documentation](https://firebase.google.com/docs/hosting/quickstart).
|
|
|
|
## Local preview
|
|
|
|
You can preview a local version of your site if you need to test things out without deploying.
|
|
|
|
```bash
|
|
NITRO_PRESET=firebase yarn build
|
|
firebase emulators:start
|
|
```
|
|
|
|
## Deploy to Firebase Hosting via CLI
|
|
|
|
Deploying to Firebase Hosting is a simple matter of just running the `firebase deploy` command.
|
|
|
|
```bash
|
|
NITRO_PRESET=firebase yarn build
|
|
firebase deploy
|
|
```
|
|
|
|
## Demo site
|
|
|
|
A live demo is available on <https://nitro-deployment.web.app/>.
|