Get started working locally on your app in a few easy steps. Open your terminal app, and:
Create a new application:
npm create "@enhance" ./begin-app -y
cd to your Begin project directory:
Start the app locally:
Open your browser to
https://localhost:3333 to start testing your app locally.
Note: you can specify the port to run your app locally by passing --port as a command line parameter. For more information see the docs on the begin dev command.
Any changes to the code in the
app folder of your project will trigger a live reload.
Note: livereload will execute your api routes along with each change as long as it matches the current path. Be mindful of how a reload might interact with your app’s data layer.
If you code depends on environment variables
begin dev does not read them from the operating system. Instead, you need to be explicit in passing these variables to your local development environment.
To pass environment variables into
begin dev create a file named
.env in the root of your project. You then specify the variables as key/value pairs separated by a
=. For example:
For more information on how to set environment variables for your deployed environments see Environment Variables
Never check in your
.env file to source code control. By default
.env is included in your projects
.gitignore file to prevent you from accidentally leaking secrets on the internet.