Punk Stack

Overview

The Remix Punk Stack is a collection of tools and technologies that can be used to build full stack applications. It is derived from The Remix Blues Stack by @remix-run and includes features such as Supabase Database integration, Email/Password Authentication with Supabase Auth, Styling with Tailwind, End-to-end testing with Cypress, and more. The stack also provides multi-region Fly app deployment with Docker, GitHub Actions for automatic deployment to production and staging environments, and includes tools for code formatting, linting, and static typing.

Features

• Multi-region Fly app deployment with Docker
• Healthcheck endpoint for Fly backups region fallbacks
• Supabase Database integration
• Email/Password Authentication with Supabase Auth
• GitHub Actions for deploy on merge to production and staging environments
• 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
• Husky pre-commit hooks running tests and linting
• Commitlint for commit message validation based on Conventional Commits
• Changelog and release management with release-it, using convential changellog

Installation

To set up and develop with the Remix Punk Stack, you’ll need to follow these steps:

1. Install dependencies.
2. Create a Supabase project on app.supabase.io and set up a new Supabase database.
3. Setup Supabase environment variables in the .env file.
4. Start the dev server.
5. Optionally, update the types from Supabase.

Here’s an example of how to start the dev server:

npm run dev

Summary

The Remix Punk Stack is a comprehensive collection of tools and technologies that provide developers with everything they need to build full stack applications. It includes features such as multi-region app deployment, database integration, authentication, testing, styling, code formatting, and more. The stack is highly customizable and can be easily forked and modified to suit individual project requirements. With its extensive set of features and easy setup process, the Remix Punk Stack is a great choice for developers looking to build robust and scalable applications.