Staging

.env.development

@@ -1,5 +1,13 @@
-DATABASE_URL=postgres://postgres:123456789@localhost:7501/postgres
-NEXT_PUBLIC_API_BASE_URL='http://localhost:5000'
+DATABASE_URL=postgres://postgres:123456789@localhost:7501/postgres # local docker db url
+
 BETTER_AUTH_SECRET=kOmFf8qlUgCYXyXvlpCHO2D0wOXgoYXC # this isn't the production one don't worry
-NODE_TLS_REJECT_UNAUTHORIZED=0
-BETTER_AUTH_URL='http://localhost:3001'
+
+# Base urls
+NEXT_PUBLIC_AUTH_BASE_URL='http://localhost:3001'
+NEXT_PUBLIC_API_BASE_URL='http://localhost:5000'
+NEXT_PUBLIC_DOCS_BASE_URL='http://localhost:3002'
+NEXT_PUBLIC_LANDING_BASE_URL='http://localhost:3000'
+NEXT_PUBLIC_LEARN_BASE_URL='http://localhost:3003'
+NEXT_PUBLIC_SCOUT_BASE_URL='http://localhost:3004'
+
+NODE_ENV='development'

.env.example

@@ -0,0 +1,18 @@
+# Server variables
+BETTER_AUTH_SECRET=zZcnOqQ6hR1nvYin80pOS0QQaTZ5fT6h # You can generate a new one at: https://www.better-auth.com/docs/installation
+DATABASE_URL=postgres://postgres:123456789@localhost:7501/postgres # This is the db url from pnpm run dev:setup (Docker required)
+GITHUB_CLIENT_ID= # Don't worry about these; if you want you can create a github app
+GITHUB_CLIENT_SECRET= # Just use magic link to test locally
+
+# Shared Variables
+
+# Base URLs (these are setup for local development, don't edit unless you know what you are doing)
+NEXT_PUBLIC_AUTH_BASE_URL='http://localhost:3001'
+NEXT_PUBLIC_API_BASE_URL='http://localhost:5000'
+NEXT_PUBLIC_DOCS_BASE_URL='http://localhost:3002'
+NEXT_PUBLIC_LANDING_BASE_URL='http://localhost:3000'
+NEXT_PUBLIC_LEARN_BASE_URL='http://localhost:3003'
+NEXT_PUBLIC_SCOUT_BASE_URL='http://localhost:3004'
+NEXT_PUBLIC_ATTENDANCE_BASE_URL='http://localhost:3005'
+
+NODE_ENV='development'

.github/workflows/deploy.yml

@@ -98,33 +98,45 @@ jobs:
       - name: Generate environment files
         run: |
           set -euo pipefail
-          for APP in auth landing learn scout nitro-api; do
+          for APP in auth landing learn scout nitro-api attendance; do
             mkdir -p "apps/$APP"
             {
-              echo "BETTER_AUTH_URL=${BETTER_AUTH_URL}"
-              echo "DATABASE_URL=${DATABASE_URL}"
-              echo "NEXT_PUBLIC_API_BASE_URL=${NEXT_PUBLIC_API_BASE_URL}"
-              echo "NEXT_PUBLIC_BASE_URL=${NEXT_PUBLIC_BASE_URL}"
+              echo "NODE_ENV=${NODE_ENV}"
               echo "BETTER_AUTH_SECRET=${BETTER_AUTH_SECRET}"
-              echo "NODE_TLS_REJECT_UNAUTHORIZED=0"
+              echo "DATABASE_URL=${DATABASE_URL}"
               echo "GITHUB_CLIENT_ID=${GITHUB_CLIENT_ID}"
               echo "GITHUB_CLIENT_SECRET=${GITHUB_CLIENT_SECRET}"
+              echo "NEXT_PUBLIC_AUTH_BASE_URL=${NEXT_PUBLIC_AUTH_BASE_URL}"
+              echo "NEXT_PUBLIC_API_BASE_URL=${NEXT_PUBLIC_API_BASE_URL}"
+              echo "NEXT_PUBLIC_DOCS_BASE_URL=${NEXT_PUBLIC_DOCS_BASE_URL}"
+              echo "NEXT_PUBLIC_LANDING_BASE_URL=${NEXT_PUBLIC_LANDING_BASE_URL}"
+              echo "NEXT_PUBLIC_LEARN_BASE_URL=${NEXT_PUBLIC_LEARN_BASE_URL}"
+              echo "NEXT_PUBLIC_SCOUT_BASE_URL=${NEXT_PUBLIC_SCOUT_BASE_URL}"
+              echo "NEXT_PUBLIC_ATTENDANCE_BASE_URL=${NEXT_PUBLIC_ATTENDANCE_BASE_URL}"
+              echo "CRON_SECURITY_KEY=${CRON_SECRET_KEY}"
+              echo "NODE_TLS_REJECT_UNAUTHORIZED=0"
             } > "apps/$APP/.env"
             cp "apps/$APP/.env" "apps/$APP/.env.production"
             echo "Created env files for $APP"
           done
         env:
-          BETTER_AUTH_URL: ${{ secrets.BETTER_AUTH_URL }}
-          DATABASE_URL: ${{ secrets.DATABASE_URL }}
-          NEXT_PUBLIC_API_BASE_URL: ${{ secrets.NEXT_PUBLIC_API_BASE_URL }}
-          NEXT_PUBLIC_BASE_URL: ${{ secrets.NEXT_PUBLIC_BASE_URL }}
+          NODE_ENV: ${{ github.ref == 'refs/heads/production' && 'production' || 'staging' }}
           BETTER_AUTH_SECRET: ${{ secrets.BETTER_AUTH_SECRET }}
+          DATABASE_URL: ${{ secrets.DATABASE_URL }}
           GITHUB_CLIENT_ID: ${{ secrets.GH_CLIENT_ID }}
           GITHUB_CLIENT_SECRET: ${{ secrets.GH_CLIENT_SECRET }}
+          NEXT_PUBLIC_AUTH_BASE_URL: ${{ secrets.NEXT_PUBLIC_AUTH_BASE_URL }}
+          NEXT_PUBLIC_API_BASE_URL: ${{ secrets.NEXT_PUBLIC_API_BASE_URL }}
+          NEXT_PUBLIC_DOCS_BASE_URL: ${{ secrets.NEXT_PUBLIC_DOCS_BASE_URL }}
+          NEXT_PUBLIC_LANDING_BASE_URL: ${{ secrets.NEXT_PUBLIC_LANDING_BASE_URL }}
+          NEXT_PUBLIC_LEARN_BASE_URL: ${{ secrets.NEXT_PUBLIC_LEARN_BASE_URL }}
+          NEXT_PUBLIC_SCOUT_BASE_URL: ${{ secrets.NEXT_PUBLIC_SCOUT_BASE_URL }}
+          NEXT_PUBLIC_ATTENDANCE_BASE_URL: ${{ secrets.NEXT_PUBLIC_ATTENDANCE_BASE_URL }}
+          CRON_SECRET_KEY: ${{ secrets.CRON_SECRET_KEY }}
 
       - name: Turbo prebuild all deployable apps
         run: |
-          pnpm turbo run build --filter=./apps/auth --filter=./apps/landing --filter=./apps/learn --filter=./apps/scout --filter=./apps/docs --filter=./apps/nitro-api
+          pnpm turbo run build --filter=./apps/auth --filter=./apps/landing --filter=./apps/learn --filter=./apps/scout --filter=./apps/docs --filter=./apps/nitro-api --filter=./apps/attendance
 
       - name: List built artifacts
         run: |
@@ -134,12 +146,13 @@ jobs:
           ls -1 apps/scout/.next || true
           ls -1 apps/docs/.next || true
           ls -1 apps/nitro-api/.output || true
+          ls -1 apps/attendance/.next || true
 
       - name: Package build artifacts
         run: |
           set -euo pipefail
             mkdir -p dist-artifacts
-          for APP in auth landing learn scout docs; do
+          for APP in auth landing learn scout docs attendance; do
             if [ -d "apps/$APP/.next" ]; then
               (cd apps/$APP && tar -czf "../../dist-artifacts/next-${APP}${ARTIFACT_SUFFIX}.tgz" .next $( [ -f .env ] && echo .env ) $( [ -f .env.production ] && echo .env.production ))
               echo "Packaged next-${APP}${ARTIFACT_SUFFIX}.tgz"
@@ -204,7 +217,15 @@ jobs:
           path: dist-artifacts/nitro-api${{ env.ARTIFACT_SUFFIX }}.tgz
           if-no-files-found: error
           retention-days: 3
-
+
+      - name: Upload artifact attendance
+        uses: actions/upload-artifact@v4
+        with:
+          name: next-attendance${{ env.ARTIFACT_SUFFIX }}
+          path: dist-artifacts/next-attendance${{ env.ARTIFACT_SUFFIX }}.tgz
+          if-no-files-found: error
+          retention-days: 3
+
   build-next:
     name: Build & push Next.js images (prebuilt)
     runs-on: ubuntu-latest
@@ -224,6 +245,8 @@ jobs:
             webhook_key: WEBHOOK_URL_SCOUT
           - app: docs
             webhook_key: WEBHOOK_URL_DOCS
+          - app: attendance
+            webhook_key: WEBHOOK_URL_ATTENDANCE
 
     steps:
       - name: Checkout

.github/workflows/pr.yml

@@ -6,23 +6,6 @@ on:
       - production
     paths-ignore: []
 
-jobs:
-  skip-if-staging-to-production:
-    if: github.event.pull_request.base.ref == 'production' && github.event.pull_request.head.ref == 'staging'
-    runs-on: ubuntu-latest
-    steps:
-      - run: echo "Skipping PR checks for staging -> production PR."
-    outputs:
-      skipped: true
-
-  lint:
-    if: github.event.pull_request.base.ref != 'production' || github.event.pull_request.head.ref != 'staging'
-
-# Prevent duplicate runs on same PR head
-concurrency:
-  group: pr-ci-${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
 permissions:
   contents: read
   packages: read
@@ -36,8 +19,21 @@ env:
   STAGING: true
   ARTIFACT_SUFFIX: -pr
 
+concurrency:
+  group: pr-ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
+  skip-if-staging-to-production:
+    if: github.event.pull_request.base.ref == 'production' && github.event.pull_request.head.ref == 'staging'
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "Skipping PR checks for staging -> production PR."
+    outputs:
+      skipped: true
+
   lint:
+    if: github.event.pull_request.base.ref != 'production' || github.event.pull_request.head.ref != 'staging'
     name: Lint
     runs-on: ubuntu-latest
     timeout-minutes: 15
@@ -53,7 +49,7 @@ jobs:
       - name: Install pnpm
         uses: pnpm/action-setup@v4
         with:
-            run_install: false
+          run_install: false
 
       - name: Get pnpm store directory
         id: pnpm-store
@@ -111,33 +107,45 @@ jobs:
       - name: Generate environment files
         run: |
           set -euo pipefail
-          for APP in auth landing learn scout nitro-api; do
+          for APP in auth landing learn scout nitro-api attendance; do
             mkdir -p "apps/$APP"
             {
-              echo "BETTER_AUTH_URL=${BETTER_AUTH_URL}"
-              echo "DATABASE_URL=${DATABASE_URL}"
-              echo "NEXT_PUBLIC_API_BASE_URL=${NEXT_PUBLIC_API_BASE_URL}"
-              echo "NEXT_PUBLIC_BASE_URL=${NEXT_PUBLIC_BASE_URL}"
+              echo "NODE_ENV=${NODE_ENV}"
               echo "BETTER_AUTH_SECRET=${BETTER_AUTH_SECRET}"
-              echo "NODE_TLS_REJECT_UNAUTHORIZED=0"
+              echo "DATABASE_URL=${DATABASE_URL}"
               echo "GITHUB_CLIENT_ID=${GITHUB_CLIENT_ID}"
               echo "GITHUB_CLIENT_SECRET=${GITHUB_CLIENT_SECRET}"
+              echo "NEXT_PUBLIC_AUTH_BASE_URL=${NEXT_PUBLIC_AUTH_BASE_URL}"
+              echo "NEXT_PUBLIC_API_BASE_URL=${NEXT_PUBLIC_API_BASE_URL}"
+              echo "NEXT_PUBLIC_DOCS_BASE_URL=${NEXT_PUBLIC_DOCS_BASE_URL}"
+              echo "NEXT_PUBLIC_LANDING_BASE_URL=${NEXT_PUBLIC_LANDING_BASE_URL}"
+              echo "NEXT_PUBLIC_LEARN_BASE_URL=${NEXT_PUBLIC_LEARN_BASE_URL}"
+              echo "NEXT_PUBLIC_SCOUT_BASE_URL=${NEXT_PUBLIC_SCOUT_BASE_URL}"
+              echo "NEXT_PUBLIC_ATTENDANCE_BASE_URL=${NEXT_PUBLIC_ATTENDANCE_BASE_URL}"
+              echo "CRON_SECURITY_KEY=${CRON_SECURITY_KEY}"
+              echo "NODE_TLS_REJECT_UNAUTHORIZED=0"
             } > "apps/$APP/.env"
             cp "apps/$APP/.env" "apps/$APP/.env.production"
             echo "Created env files for $APP"
           done
         env:
-          BETTER_AUTH_URL: ${{ secrets.BETTER_AUTH_URL }}
-          DATABASE_URL: ${{ secrets.DATABASE_URL }}
-          NEXT_PUBLIC_API_BASE_URL: ${{ secrets.NEXT_PUBLIC_API_BASE_URL }}
-          NEXT_PUBLIC_BASE_URL: ${{ secrets.NEXT_PUBLIC_BASE_URL }}
+          NODE_ENV: ${{ github.ref == 'refs/heads/production' && 'production' || 'staging' }}
           BETTER_AUTH_SECRET: ${{ secrets.BETTER_AUTH_SECRET }}
+          DATABASE_URL: ${{ secrets.DATABASE_URL }}
           GITHUB_CLIENT_ID: ${{ secrets.GH_CLIENT_ID }}
           GITHUB_CLIENT_SECRET: ${{ secrets.GH_CLIENT_SECRET }}
+          NEXT_PUBLIC_AUTH_BASE_URL: ${{ secrets.NEXT_PUBLIC_AUTH_BASE_URL }}
+          NEXT_PUBLIC_API_BASE_URL: ${{ secrets.NEXT_PUBLIC_API_BASE_URL }}
+          NEXT_PUBLIC_DOCS_BASE_URL: ${{ secrets.NEXT_PUBLIC_DOCS_BASE_URL }}
+          NEXT_PUBLIC_LANDING_BASE_URL: ${{ secrets.NEXT_PUBLIC_LANDING_BASE_URL }}
+          NEXT_PUBLIC_LEARN_BASE_URL: ${{ secrets.NEXT_PUBLIC_LEARN_BASE_URL }}
+          NEXT_PUBLIC_SCOUT_BASE_URL: ${{ secrets.NEXT_PUBLIC_SCOUT_BASE_URL }}
+          NEXT_PUBLIC_ATTENDANCE_BASE_URL: ${{ secrets.NEXT_PUBLIC_ATTENDANCE_BASE_URL }}
+          CRON_SECURITY_KEY: ${{ secrets.CRON_SECURITY_KEY }}
 
       - name: Turbo prebuild all deployable apps
         run: |
-          pnpm turbo run build --filter=./apps/auth --filter=./apps/landing --filter=./apps/learn --filter=./apps/scout --filter=./apps/docs --filter=./apps/nitro-api
+          pnpm turbo run build --filter=./apps/auth --filter=./apps/landing --filter=./apps/learn --filter=./apps/scout --filter=./apps/docs --filter=./apps/nitro-api --filter=./apps/attendance
 
       - name: List built artifacts
         run: |
@@ -147,12 +155,13 @@ jobs:
           ls -1 apps/scout/.next || true
           ls -1 apps/docs/.next || true
           ls -1 apps/nitro-api/.output || true
+          ls -1 apps/attendance/.next || true
 
       - name: Package build artifacts
         run: |
           set -euo pipefail
           mkdir -p dist-artifacts
-          for APP in auth landing learn scout docs; do
+          for APP in auth landing learn scout docs attendance; do
             if [ -d "apps/$APP/.next" ]; then
               (cd apps/$APP && tar -czf "../../dist-artifacts/next-${APP}${ARTIFACT_SUFFIX}.tgz" .next $( [ -f .env ] && echo .env ) $( [ -f .env.production ] && echo .env.production ))
               echo "Packaged next-${APP}${ARTIFACT_SUFFIX}.tgz"
@@ -218,6 +227,14 @@ jobs:
           if-no-files-found: error
           retention-days: 3
 
+      - name: Upload artifact attendance
+        uses: actions/upload-artifact@v4
+        with:
+          name: next-attendance${{ env.ARTIFACT_SUFFIX }}
+          path: dist-artifacts/next-attendance${{ env.ARTIFACT_SUFFIX }}.tgz
+          if-no-files-found: error
+          retention-days: 3
+
   build-next:
     if: github.event.pull_request.base.ref != 'production' || github.event.pull_request.head.ref != 'staging'
     name: Build Next.js images (prebuilt, no push)
@@ -232,6 +249,7 @@ jobs:
           - app: learn
           - app: scout
           - app: docs
+          - app: attendance
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -263,7 +281,7 @@ jobs:
       - name: Build image from prebuilt artifacts (no push)
         run: |
           IMAGE=ghcr.io/team293/${{ matrix.app }}
-            SHA_TAG=pr-${{ github.sha }}
+          SHA_TAG=pr-${{ github.sha }}
           echo "Building $IMAGE:$SHA_TAG (no push)"
           docker build \
             --build-arg APP=${{ matrix.app }} \
@@ -323,7 +341,6 @@ jobs:
     name: Summary
     runs-on: ubuntu-latest
     needs: [build-next, build-nitro]
-    if: always()
     steps:
       - name: Report
         run: |

README.md

@@ -59,10 +59,4 @@ pnpm dev
 ```
 
 ## Contributing
-We welcome contributions! Please follow these steps:
-
-1. Fork the repository.
-2. Create a new branch for your feature or bug
-3. Make your changes and commit them with clear messages.
-4. Push your changes to your fork.
-5. Create a pull request against the `staging` branch of the original repository.
+Please read our [contributing guidelines](CONTRIBUTING.md) before submitting a pull request.

apps/attendance/.gitignore

@@ -0,0 +1,46 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+.yarn/install-state.gz
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+# OpenNext
+/.open-next
+
+# wrangler files
+.wrangler
+.dev.vars*
+!.dev.vars.example
+.env*
+!.env.example