SSWConsulting/SSW.Website

Generator for ssw.com.au

SSW.Website

This repository is a v3 of the zzSSW.Website. This website uses NextJS with TinaCMS.

Watch the demo:

See the important Documents

• Instructions - Compile (F5 Experience)
• Instructions - Deployment
• Business
• Technologies and Architecture
• Alternative Solutions Considered
• Definition of Done
• Definition of Ready
• SSW Website - Power Automate flows

Architecture Overview

Requirements

• Git, Node.js Active LTS, Yarn installed for local development.
• A TinaCMS account for live editing.

Get Started

Install the project's dependencies:

yarn install

Run the project locally:

yarn dev

Build the project:

yarn build

Get Started with Dev Container

How to

1. Open Command Palette in VSCode

> Dev Containers: Reopen in Container

2. Develop as you would normally

Don't want to use Dev Container any more?

1. Close VSCode connected with the Dev Container
2. Open project folder on host machine
3. Remove node_modules and reinstall dependencies

yarn install

Updating the project's dependencies

yarn upgrade-interactive

Test locally to make sure everything still works.

To keep the yarn.lock file up to date, ensure syncyarnlock is installed globally:

yarn global add syncyarnlock

Then run:

syncyarnlock -s -k

Local URLs

• http://localhost:3000 : browse the website
• http://localhost:3000/admin : connect to Tina Cloud and go in edit mode
• http://localhost:3000/exit-admin : log out of Tina Cloud
• http://localhost:4001/altair/ : GraphQL playground to test queries and browse the API documentation

UI Testing on local

• 1 Make sure you have CREATE_LEAD_ENDPOINT environment variable in your .env - Follow steps to setup

• 2 Run yarn playwright test --ui in your terminal and make sure your local instance is running in the background.

Pull Requests

Each Pull Request will be deployed to its own staging environment, the URL to the environment is available in the PR thread.

Getting Help

• Email SSW to schedule a call.

• Reach out through the chat widget on ssw.com.au

• Visit the documentation to learn about Tina.

• Join the Tina Discord to share feedback for Tina to improve.