Skip to content

Commit 27bf394

Browse files
committed
Cleanup and update readme
1 parent fbd8f79 commit 27bf394

File tree

6 files changed

+53
-484
lines changed

6 files changed

+53
-484
lines changed

README.md

Lines changed: 53 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,69 @@
1-
# Welcome to Remix!
1+
![App screenshot](public/screenshot.jpg)
22

3-
- 📖 [Remix docs](https://remix.run/docs)
3+
<h1 align="center">Remix and Supabase Starter Kit</h1>
44

5-
## Development
5+
<p align="center">
6+
The fastest way to build apps with Remix and Supabase
7+
</p>
68

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/>
816

9-
```shellscript
10-
npm run dev
11-
```
17+
## Features
1218

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/)
1429

15-
First, build your app for production:
30+
## Clone and run locally
1631

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)
2033

21-
Then run the app in production mode:
34+
2. Create a Remix app using the Supabase Starter template npx command
2235

23-
```sh
24-
npm start
25-
```
36+
```bash
37+
npx create-remix@latest --template https://github.com/saltcod/remix-quickstart
38+
```
2639

27-
Now you'll need to pick a host to deploy it to.
40+
3. Use `cd` to change into the app's directory
2841

29-
### DIY
42+
```bash
43+
cd name-of-new-app
44+
```
3045

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:
3247

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+
```
3452

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)
3754

38-
## Styling
55+
5. You can now run the Remix local development server:
3956

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).

public/screenshot.jpg

88.7 KB
Loading

supabase/.gitignore

Lines changed: 0 additions & 4 deletions
This file was deleted.

supabase/config.toml

Lines changed: 0 additions & 178 deletions
This file was deleted.

0 commit comments

Comments
 (0)