Introduction
bohr.io is a serverless platform designed for people starting to program, perfect for making your first deployments, whether for a portfolio, college project, job interview test, or any other project.
It's a unified solution to meet all beginner's needs, entirely focused on the developer experience. bohr.io is a unique tool in the market with incredible and unprecedented usability.
The platform is tightly integrated with GitHub, especially with GitHub Actions, the environment where the build
for each project is performed.
Getting started with Bohr.io
First of all, you must have a bohr.io account. Then, to create a project on bohr.io, you can choose a template or import a GitHub repository created using any framework. You can also create a new project directly from the terminal and deploy it on bohr.io instantly!
Using a template
To use a template, navigate to the projects page, click "Add a New Project," and select the template.
Next, set the desired subdomain, domain, username, and GitHub repository. At this stage, you may need to grant permissions to Bohr if you haven't done so earlier. Now, you can simply use the pre-prepared build and development variables and publish your project!
There you go! Your project is already live and ready to be accessed. Now, you can edit your code and take advantage of bohr.io’s CI/CD along with GitHub Actions for automatic deployments of your changes.
Importing a project
To import a project, go to the projects page, click "Add a New Project," and then click "Import from Github." Now, select the repository with the project you want to import. At this stage, you may need to grant permissions to bohr.io if you haven't done so earlier.
Next, define the desired subdomain, domain, and desired environment variables.
There you go. Now, bohr.io will be installed in your GitHub repository, and your project will be deployed on bohr.io. Once it's finished, your project will already be live and ready to be accessed. Now, you can edit your code and take advantage of bohr.io’s CI/CD along with GitHub Actions for automatic deployments of your changes.
Using the Terminal
You can use the terminal to create and publish projects on the platform. You can also use the terminal locally or the terminal available within bohr.io.
In this example, we'll create a Next.js project and name it "my-next-app," then click the "npx create-next-app" button and set your preferences. The project will then be initialized automatically.
Now, navigate to your new Next.js project folder by clicking the "cd /app/my-next-app" button.
With your new project already created, you must publish it on bohr.io by clicking the "npx bohr deploy" button. bohr.io will install, build, and deploy the project within the platform. Once finished, your project will be live and ready to be accessed via the link provided in the terminal.
Now, you can also create a GitHub repository for your new project by clicking the "gh repo create" button and setting your repository preferences.
Then, you can navigate to your project's page and benefit from bohr.io's CI/CD along with GitHub Actions to automatically deploy your changes.
Publishing the back-end
With Bohr Functions it is also possible to publish your back-end quickly and easily, simply place your API (in Node.js) in the "api/core" folder as shown below.
To use your back-end, simply access your project's url by adding "/api" to the path.
Features
Discover other platform capabilities:
Fullstack
You can publish projects with both front-end and back-end. Just place your API (in Node.js) in the API folder. You can find more information in the Dashboard Template, for example.
Logs
With bohr.io, you can view the your back-end logs within the platform through the Logs menu.
Environment Variables
Store database credentials, API keys, and other data in the Environment Variables feature.
Content Editing
Bohr.io offers an essential content editing feature integrated into the platform, where some changes can be made directly on the page, such as adding links and formatting text (bold, italic, etc.), among other options.
On the project screen, you also access the link to the repository created on GitHub.
Project Preview
bohr.io allows you to preview realistic, real-time simulations of your project on mobile devices (smartphones, tablets) and different types of displays (desktop and laptop).
Collaboration Feature
Using Durable Objects (Cloudflare) and liveblocks technologies, bohr.io allows developers working on the same project to view each other's activities in real time.
Visual Studio Code for the Web
On the project screen, there's a link to Visual Studio Code for the Web to simplify the developer's work in creating and reviewing code.
Dogfooding
Dogfooding means using your own products. Our platform fits into this concept since bohr.io is a project within bohr.io itself. In other words, you can open bohr.io within bohr.io (something like the movie Inception by director Christopher Nolan). 🤩
See Also
In the side menu or the links below, you can access documentation for specific areas of bohr.io: