Skip to content

Fix PWA white screen: correct manifest.json path typo#169

Merged
statikfintechllc merged 4 commits intomasterfrom
copilot/fix-pwa-white-screen-issue
Nov 18, 2025
Merged

Fix PWA white screen: correct manifest.json path typo#169
statikfintechllc merged 4 commits intomasterfrom
copilot/fix-pwa-white-screen-issue

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Nov 18, 2025

Pull Request Template

Overview

PWA displayed white screen when installed to homescreen due to manifest validation error.

  • Bugfix
  • Feature
  • Code Refactor
  • Documentation Update
  • Broker Integration Enhancement
  • Analytics/Metrics Enhancement
  • UI/UX Improvement
  • Performance Optimization
  • Trading Strategy/Framework Update
  • Automation/Workflow Improvement
  • Other (describe below)

Description

Manifest contained incorrect base path /Personal-Pennies/ in Analytics shortcut (line 64), causing PWA installation failure. Fixed to /SFTi-Pennies/ to match repository path.

Investigation of working Personal-Pennies repo confirmed simple relative path approach is sufficient—service worker and base tags unnecessary for GitHub Pages PWA.

// manifest.json line 64
{
  "name": "Analytics",
  "short_name": "Analytics",
  "description": "View trading analytics and performance metrics",
- "url": "/Personal-Pennies/index.directory/analytics.html",
+ "url": "/SFTi-Pennies/index.directory/analytics.html",
  ...
}

Related Issues

Closes #[issue-number]

Changes Made

  • Configuration changes
  • Frontend changes (HTML/CSS/Vanilla JavaScript)
  • Python automation scripts
  • GitHub Actions workflows
  • Trading templates (trade.md, weekly-summary.md)
  • Analytics/chart generation
  • CSV import/export functionality
  • Broker integration (IBKR/Schwab/Robinhood/Webull)
  • Documentation updates

Testing Checklist

  • JavaScript builds successfully (npm run build)
  • Python scripts run without errors
  • Local development server works (python -m http.server 8000)
  • Application loads at http://localhost:8000/
  • GitHub Pages deployment tested (if applicable)
  • Core functionality tested manually in browser
  • Trade submission and processing verified
  • Analytics calculations verified (if applicable)
  • CSV import/export tested (if applicable)
  • Mobile responsive design verified
  • PWA installation tested (if applicable)

Screenshots / Evidence

Testing post-merge required: install PWA to homescreen, verify shortcuts work.

Broker Integration Impact

  • No broker integration changes
  • Enhanced broker CSV import
  • New broker support added
  • Broker parsing improvements
  • Multi-broker compatibility maintained

Analytics Impact

  • No analytics changes
  • New metrics added
  • Chart visualization improvements
  • Calculation accuracy improvements
  • Performance metrics updates

Breaking Changes

  • No breaking changes
  • Breaking changes (describe below)

Additional Notes

Removed during implementation:

  • Service worker (sw.js) - not required for PWA functionality
  • Base tag experiments - relative paths sufficient per working Personal-Pennies setup

Security: CodeQL scan passed, no vulnerabilities introduced.


Reviewer Checklist:

  • Code follows project standards
    • Python code follows PEP 8 guidelines
    • JavaScript follows vanilla JS best practices
  • Changes are well-documented
  • No sensitive data exposed (PATs, account numbers, API keys)
  • Trade data integrity maintained
  • Analytics calculations are mathematically correct
  • UI changes are responsive and accessible
  • Mobile PWA functionality preserved
  • GitHub Actions workflows validated
Original prompt

This section details on the original issue you should resolve

<issue_title>[BUG] PWA system has a Pitfall</issue_title>
<issue_description>## 🐛 Summary

When adding the Github Pages hosted PWA to homescreen, it adds the logo properly yet the actual pwa just opens a white screen, yet in browser it shows the full pwa, what is wrong with the pathing in the PWA system? Please find and patch</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI and others added 2 commits November 18, 2025 19:59
- Fix manifest.json typo: /Personal-Pennies/ -> /SFTi-Pennies/
- Use absolute paths for manifest and icons in index.html
- Add service worker for PWA caching and offline support
- Register service worker in index.html

Co-authored-by: statikfintechllc <200911899+statikfintechllc@users.noreply.github.com>
- Convert relative manifest paths to absolute in 10 HTML files
- Ensures consistent path resolution across all pages
- Improves PWA reliability when navigating between pages

Co-authored-by: statikfintechllc <200911899+statikfintechllc@users.noreply.github.com>
Based on working Personal-Pennies repo:
- Remove service worker (not needed for PWA to function)
- Remove base tag from index.html
- Keep simple relative paths throughout
- Only fix is the manifest.json typo: /Personal-Pennies/ -> /SFTi-Pennies/

Co-authored-by: statikfintechllc <200911899+statikfintechllc@users.noreply.github.com>
@statikfintechllc statikfintechllc marked this pull request as ready for review November 18, 2025 20:09
Copilot AI review requested due to automatic review settings November 18, 2025 20:09
Copilot AI changed the title [WIP] Fix white screen issue in PWA system Fix PWA white screen: correct manifest.json path typo Nov 18, 2025
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR fixes a critical PWA white screen issue caused by a single typo in the manifest.json file. The Analytics shortcut was pointing to the wrong repository path (/Personal-Pennies/ instead of /SFTi-Pennies/), which prevented the PWA from loading correctly when installed to the home screen.

  • Corrected the Analytics shortcut URL in manifest.json from /Personal-Pennies/ to /SFTi-Pennies/

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@statikfintechllc statikfintechllc merged commit 04ab179 into master Nov 18, 2025
12 checks passed
@statikfintechllc statikfintechllc deleted the copilot/fix-pwa-white-screen-issue branch November 18, 2025 20:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG] PWA system has a Pitfall

3 participants