VP React Base 🚀

A modern, full-stack React monorepo starter built for rapid product development. It provides a production-ready foundation with authentication, internationalization, email, and infrastructure-as-code — all wired together and ready to go.

Technology Stack

This project is a monorepo managed with PNPM and utilizes a bleeding-edge stack:

• Frontend: React 19, Vite, TanStack Router, Mantine UI
• Backend: Convex (Self-Hosted, Serverless Database & Functions)
• Authentication: Better Auth
• Internationalization: Intlayer (English & Spanish)
• Infrastructure: SST (AWS EC2 / CloudFront)
• Styling: Vanilla Extract & Mantine
• Testing: Vitest

Project Structure

The codebase is organized into several packages within the packages/ directory:

• packages/app: The main web application (Vite + TanStack Router).
• packages/backend: The Convex backend (Schema, Functions, Actions).
• packages/ui: Shared UI component library (Mantine-based).
• packages/core: Core business logic, authentication, and environment handling.
• packages/email: Transactional email templates using React Email.
• packages/shared: Shared utilities and constants.

See ARCHITECTURE.md for the full layered architecture guide.

Getting Started

Prerequisites

• Node.js (v20+)
• PNPM

Installation

1. Clone the repository.
2. Copy the example env and fill in your values:

cp .env.example .env.local

3. Install dependencies:

pnpm install

Development

To start the development server for the entire stack (Frontend + Backend):

pnpm dev

Building

To build the application for production:

pnpm build

Testing

Run unit and integration tests with Vitest:

pnpm test

License

MIT