|
1 |
| -# Welcome to Remix! |
| 1 | + |
2 | 2 |
|
3 |
| -- 📖 [Remix docs](https://remix.run/docs) |
| 3 | + <h1 align="center">Remix and Supabase Starter Kit</h1> |
4 | 4 |
|
5 |
| -## Development |
| 5 | +<p align="center"> |
| 6 | + The fastest way to build apps with Remix and Supabase |
| 7 | +</p> |
6 | 8 |
|
7 |
| -Run the dev server: |
| 9 | +<p align="center"> |
| 10 | + <a href="#features"><strong>Features</strong></a> · |
| 11 | + <a href="#clone-and-run-locally"><strong>Clone and run locally</strong></a> · |
| 12 | + <a href="#feedback-and-issues"><strong>Feedback and issues</strong></a> |
| 13 | + <a href="#more-supabase-examples"><strong>More Examples</strong></a> |
| 14 | +</p> |
| 15 | +<br/> |
8 | 16 |
|
9 |
| -```shellscript |
10 |
| -npm run dev |
11 |
| -``` |
| 17 | +## Features |
12 | 18 |
|
13 |
| -## Deployment |
| 19 | +- Works across the entire [Remix](https://remix.run) stack |
| 20 | + - Loaders |
| 21 | + - Actions |
| 22 | + - Auth |
| 23 | + - Client |
| 24 | + - Server |
| 25 | + - It just works! |
| 26 | +- supabase-ssr. A package to configure Supabase Auth to use cookies |
| 27 | +- Styling with [Tailwind CSS](https://tailwindcss.com) |
| 28 | +- Components with [shadcn/ui](https://ui.shadcn.com/) |
14 | 29 |
|
15 |
| -First, build your app for production: |
| 30 | +## Clone and run locally |
16 | 31 |
|
17 |
| -```sh |
18 |
| -npm run build |
19 |
| -``` |
| 32 | +1. You'll first need a Supabase project which can be made [via the Supabase dashboard](https://database.new) |
20 | 33 |
|
21 |
| -Then run the app in production mode: |
| 34 | +2. Create a Remix app using the Supabase Starter template npx command |
22 | 35 |
|
23 |
| -```sh |
24 |
| -npm start |
25 |
| -``` |
| 36 | + ```bash |
| 37 | + npx create-remix@latest --template https://github.com/saltcod/remix-quickstart |
| 38 | + ``` |
26 | 39 |
|
27 |
| -Now you'll need to pick a host to deploy it to. |
| 40 | +3. Use `cd` to change into the app's directory |
28 | 41 |
|
29 |
| -### DIY |
| 42 | + ```bash |
| 43 | + cd name-of-new-app |
| 44 | + ``` |
30 | 45 |
|
31 |
| -If you're familiar with deploying Node applications, the built-in Remix app server is production-ready. |
| 46 | +4. Rename `.env.example` to `.env.local` and update the following: |
32 | 47 |
|
33 |
| -Make sure to deploy the output of `npm run build` |
| 48 | + ``` |
| 49 | + SUPABASE_URL=[INSERT SUPABASE PROJECT URL] |
| 50 | + SUPABASE_ANON_KEY=[INSERT SUPABASE PROJECT API ANON KEY] |
| 51 | + ``` |
34 | 52 |
|
35 |
| -- `build/server` |
36 |
| -- `build/client` |
| 53 | + Both `SUPABASE_URL` and `SUPABASE_ANON_KEY` can be found in [your Supabase project's API settings](https://app.supabase.com/project/_/settings/api) |
37 | 54 |
|
38 |
| -## Styling |
| 55 | +5. You can now run the Remix local development server: |
39 | 56 |
|
40 |
| -This template comes with [Tailwind CSS](https://tailwindcss.com/) already configured for a simple default starting experience. You can use whatever css framework you prefer. See the [Vite docs on css](https://vitejs.dev/guide/features.html#css) for more information. |
| 57 | + ```bash |
| 58 | + npm run dev |
| 59 | + ``` |
| 60 | + |
| 61 | + The starter kit should now be running on [localhost:5173](http://localhost:5173/). |
| 62 | + |
| 63 | +6. This template comes with the default shadcn/ui style initialized. If you instead want other ui.shadcn styles, delete `components.json` and [re-install shadcn/ui](https://ui.shadcn.com/docs/installation/next) |
| 64 | + |
| 65 | +> Check out [the docs for Local Development](https://supabase.com/docs/guides/getting-started/local-development) to also run Supabase locally. |
| 66 | +
|
| 67 | +## Feedback and issues |
| 68 | + |
| 69 | +Please file feedback and issues over on the [Supabase GitHub org](https://github.com/supabase/supabase/issues/new/choose). |
0 commit comments