summaryrefslogtreecommitdiff
path: root/docs/src/pages/guides/environment-variables.md
diff options
context:
space:
mode:
authorGravatar Nate Moore <natemoo-re@users.noreply.github.com> 2021-11-23 12:21:21 -0600
committerGravatar GitHub <noreply@github.com> 2021-11-23 12:21:21 -0600
commite4002f29589ecd4c3f59ccfb1948e08a0c726272 (patch)
tree983deddfad2638c71ca5c829630faf080ad02b1c /docs/src/pages/guides/environment-variables.md
parent0fb56bcabf92c23011ae23c32fe9ad33dd3153d9 (diff)
downloadastro-e4002f29589ecd4c3f59ccfb1948e08a0c726272.tar.gz
astro-e4002f29589ecd4c3f59ccfb1948e08a0c726272.tar.zst
astro-e4002f29589ecd4c3f59ccfb1948e08a0c726272.zip
docs: update env variable guide (#1990)
* docs: update env variable guide * docs: add note about access server-side variable access
Diffstat (limited to 'docs/src/pages/guides/environment-variables.md')
-rw-r--r--docs/src/pages/guides/environment-variables.md12
1 files changed, 7 insertions, 5 deletions
diff --git a/docs/src/pages/guides/environment-variables.md b/docs/src/pages/guides/environment-variables.md
index 1f7f396ad..178cb276b 100644
--- a/docs/src/pages/guides/environment-variables.md
+++ b/docs/src/pages/guides/environment-variables.md
@@ -4,25 +4,27 @@ title: Using environment variables
description: Learn how to use environment variables in an Astro project.
---
-Astro uses Vite for environment variables, and allows you to use any of its methods to get and set environment variables. Note that all environment variables must be prefixed with `VITE_` to be accessible by client side code.
+Astro uses Vite for environment variables, and allows you to use any of its methods to get and set environment variables. Note that all environment variables must be prefixed with `PUBLIC_` to be accessible by client side code.
+
+The ability to access private variables on the server side is [still being discussed](https://github.com/snowpackjs/astro/issues/1765).
## Setting environment variables
-Vite includes `dotenv` by default, allowing you to easily set environment variables with no configuration in Astro projects. You can also attach a mode (either `production` or `development`) to the filename, like `.env.production` or `.env.development`, which makes the environment variables only take effect in that mode.
+Vite includes `dotenv` by default, allowing you to easily set environment variables without any extra configuration in Astro projects. You can also attach a mode (either `production` or `development`) to the filename, like `.env.production` or `.env.development`, which makes the environment variables only take effect in that mode.
Just create a `.env` file in the project directory and add some variables to it.
```bash
# .env
-VITE_POKEAPI="https://pokeapi.co/api/v2"
+PUBLIC_POKEAPI="https://pokeapi.co/api/v2"
```
## Getting environment variables
-Instead of using `process.env`, with Vite you use `import.meta.env`, which uses the `import.meta` feature added in ES2020 (don't worry about browser support though, Vite replaces all `import.meta.env` mentions with static values). For example, to get the `VITE_POKEAPI` environment variable, you could use `import.meta.env.VITE_POKEAPI`.
+Instead of using `process.env`, with Vite you use `import.meta.env`, which uses the `import.meta` feature added in ES2020 (don't worry about browser support though, Vite replaces all `import.meta.env` mentions with static values). For example, to get the `PUBLIC_POKEAPI` environment variable, you could use `import.meta.env.PUBLIC_POKEAPI`.
```js
-fetch(`${import.meta.env.VITE_POKEAPI}/pokemon/squirtle`
+fetch(`${import.meta.env.PUBLIC_POKEAPI}/pokemon/squirtle`)
```
> ⚠️WARNING⚠️: