Getting started with the Bison SaaS Template

Photo by Valdemaras D. on Unsplash

run

yarn create bison-app MyApp (or npx create-bison-app MyApp)

This will ask you to create a new GitHub repository:

At which point, you should create a new GitHub repository,

copy the URL,

and paste it:

At which point, it will ask you for your database name:

Wait.. what database name?

Don't worry about it, yet. We'll set that up later. For now, just stick with the defaults (or whatever values you feel like, as long as you use the same ones in the next section).

Once you hit enter and wait a few minutes, you should end up with a screen like this:

To be clear, if I scroll back to the beginning, I did get a failure step:

But everything seemed to work OK anyway.

Okay, time to set up a database. I'll be using Docker to make our lives easier.

Postgres on Docker#

Create a new file named docker-compose.yaml in your project directory and put this stuff in there:

version: '3.7'
services:
  db:
    image: postgres:12.2
    restart: always
    environment:
      POSTGRES_DB: lm_dev
      POSTGRES_USER: postgres
      POSTGRES_HOST_AUTH_METHOD: trust # don't use this long term
      PGDATA: /var/lib/postgresql/data
    volumes:
      - ./pgdata:/var/lib/postgresql/data
    ports:
      - '5432:5432'

volumes:
  pgdata:

Now, do

docker-compose up

And wa-lah! You have a postgres instance.

PS: If you have Postgres installed, you might be running it in the background and that'll mean you might get this error:

You just have to find the postgres process and stop it.

Okay, let's try and set up the data layer by running

yarn db:setup

Perfect! It works!

Finally, let's try running a development version of the site:

yarn dev

Oops. To be continued...