https://github.com/neorandom/minimal-react-setup

Minimal, scalable template with React, TypeScript, Tailwind CSS, Vite, and Supabase. Linted, styled, unopinionated, and ready for production without bloat.
https://github.com/neorandom/minimal-react-setup

eslint minimal-setup no-bloat prettier prettier-eslint react react-router reactjs supabase supabase-auth tailwind tailwindcss tailwindcss-v4 template typescript vite

Last synced: 5 months ago
JSON representation

Minimal, scalable template with React, TypeScript, Tailwind CSS, Vite, and Supabase. Linted, styled, unopinionated, and ready for production without bloat.

• Host: GitHub
• URL: https://github.com/neorandom/minimal-react-setup
• Owner: neoRandom
• License: mit
• Created: 2025-05-25T05:58:32.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-05-25T22:34:07.000Z (9 months ago)
• Last Synced: 2025-07-03T03:38:37.217Z (8 months ago)
• Topics: eslint, minimal-setup, no-bloat, prettier, prettier-eslint, react, react-router, reactjs, supabase, supabase-auth, tailwind, tailwindcss, tailwindcss-v4, template, typescript, vite
• Language: TypeScript
• Homepage:
• Size: 60.5 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Minimal React + TS + Tailwind + Supabase Setup

![](https://skillicons.dev/icons?i=nodejs,vite,react,typescript,tailwind,supabase,postgresql)

Template for a minimal but modern set of tools to make development fast and efficient. It uses:

- [Vite](https://vitejs.dev/) for quick builds

- [React](https://reactjs.org/) with built-in routing

- [TypeScript](https://www.typescriptlang.org/) for type safety and aliases

- [Supabase](https://supabase.com/) to handle the backend and authentication.

- [Tailwind CSS v4.0](https://tailwindcss.com/) for styling (w/ the official [Prettier](https://prettier.io/) plugin)

Also organized with a clean folder structure and preconfigured with linting and formatting tools to help keep everything consistent. 

Designed to avoid using any predefined UI libraries or global state managers, giving you a clean and flexible starting point, without locking you into specific choices, to build things in your own way.




## Why Use This Template?

This template focuses on **getting you up and running quickly**, while leaving room for you to choose the components and patterns that best suit your project. By avoiding bloat and unnecessary abstractions, it serves as a solid foundation for **scalable, maintainable applications**.

####  Key Features:

- **Lightweight and expandable**: no unnecessary dependencies

- **Unopinionated**: no enforced UI libraries or global state managers

- **Deployment-ready**: structured with production use in mind

- **Developer-friendly**: clean folder structure and built-in tooling




## Features

The template includes:

- ✅ Minimal setup (easy to customize)

- ✅ Full routing boilerplate

- ✅ Supabase integration

- ✅ Authentication boilerplate

- ✅ Formatting and linting

- ✅ Complete folder structure

- ✅ Ready-to-deploy project

The template **does not** include:

- ❌ UI kit

- ❌ Global state manager

- ❌ Automated tests

- ❌ Any sort of bloat




## Minimal Guide

This template includes a minimal guide to help you understand how it works and how you can customize it for your needs:

[Check it out](GUIDE.md)




## References

Based on:

- https://vite.dev/

- https://react.dev/

- https://reactrouter.com/

- https://www.typescriptlang.org/

- https://tailwindcss.com/

- https://github.com/tailwindlabs/prettier-plugin-tailwindcss

- https://supabase.com/

- https://prettier.io/

- https://eslint.org/

- https://opensource.org/license/mit

See also:

- Supabase Documentation

  - https://supabase.com/docs/

  - https://supabase.com/docs/reference/javascript/introduction

  - https://supabase.com/docs/guides/api/rest/generating-types

  - https://supabase.com/docs/guides/getting-started/quickstarts/reactjs

- UI Kit

  - https://daisyui.com/

  - https://ui.shadcn.com/

- Global State Manager

  - https://zustand-demo.pmnd.rs/

  - https://jotai.org/

  - https://redux.js.org/

- Asynchronous State Manager

  - https://tanstack.com/query/latest

- Data Validation / Hard Type Safety

  - https://zod.dev/

- ORM

  - https://www.prisma.io/

  - https://orm.drizzle.team/

- Deploy Plataform

  - https://vercel.com/

  - https://render.com/




## License

This Repository is under a [MIT LICENSE](LICENSE) - A.K.A.: feel free to use as you need ;)