Remix Gospel Stack

Remix Gospel Stack: Full-Featured Monorepo with Turborepo and Fly.io Deployment

The Remix Gospel Stack is an opinionated monorepo template designed for building robust Remix applications. It leverages Turborepo for efficient pipeline management, pnpm for workspace handling, and TypeScript for static typing. This stack includes a Remix app deployable to Fly.io via Docker, alongside example packages for Prisma database integration, shadcn/ui components, and internal TypeScript libraries. It's structured to accelerate development with pre-configured tools and best practices for modern web projects.

Features:

• Monorepo Architecture: Powered by Turborepo and pnpm workspaces for managing multiple applications (Remix, Next.js) and shared packages.
• Remix Application Core: Main Remix app configured with ESM, all future flags activated, and ready for Fly.io or Vercel deployment.
• UI Package (shadcn/ui): Includes a React UI package example using shadcn/ui, with Tailwind CSS plugin and preset.
• Database Package (Prisma): A flexible Prisma wrapper supporting PostgreSQL or SQLite (with Litefs), bundled using tsup for use in other packages or apps.
• Business Logic Example: Demonstrates a repository pattern using the Prisma database package for structured data access.
• Internal TypeScript Package (No-Build): Example of a pure TypeScript package without a build step, directly consumed and compiled by Remix.
• Centralized Configurations: Dedicated packages for ESLint, TypeScript (tsconfig), and Tailwind CSS configurations to ensure consistency.
• Fly.io Deployment: Dockerized Remix application setup for multi-region deployment on Fly.io, with options for PostgreSQL or Litefs.
• GitHub Actions CI/CD: Pre-configured workflows for testing, building, and deploying to staging and production environments on Fly.io.
• End-to-End Testing: Integrated Playwright for comprehensive E2E testing of the Remix application.
• Unit Testing Framework: Utilizes Vitest and Testing Library for unit testing within various packages.
• Code Quality Tools: Enforces code formatting with Prettier and static typing with TypeScript across the monorepo.
• Turbo Generators: Includes turbo gen commands for scaffolding database setups (PostgreSQL/SQLite) and creating new internal packages.
• Docker Support: Provides Dockerfiles and scripts for building and running the Remix application locally or for deployment.
• Database Migration Management: Scripts and setup for Prisma migrations, adaptable for different database choices.

Summary:

Remix Gospel Stack offers a robust, opinionated starter kit for developers aiming to build scalable web applications using a Remix-centric monorepo. It integrates essential tools like Turborepo for build optimization, pnpm for workspace management, TypeScript for type safety, Prisma for database interaction, and shadcn/ui for UI components. With out-of-the-box support for Dockerized Fly.io deployment, CI/CD pipelines, and comprehensive testing strategies, it significantly accelerates development workflows for complex projects.