This documentation is for a legacy version of Next.js Supabase. For the latest version, please visit the Next.js Supabase Turbo documentation

Navigating the Codebase

Learn how to navigate the Next.js Supabase codebase - so you can understand and extend the codebase to your needs.

In this section - we will take an overview of the Next.js Supabase codebase. We will look at the different folders and files and what they do.

The "supabase" folder

This is the folder generated by Supabase when initiating a new project. In this folder, Supabase stores the local configuration config.toml, the database migrations, the seed file and the tests.

Most importantly, you will be more interested in the migrations folder. This folder contains the database migrations that seed your database with the necessary tables and data when starting the Supabase server.

It's here where you will be editing or adding new migrations to your database.

The "public" folder

In this folder you can store static files that you want to serve from your application. For example, you can store images, fonts, etc. in this folder.

The "src" folder

The src folder contains the various folders and files:

  • core
  • lib
  • components
  • app
  • i18n
  • configuration.ts
  • database.types.ts

The "core" folder

The core folder contains the building blocks of your application, and the core utilities that you will use throughout your application.

It does not contain any business logic, but rather contains the building blocks that you will use to build your business logic.

Reusable components

The core/ui folder contains the reusable components that you will use throughout your application.

It's best to place here components not related to your app's business logic. For example, you can place here components like Button, Input, Select, etc.

The "lib" folder

The lib folder contains business-logic related code - and it's here where you will be writing most of your code.

The "components" folder

The components folder contains the various components that you will use throughout your application.

For example, here you can add components such as UsersList, UserDetails, UserForm, etc. If they relate to a feature, this is a good place to put them.

The "app" folder

This is the Next.js routes folder. It contains the various routes that your application will have.

The "i18n" folder

This folder contains the settings and utilities for internationalization in your application.

The "configuration.ts" file

This file contains the configuration for your application. It's here where you will configure your auth providers, your application's name, etc.

The "database.types.ts" file

This file is automatically generated by Supabase. It contains the types for your database tables and we use it to add type-safety to our database queries.


Subscribe to our Newsletter
Get the latest updates about React, Remix, Next.js, Firebase, Supabase and Tailwind CSS