shopdb-flask/.claude/skills/deploy-frontend.md at bd48814021ff2fcd4e9d78d93f37dcd03e1b3eec

Files

Proudlock bd48814021 Reorganize repository structure and clean up documentation

Clean up and organize the flask-shopdb repository for better
maintainability and discoverability:

## Changes

- Update .gitignore for build artifacts (publish/, data/, 122M total)
- Reorganize .claude/ into 6 subdirectories with README navigation
- Consolidate overlapping MCP setup guides into MCP-QUICK-START.md
- Move deployment docs from root to docs/deployment/
- Archive dated status reports to .claude/archived/
- Delete temporary files (logs, backups, empty reports, ~50K)

## New Structure

.claude/ organized into:
- setup/ - MCP, VM, Hyper-V, GitHub setup guides + scripts (17 files)
- plans/ - Feature plans and protocols (5 files)
- maintenance/ - Deployment checklists and reports (4 files)
- archived/ - Historical documentation (9 files)
- skills/ - Claude Code automation (5 files)
- workflows/ - Security audit workflow (1 file)

docs/deployment/ created with 6 deployment guides:
- LOCAL-DEV-SETUP.md, DOCKER-SETUP.md, DOCKER-PREBUILT-APPROACH.md
- PRODUCTION-READINESS.md, DEPLOY-TO-VM.md, README.md

Root directory cleaned to essential docs only:
- CLAUDE.md, README.md, CONTRIBUTING.md, CHANGELOG.md

Benefits:
- Clear navigation via README.md in each subdirectory
- No duplicate/overlapping documentation
- Large artifacts properly gitignored (won't bloat repository)
- Historical context preserved in archived/

See .claude/CLEANUP-SUMMARY.md for complete details.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

2026-09-11 15:45:05 -04:00

1.9 KiB

Raw Blame History

name, description

name	description
deploy-frontend	Build frontend and deploy to prod server via Y drive

Build the Vue 3 frontend with production settings and copy to the Y drive for prod server deployment.

Steps

Navigate to frontend directory:

cd C:\Users\270015376\Documents\github\flask-shopdb\frontend

Run production build:
```
build-prod.cmd
```
This runs npm run build with VITE_BASE_PATH=/shopdb/ environment variable.
Verify build output:
```
ls -lh dist/
```
Should see index.html, assets/, and other bundled files.
Copy to Y drive (prod server):
```
update-prod-server.cmd
```
This copies frontend/dist/ to Y:/frontend/ (the SMB share that syncs to prod).
Restart IIS app pool on prod server:
- Connect to prod server
- Restart "ShopDB" application pool
- Or use remote command if configured

Files and Paths

Work PC (this machine):

Source: C:\Users\270015376\Documents\github\flask-shopdb\frontend
Build output: frontend/dist/

Y Drive (SMB share):

Target: Y:/frontend/
This is the staging area that syncs to prod

Prod Server:

Final location: /shopdb/ (served by IIS)
Access via: https://tsgwp00525.wjs.geaerospace.net/shopdb/

Important Notes

Frontend must be built on THIS PC (work PC has the right environment)
Build output goes to frontend/dist/
Y: drive is an SMB share mounted on this machine
After copy to Y:, restart the IIS app pool on prod server
Always test after deployment by loading the shopdb webpage

Common Issues

White screen: Frontend build path wrong, check VITE_BASE_PATH
Assets not loading: Check dist/ was fully copied to Y:
Stale cache: Hard refresh browser (Ctrl+F5)

Deployment Workflow

Make frontend changes
Commit to git
Run this skill to build and deploy
Restart IIS app pool
Test in browser

1.9 KiB Raw Blame History