Thanks to visit codestin.com
Credit goes to github.com

Skip to content

tyaga001/v1

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

94 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Create v1

Create v1 Hero

Open Issues License GitHub stars GitHub forks Contributors

The ultimate open-source starter kit for building production-ready SaaS applications

Everything you need to build a production-ready SaaS. It's an opinionated stack based on learnings from building Midday using the latest Next.js framework. It's a monorepo with a focus on code reuse and best practices that will grow with your business.

Table of Contents

Features and Benefits

  • πŸš€ Production-Ready: Built with best practices and optimized for performance
  • πŸ“¦ Scalable Architecture: Monorepo setup for easy code sharing and maintenance
  • πŸ›  Full-Stack Solution: Includes frontend, backend, and DevOps tooling
  • πŸ”§ Modern Tech Stack: Utilizes the latest and most powerful web technologies
  • πŸ’» Developer Experience: Optimized workflow with linting, formatting, and type safety
  • 🎨 Customizable: Easy to extend and adapt to your specific needs
  • 🌐 Internationalization: Built-in support for multiple languages
  • πŸ“§ Email Integration: Ready-to-use email templates and delivery system
  • πŸ”’ Security First: Implements best practices for authentication and data protection
  • πŸ“Š Analytics and Monitoring: Integrated tools for tracking performance and user behavior

What's Included

Core Framework

  • Next.js: React framework for production-grade apps.
  • TypeScript: Adds static typing for improved developer experience and code quality.

Styling and UI

  • TailwindCSS: Utility-first CSS framework for rapid UI development.
  • Shadcn: Customizable UI components built on top of Radix UI.

Backend and Database

  • Supabase: Open-source Firebase alternative for authentication, database, and storage.
  • Upstash: Serverless Redis for caching and rate limiting.

DevOps and Tooling

  • Turborepo: Monorepo build system for optimal DX and performance.
  • Biome: Fast linter and formatter for consistent code style.

Email and Communications

  • React Email: Customizable email templates.
  • Resend: Reliable email delivery service.

Internationalization

  • i18n: Easy-to-use internationalization library.

Monitoring and Analytics

  • Sentry: Error tracking and performance monitoring.
  • OpenPanel: Privacy-friendly analytics platform.

Additional Tools

  • Dub: Custom URL shortener and link management.
  • Trigger.dev: Powerful workflow automation platform.
  • Polar: Integrated billing solution (coming soon).

Directory Structure

.
β”œβ”€β”€ apps                         # App workspace
β”‚    β”œβ”€β”€ api                     # Supabase (API, Auth, Storage, Realtime, Edge Functions)
β”‚    β”œβ”€β”€ app                     # App - your product
β”‚    β”œβ”€β”€ web                     # Marketing site
β”‚    └── ...
β”œβ”€β”€ packages                     # Shared packages between apps
β”‚    β”œβ”€β”€ analytics               # OpenPanel analytics
β”‚    β”œβ”€β”€ email                   # React email library
β”‚    β”œβ”€β”€ jobs                    # Trigger.dev background jobs
β”‚    β”œβ”€β”€ kv                      # Upstash rate-limited key-value storage
β”‚    β”œβ”€β”€ logger                  # Logger library
β”‚    β”œβ”€β”€ supabase                # Supabase - Queries, Mutations, Clients
β”‚    └── ui                      # Shared UI components (Shadcn)
β”œβ”€β”€ tooling                      # are the shared configuration that are used by the apps and packages
β”‚    └── typescript              # Shared TypeScript configuration
β”œβ”€β”€ .cursorrules                 # Cursor rules specific to this project
β”œβ”€β”€ biome.json                   # Biome configuration
β”œβ”€β”€ turbo.json                   # Turbo configuration
β”œβ”€β”€ LICENSE
└── README.md

Quick Start

Get up and running in minutes:

bunx degit midday-ai/v1 my-saas-app
cd my-saas-app
bun i
bun dev

Visit http://localhost:3000 to see your app in action.

Prerequisites

Before you begin, ensure you have the following installed:

  • Bun: Fast all-in-one JavaScript runtime
  • Docker: Containerization platform for easy deployment
  • Git: Version control system

You'll also need accounts for the following services:

Getting Started

  1. Clone the repository:

    bunx degit midday-ai/v1 my-saas-app
    cd my-saas-app
  2. Install dependencies:

    bun i
  3. Set up environment variables:

    cp apps/api/.env.example apps/api/.env
    cp apps/app/.env.example apps/app/.env
    cp apps/web/.env.example apps/web/.env

    Update the .env files with your service credentials.

  4. Start the development server:

    bun dev
  5. Open http://localhost:3000 in your browser to see the app running.

How to Use

Adding a New Page

  1. Create a new file in apps/app/pages/
  2. Use components from packages/ui for consistent styling
  3. Update navigation in apps/app/components/Layout.tsx if necessary

Customizing the Theme

  1. Modify apps/app/tailwind.config.js
  2. Update global styles in apps/app/styles/globals.css

Adding a New API Endpoint

  1. Create a new file in apps/api/functions/
  2. Use the Supabase client from packages/supabase for database operations
  3. Test your endpoint using the included Postman collection

Implementing Internationalization

  1. Add new translations in apps/app/locales/
  2. Use the useTranslation hook in your components

Setting Up Email Templates

  1. Create new email templates in packages/email/templates/
  2. Use the sendEmail function from packages/email to send emails

Deploy to Vercel

Vercel deployment will guide you through creating a Supabase account and project.

Deploy with Vercel

Recognition

Featured on Hacker News

License

Create v1 is open-source software licensed under the MIT license.


Built with ❀️ by the Midday team and contributors.

About

An open-source starter kit

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 91.4%
  • JavaScript 5.0%
  • CSS 3.6%