feat: #13 convert project to be SSG based

.github/ISSUE_TEMPLATE.md

@@ -1,15 +1,18 @@
 ## Type of Change
+
 - [ ] New Feature Request
 - [ ] Improvement / Suggestion
 - [ ] Bug
 - [ ] Other (please clarify below)
 
 ## Summary
+
 <!-- Brief summary of the issue. -->
 
 ## Details
-<!-- 
+
+<!--
 Include relevant code samples, example snippets, benefits, complexity, etc.
 
 For bug reports, please include your configuration file and a sample of your workspace with the minimum amount of code needed to reproduce.  For alternative debugging approaches, you can use our test cases as a format to follow for reproducing bugs.
--->
+-->

.github/PULL_REQUEST_TEMPLATE.md

@@ -4,12 +4,14 @@ We love contributions and appreciate any help you can offer!
 -->
 
 ## Related Issue
+
 <!-- Include a link to the issue (e.g. Resolves #12) -->
 
 ## Summary of Changes
+
 <!-- Briefly summarize the changes made, lists are appreciated, ideally with checklists
 
 1. [x] Thing I fixed
 1. [x] Other thing I updated
 1. [x] Docs I updated
--->
+-->

.github/workflows/ci.yml

@@ -3,32 +3,32 @@ name: Continuous Integration
 on: [pull_request]
 
 jobs:
-
   build:
     runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        node: [22]
-
     steps:
-    - uses: actions/checkout@v4
-    - name: Use Node.js ${{ matrix.node }}
-      uses: actions/setup-node@v4
-      with:
-        node-version: ${{ matrix.node }}
-    - name: Installing project dependencies
-      run: |
-        npm ci
-    - name: Lint
-      run: |
-        npm run lint
-    - name: Test
-      run: |
-        npm run test
-    - name: Build
-      run: |
-        npm run build
-    # - name: Storybook
-    #   run: |
-    #     npm run storybook:build
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+      - name: Installing project dependencies
+        run: |
+          npm ci
+      - name: Lint
+        run: |
+          npm run lint
+      - name: Format Check
+        run: |
+          npm run format:check
+      # TODO: add typechecking
+      # TODO: restore testing
+      # - name: Test
+      #   run: |
+      #     npm run test
+      - name: Build
+        run: |
+          npm run build
+      # TODO: restore storybook
+      # - name: Storybook
+      #   run: |
+      #     npm run storybook:build

.github/workflows/preview.yml

@@ -0,0 +1,31 @@
+name: Deploy Preview
+
+on: [pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    environment: "preview"
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: aws-actions/configure-aws-credentials@v6
+        with:
+          aws-region: ${{ secrets.AWS_REGION }}
+          role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+      - name: Installing project dependencies
+        run: |
+          npm ci
+      - name: Build
+        run: |
+          npm run build
+      - name: Deploy to Preview Environment
+        env:
+          API_BACKEND_HOSTNAME: ${{ secrets.API_BACKEND_HOSTNAME }}
+        run: |
+          npm run deploy:preview

.github/workflows/production.yml

@@ -0,0 +1,34 @@
+name: Deploy Production
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    environment: "production"
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: aws-actions/configure-aws-credentials@v6
+        with:
+          aws-region: ${{ secrets.AWS_REGION }}
+          role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+      - name: Installing project dependencies
+        run: |
+          npm ci
+      - name: Build
+        run: |
+          npm run build
+      - name: Deploy to Production Environment
+        env:
+          API_BACKEND_HOSTNAME: ${{ secrets.API_BACKEND_HOSTNAME }}
+        run: |
+          npm run deploy:prod

.gitignore

@@ -1,6 +1,10 @@
+.env
 *.log
+.aws-output/
 .greenwood/
+.sst/
 .vscode/
+sst-env.d.ts
 node_modules/
 public/
 reports/

.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

.ls-lint.yml

@@ -11,7 +11,10 @@ ls:
   .woff: lowercase
   .woff2: lowercase
 
-ignore: 
-  - .git 
+ignore:
+  - .git
+  - .aws-output
+  - .greenwood
+  - .sst
   - node_modules
-  - public
+  - public

.nvmrc

@@ -1 +1 @@
-22.18.0
+24.4.0

.prettierignore

@@ -0,0 +1,2 @@
+.sst/
+patches/

.prettierrc

@@ -0,0 +1,3 @@
+{
+  "printWidth": 100
+}

README.md

@@ -7,34 +7,31 @@
 
 ## Overview
 
-Frontend website for [www.analogstudios.net](https://www.analogstudios.net) based on [Greenwood](https://www.greenwoodjs.io). It is built and deployed using Github Actions to AWS using S3 and Cloudfront.  (The backend uses and API Gateway and EC2)
+Frontend website for [www.analogstudiosri.net](https://www.analogstudios.net) based on [Greenwood](https://www.greenwoodjs.io). It is built and deployed using Github Actions to AWS (S3 / Cloudfront / Lambda) using SST. The [backend](https://github.com/AnalogStudiosRI/api) uses and AWS (API Gateway / Lambda) with [Architect](https://arc.codes/).
 
 ## Contributing
 
 ### Setup
 
-You'll need the latest [NodeJS LTS](https://nodejs.org/) version installed to run and contribute to this project.  Or run `nvm use` if using [nvm**](https://github.com/nvm-sh/nvm).
+You'll need the latest [NodeJS LTS](https://nodejs.org/) version installed to run and contribute to this project. Or run `nvm use` if using [nvm](https://github.com/nvm-sh/nvm).
 
-You can confirm by running the following
+You can confirm by running the following:
 
 ```sh
 $ node -v
-v18.15.0
-
-% npm -v
-8.19.2
+24.4.0
 ```
 
 Then run `npm ci` to install the project's dependencies.
 
 ### Tasks
 
-After installing the above, you can run the following commands:
+After installing the above, you can run the following key development commands:
 
-- `npm run lint` - Lint all files in the project (JS , CSS, naming)
-- `npm run start` - Starts **Greenwood**'s local development server
-- `npm run build` - Runs **Greenwood** to generate a production build
+- `npm run dev` - Starts **Greenwood**'s local development server
 - `npm run story:dev` - Runs [**Storybook**](https://storybook.js.org/) in development mode
 - `npm run test:tdd` - Runs unit tests in `watch` mode using [**@web/test-runner**](https://modern-web.dev/docs/test-runner/overview/)
+- `npm run lint` - Lint all files in the project (TS / JS , CSS)
+- `npm run format` - Format all files
 
 > _See `package.json#scripts` for a full list of available commands._