• Blog
  • Documentation
  • Courses
  • Changelog
  • AI Starters
  • UI Kit
  • FAQ
  • Supamode
    New
  • Pricing

Launch your next SaaS in record time with Makerkit, a React SaaS Boilerplate for Next.js and Supabase.

Makerkit is a product of Makerkit Pte Ltd (registered in the Republic of Singapore)Company Registration No: 202407149CFor support or inquiries, please contact us

About
  • FAQ
  • Contact
  • Verify your Discord
  • Consultation
  • Open Source
  • Become an Affiliate
Product
  • Documentation
  • Blog
  • Changelog
  • UI Blocks
  • Figma UI Kit
  • AI SaaS Starters
License
  • Activate License
  • Upgrade License
  • Invite Member
Legal
  • Terms of License
    • Introduction
    • Technical Details
    • Clone the Repository
    • Running the Project
    • Common Commands
    • Updating the Codebase
    • Conventions
    • Navigating the Codebase
    • Walkthrough
    • Migrating from Remix
    • Code Health and Testing
    • FAQ

Running the React Router Supabase Turbo project

Learn how to run the React Router Supabase Turbo project on your local machine.

To run the project - there are some commands you need to run.

  1. Start the development server (web application)
  2. Start Supabase (ensure Docker is running)
  3. Start Stripe (optional, if you want to test the billing system)

0. Environment variables

Please create a copy of the .env.template file and rename it .env.

1. Start the development server

bash
# Start the development server
pnpm dev

This command will run the web application.

Please refer to apps/web/README.md for more information about the web application.

To get started right away, use the credentials below:

  • Email: test@makerkit.dev
  • Password: testingpassword

To confirm email addresses, please visit Inbucket: Supabase uses Inbucket to capture emails sent during the authentication process.

Testing the Super Admin locally

By default, we seed the auth.users table with a super admin user. To login as this user, you can use the following credentials:

json
{
"email": "super-admin@makerkit.dev",
"password": "testingpassword"
}

Since you require MFA for the Super Admin user, please use the following steps to pass MFA:

  1. TOTP: Use the following TOTP generator to generate a TOTP code.
  2. Secret Key: Use the test secret key NHOHJVGPO3R3LKVPRMNIYLCDMBHUM2SE to generate a TOTP code.
  3. Verify: Use the TOTP code and the secret key to verify the MFA code. Make sure the TOTP code is not expired when you verify the MFA code.
These are test credentials

The flow above is for testing purposes only. For production, you must use an authenticator app such as Google Authenticator, Authy, Bitwarden, Proton, or similar.

2. Start Supabase

Have Docker running

We need to have Docker running so that we can start the Supabase Docker container. If you don't have Docker running, please start it now.

Ensure Docker is running, the run the following command to start Supabase (or use your IDE to run the command in the package.json). Docker Desktop is the best way to get started with Docker.

bash
pnpm run supabase:web:start

This command will start the Supabase web server.

Please read the Supabase documentation for more information about starting Supabase locally.

Give Docker enough resources

If the command above fails, you may need to give Docker more resources. Please refer to your Docker software's documentation for instructions on how to do this.

3. Start Stripe

If you want to test the billing system, you can start Stripe by running the following command:

bash
pnpm run stripe:listen

This will route webhooks to your local machine.

On this page
  1. 0. Environment variables
    1. 1. Start the development server
      1. Testing the Super Admin locally
    2. 2. Start Supabase
      1. 3. Start Stripe