After you've downloaded the starter kit, unzip it, and you should see 3 folders:
To get started, first start up the docker containers
cd infra
docker-compose up -d
This should start up your container, and it will download the images if necessary.
If you look at the docker-compose you will see we also have a caddy server running, this is a reverse proxy that will proxy all server requests to server on port 8081 (by default) and frontend requests to frontend on port 3000.
Now you can start your backend, but before you start the app, take a look at application.properties file.
You can define many different properties, but for now just set the app.admin-user-email and app.admin-user-password
This will make the application create an admin user with provided details during application startup.
Start up the backend and it should run fine.
Now let's start up the frontend as well, open the bootsaas-ui in terminal and run
npm install
In the root directory rename the .env.local.example to .env.local.
It should already be configured with NEXT_PUBLIC_BASE_URL=http://localhost:8080
Now start the frontend by running npm run dev
You can now open the app in the browser on http://localhost:8080, try to login with your previously defined credentials, and look around the dashboard.
Some of the things you might want to do next are :
Provide the github and google login api keys
Provide the s3 provider keys - ( I recommend using tebi.io )
Try registering different users, creating organizations, inviting users to organization and see how the dashboard changes based on user roles
Inspect the mails sent from the application, visit http://locahost:8025
Read the rest of this documentation to learn more about how things are implemented