Remix with brilliant bells and useful whistles
Remix Starter Kit is an opinionated boilerplate based off of Remix, with all the bells and whistles you would want ready, up and running when starting a Renix project with Supabase.
Out of the box you get all the essentials
- Typescript as the language choice
- Tailwind CSS for quick styling without getting out of your HTML
- Daisy UI for pre-made TailwindCSS component classes
- Tailwind UI + React Hot Toast for robust headless logic you can use for components like Dialog/Modal, Dropdown, List, etc.
- WorkSans as the App font
- Icons through React-icons for on-demand, tree-shakeable icons
- ESLint for static code analysis
- Prettier for code formatting
with Supabase support
- Authentication System with Supabase GoTrue
- User Profiles available on
/profile
as an example for Supabase PostgREST (CRUD API) (retreival-only for now) - User Avatar with Supbase Storage(AWS S3 backed effortless uploads) available on
/images/[bucket-name]/[image-name]
resource routes (retreival-only for now)
and a bunch of pre-made, hand-rolled(easily replace-able) components, that you almost always end up installing/using for any non-trivial project
Note: Refer the basic branch for a bare minimum starter structure with all the essentials
.
Quick Start
The best way to start with this template is to click “Use this template” above, create your own copy and work with it
Development
To start the project locally, run:
npm run dev
which kickstarts the Remix development and build server as well as TailwindCSS compilation in the watch mode. Open http://localhost:3000
in your browser to start working.
Check package.json
for the full list of commands available at your disposal.
How to Setup Supabase for Remix Starter Kit?
If new to Supabase
- Create account at Supabase
- Create a Organisation, and a project
Once done, or if you already have a Supabase project
- Copy the generated project’s API authentication details from
https://app.supabase.io/project/<your-awesome-remix-project>/api/default?page=auth
- Place the details in
.env
asSUPABASE_URL
andSUPABASE_KEY
- Install NPM dependencies, by running
yarn
If for any odd reasons .env files(process
access) lead to the client-side side errors, place the keys directly in /lib/supabase
and work.
Remix Starter Kit supports user profiles and user avatars. To get the profile table and storage ready, execute the following queries at https://app.supabase.io/project/<your-awesome-remix-project>/editor/sql
-- Create a table for Public Profiles
create table profiles (
id uuid references auth.users not null,
username text unique,
avatar_url text,
website text,
updated_at timestamp with time zone,
primary key (id),
unique(username),
constraint username_length check (char_length(username) >= 3)
);
alter table profiles enable row level security;
create policy "Public profiles are viewable by everyone."
on profiles for select
using ( true );
create policy "Users can insert their own profile."
on profiles for insert
with check ( auth.uid() = id );
create policy "Users can update own profile."
on profiles for update
using ( auth.uid() = id );
-- Set up Storage!
insert into storage.buckets (id, name)
values ('avatars', 'avatars');
create policy "Avatar images are publicly accessible."
on storage.objects for select
using ( bucket_id = 'avatars' );
create policy "Anyone can upload an avatar."
on storage.objects for insert
with check ( bucket_id = 'avatars' );
Known Issues
- Issue with Supabase client code accessible in the browser (as shared above)
License
MIT