Introduction

With Frontegg environments you can test all the Frontegg capabilities in a development environment and seamlessly deploy it live to production.

The flow for using Frontegg environments follows industry best practices.

You begin with setting up and testing Frontegg features and configurations in a development environment. This allows you to explore how things work and feel comfortable with it before using it with your customers.

Once ready, deploy it to a production environment so that you can use it live in your application.

When you deploy to production, the settings from the development environment are automatically copied over to the production environment.

Our environments setup eliminates the need to:

  1. Have multiple workspaces for development, staging, and production
  2. Manually copy settings from one to the other

🚧

Currently, Frontegg copies many of the settings from development to production but not all. Read below to learn what we copy over.

If you do not need a Frontegg development environment, do not worry!

Go from integration to production super fast and without effort.

Read below to learn more about how Frontegg environments work and how you can use them.

📘

What happened to workspaces?

Frontegg environments replace the workspaces approach that we previously used. Therefore, you no longer need to create multiple workspaces and manually copy configurations from one to another.

Initial Frontegg Integration & The Development Environment

When you first integrate Frontegg into your application, you need to select your tech stack and integrate Frontegg into your application using a Frontegg development environment.

28802880

You get the full Frontegg experience in a development environment where you can test out how Frontegg works and play around with it just.

You can find your development environment in the Frontegg Portal sidebar.

From the sidebar, go to Environments ➜ Development.

14401440

On that page, you can configure Frontegg however you like.

For instance, you can set your authentication preferences, add and manage users, create and use webhooks, edit email templates, and more.

13281328

You can tell that you are in the development environment because it says so in the sidebar and at the top of the page.

You can see all the environments you are integrated with in the left navigation bar under Environments.

13581358

First Production

When you are ready to start using Frontegg live in production in your application, effortlessly deploy your Frontegg development settings to a Frontegg production environment.

If it is your first time deploying from development to production, go to the Portal and click the option to publish to production and enter your production URL in the ensuing form.

28802880

The Frontegg API is waiting for your application to send a call to it from the URL that you input.

In a separate browser window, go to your production application URL and open the Frontegg Login Box. This makes a call from your application's production URL to the Frontegg API.

📘

If you do not send a message from your application to the Frontegg API, Frontegg cannot activate your production environment.

The easiest way is to just open the Frontegg Login Box from your application as described above.


After making the call, you should see a welcome to production message in your Frontegg Portal.

When you go to production, Frontegg automatically copies development environment configurations over to the production environment.

🚧

Currently, the environment configurations that Frontegg copies are: Social Logins, SSO / SAML, Captcha, ​Emails, ​Hooks.

This eliminates any need for you to do that manually.

📘

Just the settings, not the data

Frontegg does not deploy the data from your development environment to your production environment.

This means that the tenants and users and other data you created and managed in your development environment will not be in your production environment.


Next Steps: Manage Clients

After publishing to production for the first time, the next and final step for going live in production with Frontegg is to manage your accounts.


28802880

Manage Production Environment

You can find your production environment in the Frontegg Portal sidebar.

From the sidebar, go to Environments ➜ Production.

14401440

You should see your production environment.

13281328

The production environment looks virtually identical to the development environment.

You should see all the same configurations in production that you setup in the development environment.

Create New Environments

Add a new environment from the side bar. In addition to development and production, Frontegg offers Staging and QA environments.

To add a new environment, click the + icon next to the name Environments.

28802880

Select the environment and enter your application's URL. This creates a new environment to play with!

28802880

When viewing environments in the Portal, you can tell which environment you are viewing because it says so in the sidebar and at the top of the page.

🚧

Because Frontegg does not move your tenant and user data from development to production, you will have different tenant and user data in your development and production environments.

Using Multiple Environments

Use an environment and make changes to it after without worrying about impacting other environments until you want to.

For instance, use the development environment and make changes to it after you deploy to production without worrying about impacting the production environment until you want to.

When making changes to a Frontegg environment, go to that environment in the Frontegg Portal and make changes to your configurations there.

When you are ready, deploy the changes from that environment to others by clicking the Publish button.

13281328

You will not be prompted to input a production URL again because you already did it.

Deploy To a New Environment

Use Frontegg environments to create development flows. Start with a development environment and then deploy to Staging, QA, and Production environments.


📘

You do not need to use all available environments. For instance, you can use just the Development and Production environments without others.


To move from one environment to another, go to the relevant environment in the Portal.

Click the Publish button.

13281328

Confirm that you are ready to deploy it.

Your configuration will go live in the next environment you set up. If you already have a configuration in the environment that you are publishing to, it will be overwritten.

13281328

📘

The order of environments is Development ➜ Staging ➜ QA ➜ Production.