Blues Stack

Overview

The Remix Blues Stack is a full-stack app development framework that provides all the necessary tools and features to build scalable and high-performance applications. It offers multi-region deployment with Docker, PostgreSQL cluster, healthcheck endpoint, GitHub Actions for deployment, authentication with cookie-based sessions, database ORM with Prisma, styling with Tailwind, end-to-end testing with Cypress, and much more. With the Remix Blues Stack, developers have the flexibility to customize and modify the stack according to their specific needs.

Features

• Multi-region Fly app deployment with Docker
• Multi-region Fly PostgreSQL Cluster
• Healthcheck endpoint for Fly backups region fallbacks
• GitHub Actions for deploy on merge to production and staging environments
• Email/Password Authentication with cookie-based sessions
• Database ORM with Prisma
• Styling with Tailwind
• End-to-end testing with Cypress
• Local third party request mocking with MSW
• Unit testing with Vitest and Testing Library
• Code formatting with Prettier
• Linting with ESLint
• Static Types with TypeScript

Installation

To install the Remix Blues Stack, follow these steps:

1. Click the “Gitpod Ready-to-Code” button to create a Gitpod workspace with the project set up, Postgres started, and Fly pre-installed.
2. Run the remix.init script and commit the changes it makes to your project.
3. Start the Postgres Database in Docker using the npm script provided. Make sure Docker finishes setting up the container before proceeding.
4. Run the first build to initialize the app.
5. Start the dev server to run the app in development mode, with assets rebuilding on file changes.
6. Use the provided database seed script to create a new user with sample data.

Alternatively, if you prefer not to use Docker, you can also utilize Fly’s Wireguard VPN to connect to a development database or production database. Instructions for setting up Wireguard and creating a development database are available.

Summary

The Remix Blues Stack provides a comprehensive set of tools and features for building full-stack applications. It offers multi-region deployment, a PostgreSQL cluster, authentication, database ORM, testing utilities, and more. Developers have the flexibility to customize the stack and easily deploy their applications using GitHub Actions. With its extensive capabilities, the Remix Blues Stack empowers developers to build scalable and performant applications efficiently.