Ready to try out Diploi, this section will show how to set up a Next.js Todo List app together with a Postgresql database.
- A GitHub account
- Text Editor - We recommend VSCode
- An SSH Key (for development) - See Add an SSH Key
Create an Account
To get started you need a Diploi account. Since Diploi is tightly integrated with GitHub go to pilot.diploi.dev and authenticate using your GitHub account.
Create a Project
Next we will create a project for our app. Click Projects in the top bar and then Create Project. In Diploi, a project template is used to select which containers and features (such as databases) your project will use. From the template list choose Next.js Starter.
In the project setup screen, we don’t need to change anything, but here you could choose e.g. which Core you want the project to run on or how to connect to the database.
However, we will need to create a GitHub repository for the project. Press Create a new repository and follow the instructions on how to give Diploi rights to setup the new repository on your GitHub account. Also give a name for the new repository and choose if you want it to initially be public or not.
When done press Create Project
Launch your First Deployment
In order to start developing we will need to add a development deployment to our project. Open your new project and press Create Deployment. There are a lot of options here, you could choose to create a staging or production environment or we could modify the environment. Since development is preselected the only thing we need to do here is press Create Deployment.
Now you can lean back and watch your deployment starting. You can follow the progress from the status area.
Once everything is showing green (shouldn’t take long), you can verify that your site works by clicking on App or you can connect remotely using VSCode by clicking the button. You can also connect to the container directly by using SSH.
Here’s a short recap of things you can do now:
Edit code remotely - Changes in the API or React code should be visible instantly since React is running in development mode in this deployment type.
Access the database - E.g. directly from VSCode using eg. the SQLTools extension.
Commit your code changes - Git is set up in your remote host so just commit your changes when you are done. If you add production deployments they will update automatically if you commit to the same branch.
Can it get much easier?