SpeedCart Beta

.github/workflows/backend.yml

@@ -0,0 +1,52 @@
+name: Backend Deployment
+
+on:
+  # Allows manual deployment
+  workflow_dispatch:
+  push:
+    # Triggers only when code is pushed to the development branch
+    # that modifies files in the API directory
+    branches:
+      - deployment  # production
+      - development # development
+
+    paths:
+      - 'API/**'
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v2
+
+    - name: Login to Docker Hub
+      uses: docker/login-action@v2
+      with:
+        username: ${{ secrets.DOCKER_HUB_USERNAME }}
+        password: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}
+
+    - name: Build and push Docker image
+      uses: docker/build-push-action@v4
+      with:
+        context: ./API
+        file: ./API/docker/production/Dockerfile
+        push: true
+        # If the branch is deployment, tag the image with prod (otherwise, tag it with dev)
+        tags: |
+          ${{ secrets.IMAGE_NAME }}:${{ github.ref == 'refs/heads/deployment' && 'prod' || 'dev' }}
+
+  trigger-do-deployment:
+    needs: build-and-push
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger DigitalOcean App Platform redeploy
+        # We have two apps, one for prod and one for dev
+        run: |
+          APP_ID=${{ github.ref == 'refs/heads/deployment' && secrets.DO_APP_ID_PROD || secrets.DO_APP_ID_DEV }}
+          curl -X POST "https://api.digitalocean.com/v2/apps/$APP_ID/deployments" \
+          -H "Authorization: Bearer ${{ secrets.DO_API_TOKEN }}"

.github/workflows/backend_test.yml

@@ -0,0 +1,48 @@
+name: Run Laravel API Feature Tests
+
+on:
+  pull_request:
+    branches:
+      - development
+    paths:
+      - 'API/**'
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.2' # the PHP version this project requires
+          extensions: mbstring, pdo_sqlite
+          ini-values: |
+            memory_limit=-1
+          coverage: none
+
+      - name: Install dependencies
+        run: |
+          cd API
+          composer install --prefer-dist --no-interaction
+          cp .env.test .env
+
+      - name: Configure environment for SQLite in-memory database
+        run: |
+          cd API
+          echo "DB_CONNECTION=sqlite" >> .env
+          echo "DB_DATABASE=:memory:" >> .env
+          php artisan key:generate
+
+      - name: Run migrations
+        run: |
+          cd API
+          php artisan migrate --force
+
+      - name: Run tests
+        run: |
+          cd API
+          php artisan test --testsuite=Feature

.github/workflows/frontend.yml

@@ -0,0 +1,44 @@
+name: Frontend Deployment
+
+on:
+  # Allows manual deployment
+  workflow_dispatch:
+  push:
+    # Triggers only when code is pushed to the development branch
+    # that modifies files in the Frontend or docs/legal directories
+    branches:
+      - development
+
+    paths:
+      - 'Frontend/**'
+      - 'docs/legal/**'
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v2
+
+    - name: Set up Node.js
+      uses: actions/setup-node@v2
+      with:
+        node-version: '21.6.0'
+
+    - name: Install dependencies
+      run: cd Frontend && npm install --force # This should install all dependencies, regardless of the workspace
+
+    - name: Build front end
+      env:
+        CI: false
+      run: cd Frontend && npm run build # This makes sure the build succeeds before running it on the production server
+
+    - name: Deploy to Cloudflare Pages
+      uses: cloudflare/pages-action@v1
+      with:
+        apiToken: ${{ secrets.CF_PAGES_API_TOKEN }}
+        accountId: ${{ secrets.CF_ACCOUNT_ID }}
+        projectName: "speedcart"
+        directory: "Frontend/speedcart-react/build"
+        branch: "development"

.gitignore

@@ -1,4 +1,7 @@
 *.db
 *.log
 node_modules/
-src/test.php
+src/test.php
+*.phpunit.result.cache
+shopfast-react/build/api/*
+vendor/*

API/.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[docker-compose.yml]
+indent_size = 4

API/.env.test

@@ -0,0 +1,65 @@
+APP_NAME=Laravel
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_TIMEZONE=UTC
+APP_URL=http://localhost
+FRONTEND_BASE_URL=www.speedcartapp.com
+
+APP_LOCALE=en
+APP_FALLBACK_LOCALE=en
+APP_FAKER_LOCALE=en_US
+
+APP_MAINTENANCE_DRIVER=file
+APP_MAINTENANCE_STORE=database
+
+BCRYPT_ROUNDS=12
+
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+# DB_CONNECTION=sqlite
+# DB_HOST=127.0.0.1
+# DB_PORT=3306
+# DB_DATABASE=laravel
+# DB_USERNAME=root
+# DB_PASSWORD=
+
+SESSION_DRIVER=database
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+BROADCAST_CONNECTION=log
+FILESYSTEM_DISK=local
+QUEUE_CONNECTION=database
+
+CACHE_STORE=database
+CACHE_PREFIX=
+
+MEMCACHED_HOST=127.0.0.1
+
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+MAIL_MAILER=log
+MAIL_HOST=127.0.0.1
+MAIL_PORT=2525
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_ENCRYPTION=null
+MAIL_FROM_ADDRESS="hello@example.com"
+MAIL_FROM_NAME="${APP_NAME}"
+
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+VITE_APP_NAME="${APP_NAME}"

API/.gitattributes

@@ -0,0 +1,11 @@
+* text=auto eol=lf
+
+*.blade.php diff=html
+*.css diff=css
+*.html diff=html
+*.md diff=markdown
+*.php diff=php
+
+/.github export-ignore
+CHANGELOG.md export-ignore
+.styleci.yml export-ignore

API/.gitignore

@@ -0,0 +1,19 @@
+/.phpunit.cache
+/node_modules
+/public/build
+/public/hot
+/public/storage
+/storage/*.key
+/vendor
+.env
+.env.backup
+.env.production
+.phpunit.result.cache
+Homestead.json
+Homestead.yaml
+auth.json
+npm-debug.log
+yarn-error.log
+/.fleet
+/.idea
+/.vscode

API/README.md

@@ -0,0 +1,88 @@
+## Development Setup on Windows with WSL2 for Blazing Fast Laravel Docker Performance
+
+### Why This Setup?
+
+By default, mounting your Laravel project from the Windows filesystem (`C:\...`) into Docker containers on Windows causes **extremely slow file I/O**, leading to very long request times (up to several seconds per request). This is due to the way Windows handles filesystem mounts and is a common pain point.
+
+To fix this, we move the project files into the **native Linux filesystem inside WSL2** and run Docker from there, resulting in massive performance improvements (down to milliseconds per request).
+
+---
+
+### Step-by-step Setup Instructions
+
+### VSCode extension install
+For simplicity, you should develop with VSCode with the WSL extension installed
+so you can easily develop this Laravel app after getting the Ubuntu WSL setup steps done
+as part of step 1. This extension will come in handy by step 2.
+This is the WSL extension: https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl
+
+#### 1. Start your WSL2 Ubuntu distro
+
+Open PowerShell or Windows Terminal and run:
+
+```bash
+wsl -d Ubuntu
+```
+
+### 2. Create a projects folder and copy the repo into WSL
+
+Inside the WSL terminal:
+
+```bash
+mkdir -p ~/projects
+cp -r yourmounteddirectory/API ~/projects/SpeedCart
+cd ~/projects/SpeedCart/API
+```
+Replace `yourmounteddirectory` with the directory that WSL goes to in vscode after you finish the startup
+from step 1. You can see that you only need to copy the API folder into the container because this is just
+for the Laravel app.
+(should look something like `/mnt/c/Users/Admin/Desktop/Repos/SpeedCart` or similar depending on where
+you store this repo)
+
+### 3. Open the project in VSCode with WSL integration
+
+Run:
+```bash
+code .
+```
+This will open the project in VSCode connected directly to WSL.
+
+### 4. Enable Docker integration for your Ubuntu WSL distro
+Open Docker Desktop on Windows.
+
+Go to Settings > Resources > WSL Integration.
+
+Enable the toggle for your Ubuntu distro.
+
+Click Apply & Restart if prompted.
+
+### 5. Verify Docker inside WSL
+Back in your Ubuntu terminal, test Docker:
+
+```bash
+docker --version
+docker compose version
+```
+You should see version info confirming Docker works inside WSL.
+
+### 6. Run your Laravel containers
+Inside the WSL terminal in your project folder:
+
+```bash
+cd docker/development
+docker compose up -d --build
+```
+
+While still in the WSL terminal, be sure to run migrations to build the database tables:
+```bash
+docker exec -it laravel_dev sh
+php artisan migrate
+```
+
+Enjoy lightning-fast performance thanks to native Linux filesystem speeds inside WSL.
+
+## Git workflow
+Since your code lives inside WSL's Linux filesystem, you can use Git as usual inside WSL:
+
+## Optional: Running Composer & Node inside WSL
+For best performance, install Composer and Node directly in your WSL Ubuntu environment to run commands like composer install and npm install super fast without Windows filesystem overhead.