How to build a todo app with Airsequel and React

In this tutorial we will be building a very simple todo app with React. It will load the todos via GraphQL from a SQLite database hosted on Airsequel. To simplify the setup we will use Create React App to generate a bare bones React app.

This is what the final app will look like. Not pretty, but functional!

Screen Shot 2022-02-27 at 11.30.08Z.png

If you find any problems in this tutorial, please feel free to leave a comment!

Setting up the Airsequel Database

Things to know:

  • As the primary key we use the automatically generated rowid column.

First, let’s create the todo database in Airsequel’s UI. If you’re on Airsequel Enterprise you can alternatively use following steps:

  • Alternative way for Airsequel Enterprise: Upload an existing SQLite database <aside> 💡 The next steps describe how to create the database with the sqlite3 cli tool. You can of course also use one of the many graphical database management apps like e.g. DB Browser for SQLite or Beekeeper Studio.</aside>
    1. Create a schema.sql file for creating the SQLite database:

      • schema.sql

        CREATE TABLE todos (
          title TEXT NOT NULL,
          completed BOOLEAN DEFAULT (FALSE) NOT NULL
        );
        
        
        -- Add some example todos
        INSERT INTO todos (title, completed)
        VALUES
          ('Buy milk', 0),
          ('Go hiking', 1);
        
    2. Execute SQL query to create the database:

      sqlite3 todos.sqlite < schema.sql
      
    3. Go to airsequel.com and upload the todos.sqlite file.

Or build it up from scratch:

  1. Go to airsequel.com (or your custom Enterprise instance)
  2. Click on “Create New SQLite Database”
  3. Rename database to “todos”
  4. Go to the “Tables” tab
  5. Rename “table_1” to “todos”
  6. Rename column “name” to “title”
  7. Add a new column “completed” with type “Boolean” and activate “Not Null”
  8. Create a few todos like “Buy milk” and “Go hiking” to make working with it easier

🎉 Your database and the corresponding GraphQL endpoint are now ready!

It should look something like this:

Screen Shot 2022-12-11 at 21.35.28Z.png

Creating the React app

  1. Create the boilerplate code (press y on all prompts)
    npx create-react-app@latest react-todo-app