Skip to content

jacebenson/seedling

 
 

Repository files navigation

Seedling is the beginning of your next project. It builds on RedwoodJS with some conventions that will save you time at the cost of choice. However, if you're prototyping you may not want to choose how auth, email, and automation are built in and would rather just write the code that adds value.

Technologies

This is dependent on the following technologies.

Features

Convention over configuration

We want a clear way to solve most problems, if it can be solved it should be done in a repeatable way.


Authentication providers

Today we support dbAuth, and Auth0. Just change your environment variables to switch.


Beautiful Responsive Emails

No one likes the minefield that is email. MJML helps build your templates and make them beautiful on every client.


Privacy is important to us

We've taken steps to ensure that your users' privacy is respected.


Security Roles

Table and field level roles by default are set so you can simply give them out and not figure them out.


Row Level Security

Row Level Security is hard, we a convention for how to do this that makes sense.


Automate with rules

Rules are api side logic that run before and after create, read, update and delete operations.


Accessibility

We use Chakra-UI to make these sites as accessible as possible.


Forms and Lists

When generating pages and components from models, we build out sortable, searchable, filterable lists, and common forms.


Own your data

When you own it, you can do whatever you want with it. That's a tool hard to replace when you give away your keys.



Roadmap

  • Authentication Targets
    • dbAuth
    • Auth0
    • Clerk
    • Azure Active Directory
    • Magic.Link
    • Supabase
  • Security
    • Table level security
    • Field level security
    • Row level security
    • Roles controlled on your database applied from the group to the user
    • Field level security
      • Field data on Read can be hidden (by modifying returned data)
      • Field data on ReadAll can be hidden (by modifying returned data)
      • Field data on Create OR Update can be rejected (by changing status from 'success')
      • Field data on Create OR Update can be removed (by deleting incoming data)
    • Secure by default
      • We've included roles when you generate new models to control who can Create, Read, Update, and Delete
      • Protective steps to mitigate XSS, and Clickjacking have been taken
  • Email Providers
    • Mailgun
    • Mailchimp
    • Mailjet
    • Nodemailer
    • Sendinblue
    • Sendgrid
    • Amazon SES
  • Privacy
    • No third-party data gets your data
    • Users' emails/usernames masked by directives
    • By default, users' can delete their accounts

Getting Started, want to give it a go?

You have a few options here.

  1. You can play around on the demo site, https://seedling.tskr.io with logins and passwords matching for admin, manager, and employee.
  2. Goto [seedling.tskr.io] and click Deploy to Netlify to build your repo with proper environment variables.
  3. Use this template to get started. This will generate a Gitpod build to get you up and running. You will still need a postgres connection URL for your database.

Running locally

  1. Fork the Repository.

  2. Clone your fork

    git clone https://github.com/tskrio/seedling.git seedling
  3. Go to the project directory

    cd seedling
  4. Install dependencies

    yarn i
  5. Configure a PostgresDB

    This is a bit more involved but you'll need a database somewhere either on your machine or hosted somewhere. I generally set up a https://railway.app postgressql database

    • Provision a PostgreSQL project.
    • Click on PostgreSQL, then Connect.
    • Copy the Postgres Connection URL
  6. Configure Environment Variables

    Modify the ./.env file to have a DATABASE_URL and SESSION_SECRET. Paste in your connection string and add the following to the end.

    ?connection_limit=1
    

    It should look like so.

    DATABASE_URL=postgres:https://<user>:<pass>@<url>/<db>?connection_limit=1
    SESSION_SECRET=replaceme
    
  7. Push SQL to your database

    yarn rw prisma migrate dev
  8. Generate a new secret

    yarn rw g secret

    Update your ./.env file's SESSION_SECRET

  9. Start the server

    yarn rw dev
  10. Seed the database

    #not yet written

    Alt. intstructions

    • Start your server yarn rw dev
    • Open the browser and go to https://localhost:8910/
    • Signup
    • Open Prisma Studio yarn rw prisma studio
    • Identify your user's ID
    • Create a Group (note the ID)
    • Create a GroupMember with user's ID and group's ID
    • Create a GroupRole with group's ID, and role of admin

    From here on out, you can create groups, and users in the browser, but the initial user and rights needed to be set up. There's an issue with seeding on windows which is why these instructrions are ... long.

Running in Gitpod

  1. Fork the Repository.

  2. Goto your fork.

  3. Configure a PostgresDB

    This is a bit more involved but you'll need a database somewhere either on your machine or hosted somewhere. I generally set up a https://railway.app postgressql database

    • Provision a PostgreSQL project.
    • Click on PostgreSQL, then Connect.
    • Copy the Postgres Connection URL
  4. Set up your environment variables in gitpod.

    Name Scope Value
    DATABASE_URL yourName/seedling Connection String from above
    SESSION_SECRET yourName/seedling Well set this later
  5. Open in Gitpod

  6. When the terminal comes do the following.

  7. Push your schema to your database via yarn rw prisma migrate dev.

  8. Generate a new secret via yarn rw g secret.

  9. Copy that string and set it in the varables for gitpod.

  10. Stop your workspace via the menu. Then relaunch it.

Troubleshooting

Right now, sometimes when setting this up for the first time, permissions aren't always added. I have an issue to make this better, but until then here's how to get around it.

  1. Goto prisma's studio by running this on your command line; yarn rw prisma studio
  2. Verify you have a user you created or admin is there. If missing, spin up yarn rw dev and Sign up and try again.
  3. Still stuck? Verify there's group roles associated to the user and group in question. If missing, create a group in prisma studio, and a group role of admin.

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 93.8%
  • CSS 5.3%
  • Other 0.9%