Supabase Database Cheatsheet

Supabase is an open-source alternative to Firebase that provides a set of tools to build scalable and secure applications. One of its key features is the Supabase Database, a powerful and easy-to-use database service. In this cheatsheet, we’ll explore some essential operations and commands to help you navigate and leverage the capabilities of the Supabase Database effectively.


Before diving into the cheatsheet, make sure you have:

  • Created a Supabase account.
  • Set up a project and obtained your API key.
  • Initialized your database and connected it to your application.

Connecting to Supabase

To interact with your Supabase Database, you need to establish a connection. Use the following code snippet in your application:

import { createClient } from '@supabase/supabase-js';

const supabaseUrl = '';
const supabaseKey = 'your-api-key';
const supabase = createClient(supabaseUrl, supabaseKey);

Replace your-project-id and your-api-key with your actual project ID and API key.

Querying Data

Retrieving Data from a Table

To fetch data from a specific table, use the select method:

const { data, error } = await supabase

Replace your_table_name with the name of your target table.

Filtering Data

Filter data based on a specific condition:

const { data, error } = await supabase
  .eq('column_name', 'desired_value');

Adjust column_name and desired_value to match your criteria.

Modifying Data

Inserting Data

Add a new record to a table:

const { data, error } = await supabase
    { column1: 'value1', column2: 'value2' },
    // Add more records as needed

Adjust your_table_name, column1, value1, etc., according to your table structure.

Updating Data

Modify existing records based on a condition:

const { data, error } = await supabase
  .update({ column_to_update: 'new_value' })
  .eq('condition_column', 'condition_value');

Replace column_to_update, new_value, condition_column, and condition_value accordingly.

Deleting Data

Remove records from a table based on a condition:

const { data, error } = await supabase
  .eq('column_to_delete', 'value_to_delete');

Adjust column_to_delete and value_to_delete as needed.

Real-time Capabilities

Supabase offers real-time functionality for your applications. Subscribe to changes in a table:

const subscription = supabase
  .on('INSERT', (payload) => {
    console.log('New row inserted:',;

Replace your_table_name and adjust the event type (‘INSERT’, ‘UPDATE’, ‘DELETE’) as required.

This cheatsheet provides a quick reference for common Supabase Database operations. For more detailed information and advanced use cases, refer to the Supabase documentation.

Supabase simplifies database management, making it an excellent choice for developers seeking a scalable and developer-friendly solution. As you explore and implement these commands, you’ll find that Supabase empowers you to build robust applications with ease.


1. What is Supabase, and how does it differ from other database solutions?

Supabase is an open-source platform that combines various tools to simplify application development. It stands out from other databases due to its real-time capabilities, ease of use, and scalability. Developers can leverage Supabase for building secure and scalable applications without compromising on flexibility.

2. How do I connect my application to the Supabase Database?

To connect your application to the Supabase Database, use the @supabase/supabase-js library. Create a client by providing your Supabase project URL and API key. This connection allows seamless interaction with your database, enabling you to perform queries, inserts, updates, and deletes.

3. Can I receive real-time updates from my Supabase Database?

Yes, Supabase offers real-time capabilities. You can subscribe to changes in a specific table and receive updates whenever there are insertions, updates, or deletions. This feature is particularly useful for building dynamic applications that need to reflect changes in real-time.

4. How do I perform basic queries to retrieve and filter data?

To retrieve data from a table, use the select method. To filter data based on specific conditions, incorporate methods like eq for equality checks. These queries allow you to fetch and manipulate data according to your application’s requirements.

5. Is Supabase suitable for large-scale applications, and how does it ensure data security?

Supabase is designed to scale with your application’s growth. It provides robust security measures, including authentication and authorization features, to safeguard your data. With Supabase, you can confidently build and deploy applications of various sizes while ensuring the integrity and security of your database.