Feature/manual deploy (#62)

* feat(github): enable manual deployment from Actions tab

* chore(github): remove redundant pnpm setup step in deploy workflow

* chore(github): update deploy workflow to remove auto-deploy on push

* chore(config): add base path for assets and update deployment workflows

- Added `NEXT_PUBLIC_BASE_PATH` to `next.config.js` for serving assets from a subpath.
- Updated GitHub Actions workflows to retrieve and set the application version from `package.json`.
- Modified asset paths in `AppSidebar` and `MobileTopBar` components to use the new base path.

These changes enhance the flexibility of asset management and ensure version consistency during deployments.

---------

Co-authored-by: DrakeNguyen <drake.ha.nguyen@gmail.com>

Author: drakehanguyen

.github/workflows/deploy-pages.yml

@@ -37,6 +37,10 @@ jobs:
           node-version: '20'
           cache: 'pnpm'
 
+      - name: Get version from package.json
+        id: version
+        run: echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
+
       - name: Set base URL for GitHub Pages
         id: base_url
         run: |
@@ -61,6 +65,7 @@ jobs:
         env:
           NEXT_PUBLIC_BASE_URL: ${{ steps.base_url.outputs.base_url }}
           BASE_PATH: ${{ steps.base_url.outputs.base_path }}
+          NEXT_PUBLIC_APP_VERSION: ${{ steps.version.outputs.version }}
 
       - name: Upload Pages artifact
         uses: actions/upload-pages-artifact@v3

.github/workflows/release.yml

@@ -185,33 +185,36 @@ jobs:
         id: deployment
         uses: actions/deploy-pages@v4
 
-      - name: Verify package.json version matches tag
+      - name: Sync package.json version to tag
         if: success()
-        continue-on-error: true
         run: |
           VERSION="${{ steps.tag_version.outputs.version }}"
-          TAG_NAME="${{ steps.tag_version.outputs.tag_name }}"
-
-          # Check version in package.json from the tag
           CURRENT_VERSION=$(node -p "require('./package.json').version")
 
           if [ "$CURRENT_VERSION" = "$VERSION" ]; then
-            echo "✅ package.json version ($CURRENT_VERSION) matches release tag ($TAG_NAME)"
-            echo "✅ Version sync verified - following Approach 1 (Update Before Tagging)"
-          else
-            echo "⚠️  WARNING: package.json version ($CURRENT_VERSION) does not match release tag ($TAG_NAME)"
-            echo ""
-            echo "📋 Recommended workflow (Approach 1):"
-            echo "   1. Update package.json version to $VERSION"
-            echo "   2. Commit and push (via PR if branch is protected)"
-            echo "   3. Then create the release tag"
-            echo ""
-            echo "💡 For this release, the tag was created but package.json is out of sync."
-            echo "   Please manually update package.json to $VERSION to keep them in sync."
-            echo ""
-            echo "⚠️  This is a warning only - the release will continue."
+            echo "✅ package.json version ($CURRENT_VERSION) already matches tag"
+            exit 0
           fi
 
+          echo "📝 Updating package.json from $CURRENT_VERSION to $VERSION"
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          # Checkout default branch (tag push leaves us in detached HEAD)
+          git fetch origin ${{ github.event.repository.default_branch }}
+          git checkout ${{ github.event.repository.default_branch }}
+
+          # Update package.json
+          node -e "
+            const pkg = require('./package.json');
+            pkg.version = '$VERSION';
+            require('fs').writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\n');
+          "
+
+          git add package.json
+          git commit -m "chore: bump version to $VERSION"
+          git push origin ${{ github.event.repository.default_branch }}
+
       - name: Upload build artifacts
         if: success()
         uses: actions/upload-artifact@v4

next.config.js

@@ -17,6 +17,8 @@ const nextConfig = {
     NEXT_PUBLIC_APP_VERSION: process.env.NEXT_PUBLIC_APP_VERSION || 'dev',
     // Base URL for metadata, sitemap, canonical URLs. Required for self-hosting.
     NEXT_PUBLIC_BASE_URL: process.env.NEXT_PUBLIC_BASE_URL || 'https://devpockit.hypkey.com',
+    // Base path for assets when serving from subpath (e.g. /devpockit). Used for logo, etc.
+    NEXT_PUBLIC_BASE_PATH: process.env.BASE_PATH || '',
   },
   // HTTPS is handled via the dev:https script in package.json
 }

src/components/AppSidebar.tsx

@@ -188,7 +188,7 @@ export function AppSidebar({
                   <PanelLeft className="h-4 w-4 text-sidebar-foreground" />
                 ) : (
                   <Image
-                    src="/assets/devpockit-logo.svg"
+                    src={`${process.env.NEXT_PUBLIC_BASE_PATH || ''}/assets/devpockit-logo.svg`}
                     alt="DevPockit Logo"
                     width={32}
                     height={32}

src/components/layout/MobileTopBar.tsx

@@ -53,7 +53,7 @@ export function MobileTopBar({ onToolSelect, onHomeClick }: MobileTopBarProps) {
         aria-label="Go to homepage"
       >
         <Image
-          src="/assets/devpockit-logo.svg"
+          src={`${process.env.NEXT_PUBLIC_BASE_PATH || ''}/assets/devpockit-logo.svg`}
           alt="DevPockit Logo"
           width={32}
           height={32}