Quickstart

Using our internal database to hit the ground running

This tutorial will take less than 5 minutes, and at the end, you will have successfully built a complete CRUD application.

We will use the Sample data, which includes a few tables with various data types to look at.


Getting started

  1. Create a new account at https://account.budibase.app/register (onboarding takes a few seconds).
  2. Once registered, you will be able to login.
  3. Step through the first app wizard, selecting the Budibase Sample data.

Data

Most of the columns, for example First Name, Last Name and Email, are Text data types, which is the most common.

Other types include Number, Date/Time, and more!

The values of some fields are highlighted in a coloured pill. This indicates the value to be either a Multi-select value such as the Employee Level in the Employees table, or a Relationships link such as Assigned in the Jobs table.

Data section with Sample Data

Data section with Sample Data

πŸ‘

External datasource

If you want to connect to external datasources, have a look at our Datasources section for a list of available connectors.
Further information can be found in the Introduction to Data page.


Design

As we have some data, we can now start building out the front-end of our app. This is done in the Design section, which can be navigated to via the tab at the top of the page.

Navigating to the Design section

Navigating to the Design section

The left hand panel includes four core areas for building out your apps:

  1. Screens
  2. Components
  3. Theme
  4. Navigation

When building apps you will mostly be focused on the Screen and Component views.

The core areas of the Design section

The core areas of the Design section

Autogenerated screens

To get started quickly, click on Add screen. Next select Table to create new CRUD (Create, Read, Update, Delete) screens for each of your tables.

These autogenerated CRUD screens will make use of the Table block and Side panels for fast, all-in-one data interaction.

Adding autogenerated screens

Adding autogenerated screens

Creating an auto screen for each table

Creating an auto screen for each table

When creating screens you will be asked to provide an access level, but this can always be changed later.

You can read more about screen access levels, but in this tutorial we will stick to the default of Basic access.

Selecting new screen access level

Selecting new screen access level

Upon click Done a new screen will be generated for each table selected.

Autogenerated screens

Autogenerated screens

Components

With the screens created we can view and edit the components for each. An easy way to navigate to the components panel is to click on the table within the design view.

Hovering the mouse over the table block

Hovering the mouse over the table block

Clicking on the table block to quickly navigate to the components panel

Clicking on the table block to quickly navigate to the components panel

With the table block selected, you will be able to edit its settings via the Settings Panel. Here you can change the Title, Data, Configure columns, Sorting, Filtering, and more! These settings are explained on the Table block page.

You can also click Add component to add another component to your screen. You can view a list of available core Components and learn more about Data in design.

Blocks

In Budibase there is a category of components known as Blocks, which are collections of pre-built components designed to make building your apps easier and faster.

A list of them can be found in the Blocks section of the components view.

Available Budibase blocks

Available Budibase blocks

Sometimes you will find yourself needing to make a fine-grain tweak that cannot be done through the settings panel alone.

If you wanted to edit the form fields in the side panel of a Table block, for example, you will need to click the Eject button to pop open the block.

Ejected table block resulting in a detailed component tree

Ejected table block resulting in a detailed component tree


Preview and Publish

During development you may wish to test out your app so far. Click the Preview button in the top-right to open the app in a modal. The app preview will always open the screen selected within the builder.

Preview and Publish buttons

Preview and Publish buttons

App preview showing a 'Detail' side panel

App preview showing a 'Detail' side panel

You will also notice that navigation links were automatically added to the nav bar when we created the autogenerated screens.

To view the app with a different permission level, change the View as basic user option.

A public user does not have permission to view the app by default

A public user does not have permission to view the app by default

When you are happy with your app, click Publish to make your app live in production.

Publishing an app

Publishing an app

If you click the name of your unpublished app you can change the app name, icon, and URL. When published, this edit icon will be replaced with an open app link instead.

Quick edit your app

Quick edit your unpublished app

App published!

Published app

When an app is published, green text will show you when your app was last published. In addition you will have a few other options available:

NameDescription
UnpublishRemove your app entirely from production
RevertSync your production app into dev (overwriting any changes)
PublishSync your dev app into production
EmbedGet the iframe code for Embedding your app
Open linkClick on the title of your app to open your production app in a new tab

Automate

Automations are not needed for all use-cases, however they offer powerful workflow options such as Cron jobs and Webhooks integrations.

More information can be found in the Automations page.


Settings

The settings tab includes a variety of options for your app. These include:

In addition you can Delete app. After confirmation, this will unpublish and permanently delete your app.

Settings tab

Settings tab


Further exploration

At this point you can see the speed and convenience at which Budibase allows you to get your users interacting with data.

There is however much more to explore, and a broad range of possibilities. If you wish to add logic and interactivity to your apps, these docs pages may be a good place to check out:

πŸ‘

The Budibase community

If you have any questions or want to browse what other people have been building, please reach out on GitHub Discussions or join our Discord server.