Boilerplate: Fullstack with Sass Tailwind

Setup

What's included

This repo includes:

• a single, simple API endpoint (/api/v1/fruits)
• a single React component (<App />)
• an example database module (server/db/fruits.js)
• an API client module (client/apis/fruits.js)
• configuration for Vitest and testing library
• configuration for server-side debugging in VS Code
• configuration for preprocessing Sass Tailwind

Installation

From the Github UI

See the instructions here to use Github's feature to create a new repo from a template.

From the command line

git clone https://github.com/dev-academy-challenges/boilerplate-fullstack [your-project-name]
cd [your-project-name]
npm install # to install dependencies
npm run dev # to start the dev server

You can find the server running on http://localhost:3000 and the client running on http://localhost:5173.

Deployment to Dokku

Final project should be deployed to: '.pushed.nz' This server is just for final group projects.

To use pushed.nz all you need to edit is your ~/.zshrc (open with code ~/.zshrc) to replace: export DOKKU_HOST='devacademy.nz'

with: export DOKKU_HOST='pushed.nz'

and then make sure the config is reloaded, either by opening a new terminal or by running: source ~/.zshrc

Now you can follow the Deploying a full-stack web app with a database guide to deploy!

As we are using Auth0 for authenticating users, we need to update also our Application URIs, to include publicly accessible host via https protocol and by removing the port numbers from the URLs.

• Update Allowed Callback URLs on the Auth0 App like this:

  http://localhost:5173/register,
  http://localhost:5173/,
  https://stellar-share-mania-roa-24.pushed.nz/register,
  https://stellar-share-mania-roa-24.pushed.nz
  

• Same for Allowed Logout URLs:

  http://localhost:5173/,
  https://stellar-share-mania-roa-24.pushed.nz
  

• and same for Allowed Web Origins

  http://localhost:5173/,
  https://stellar-share-mania-roa-24.pushed.nz
  

As visible on the figure of Auth0 Application URIs below:

---

Provide feedback on this repo

---

For updating the deployed app...

• make sure you do the zsh thing above (changing that one line from devacademy.nz to pushed.nz)
• in your terminal run this: git remote add dokku dokku@pushed.nz:stellar-share-mania-roa-24
• if we have made structural changes to the DB (changed the migrations file), it'll need to be rolled-back, so run: dokku run npm run knex migrate:rollback
• dokku run npm run knex migrate:latest
• dokku run npm run knex seed:run

Then finally, update the deployed app with the latest code: git push dokku main