jakejscott / remix-render-starter

A remix starter, with deployment to render.com hosting, complete with DB, migrations, ORM, and basic auth

Welcome to Remix + Render starter kit!

This repository contains a remix starter kit + deployment to render.

• Remix Docs
• Render Docs

This starter kit includes a full DB, user-registration, and authentication.

Requirement

• node >=14
• docker and docker-compose

Tech Choices

• framework: remix
• deployment/hosting: render
• DB: postgres
• ORM and migrations: prisma
• styles: tailwindcss
• UI components: daisy ui
• environment variables: dotenv
• local dependencies: docker + docker-compose

Initial setup

Run npm install.

Copy .env.example to .env:

cp .env.example .env

Development

From your terminal:

npm run dev

This starts your app in development mode, rebuilding assets on file changes.

Deployment

This project uses an "Infrastructure as Code" approach, and the deployment configuration is defined in the render.yaml file at the root of the project.

See Render's IaC documentation for more.

To deploy this app, follow the directions to connect your render.yaml to your render account:

1. Fork this repository
2. Optionally update the name of your service in the render.yaml file
3. Open the render dasbhoard, Click Blueprints in the navigation sidebar.
4. Click the New Blueprint Instance button.
5. Select your forked repository

Once selected, you’ll see a list of the changes that will be applied based on the contents of render.yaml. If there’s an issue with the file you’ll see an error message. If everything looks good, click Apply to create the resources defined in your file.

Both an application server and a database should be created.

Once the deployment is complete, you should be able to open up your application in the public URL provided by render.