Local Development

Setup

To setup your local development enviroment, perform the following steps:

1. Navigate to the Application Details page.
2. Clone your application's git repository to your local machine using the provided git URL. The URL contains an access token, so there is no need for additional authentication setup
3. Click on the Create Development Info button if the tokens are not visible.
4. Click Copy .env Template to generate a pre-configured environment file with all necessary tokens and URLs
5. Create a .env file in your project root and paste the tokens you have copied before.
6. Now you are ready to start development. If you are using Codium or a derived distribution such as VS Code, you can use the pre-configured tasks to start backend and frontend. API access behaves the same way as when the application is deployed.
7. When you are happy with your changes, commit and push to the main branch

Note: Click on the VS Code Setup Instructions button to get further information about the setup process.

During .env file setup, the following tokens are configured:

Token Type	Environment Variable	Purpose
Frontend Dev Token	APP_FRONTEND_TOKEN	Authenticates frontend API calls to the platform gateway
Backend Dev Request Token	APP_BACKEND_REQUEST_TOKEN	Simulates incoming authenticated requests during local backend development
Backend Dev Token	APP_BACKEND_APP_TOKEN	Used by your backend to make authenticated API calls as the application

Note: In production (APP_STAGE=prod), your backend receives the user's authorization token automatically. The Backend Dev Request Token simulates this behavior during local development.