Skip to content
This repository was archived by the owner on Apr 9, 2026. It is now read-only.

Commit d12d728

Browse files
authored
Updaing old notes to new layout (#94)
* Refactor patch list HTML structure Rework the patch changelist HTML for many unit entries: move ChangeTypeBadge next to unit name, replace UnitMeta with FactionRow and place UnitCode inside it. Replace inline "old → new" spans with a semantic structure using ChangeLabel and ChangeValue (with <s class="OldValue">, an arrow icon and <strong class="NewValue">) to standardize markup for buffs/nerfs/mixed changes and improve styling/accessibility across the page. * Refactor page structure and add patch cards Fix markup and reorganize content: replace .Content div with a section, correct mismatched section/div tags and heading placements, and remove stray blank lines. Rename several IDs to remove double underscores (e.g. T2_Cybran__Shield_Lvl1 -> T2_Cybran_Shield_Lvl1). Convert many legacy .Card blocks into standardized article.PatchCard elements with structured PatchCardContent, ChangeGroup lists, faction badges and change values for multiple units (T3 UEF Shield, Nuke Silo, T3/T4 static artillery across factions, Eye of Rhianne, Game Enders, ACU Regen Aura, etc.). Overall improves semantic HTML and standardizes the patch-change presentation. * Update README and expand 2019/3704 patch page Revamp README to v2.3.1 with full PWA project overview, features, tech stack and project structure. Restructure pages/2019/3704.html: adjust semantic containers (Content -> div), standardize section ids (Land/Air/Navy/Structures/ACUs), rename several faction badge classes (seraphim -> sera), update image alts/unit names, and add many new patch cards (e.g. T2_TML, Advanced Regen Aura, Personal Shield, Chrono Dampener) with detailed change groups. Also introduce an aside Quick Navigation/ContentNav for improved in-page navigation and reorganize ACU/enhancement content into proper sections. These changes improve content completeness, readability and navigation for the patch notes page. * updating page to new layout * Update 3696.html to new layout format * Fix patch 3696: modernize sidebar, correct buff/nerf labels, and fix descriptions - Updated sidebar structure to match 3829 template with modern ContentNav - Added 50 navigation items across 6 sections (Land, Air, Navy, Structures, ACU) - Fixed 30+ unit descriptions from placeholder text - Corrected 20 article-level buff/nerf badges based on actual stat changes - Fixed 49 individual change item labels (buff/nerf) to match stat direction - Updated 3 image paths to match article content (Shard, Czar, T3 Land HQ) - Fixed HTML structure: moved closing body tag, added missing ChangesList wrappers - Fixed unclosed strikethrough tag (line 976) - Verified all HTML tags are balanced (191 opening/closing pairs) * Update patch 3688: Convert sidebar to ContentSidemenu layout and correct unit IDs * Update patches 3674, 3676, 3684: Upgrade head sections, convert sidebars to ContentSidemenu, and modernize intro sections * Modernize patch 3684: Fix layout, badges, and stat classifications - Update sidebar structure to match 3830 template (modern NavSection/NavItem) - Fix duplicate ID: sera_aoe_enhc → aeon_shield_enhc - Fix broken image paths: T4Mega.pngb → T4Mega.png, aeon//shield.png - Add missing T1 UEF Bomber to sidebar - Correct unit-level badges: MMLs, Sparky, Static Flak, T3 Naval factories - Update unit descriptions for accuracy - Fix all factory health/regen increase labels from nerf→buff (17 instances) - Verify all 50 individual stat change labels for correctness - Update counts: air units 2→3, total changes 24→25 * removed legacy changes not relevant any longer
1 parent 728f5da commit d12d728

8 files changed

Lines changed: 7273 additions & 2383 deletions

File tree

README.md

Lines changed: 137 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,140 @@
11
# FAF Patchnotes
22

3-
A modern Progressive Web App providing comprehensive access to all current and previous patch notes## 🤝 Contributing
3+
> **Version 2.3.1** - A modern Progressive Web App providing comprehensive access to all current and previous patch notes for *Supreme Commander: Forged Alliance Forever* (FAF), featuring advanced search capabilities, offline functionality, and a beautiful frosted glass interface.
4+
5+
---
6+
7+
## Overview
8+
9+
**Patchnotes Faforever** is a professional PWA platform that serves as a centralized, feature-rich hub for players to stay informed about the latest game updates, balance changes, and development progress for FAF. Whether you're a long-time player or just starting, you'll find organized, searchable patch information with a premium user experience across all devices.
10+
11+
## ✨ Features
12+
13+
### 🔍 **Advanced Search & Filtering**
14+
- Real-time search through all patch notes with instant results
15+
- Year-based filtering for quick navigation through patch history
16+
- Live search statistics and result counts
17+
- Keyboard shortcuts for power users (press `Ctrl/Cmd + K` for search, `?` for help)
18+
19+
### 📱 **Progressive Web App (PWA)**
20+
- Install as a native app on any device (mobile, tablet, desktop)
21+
- Full offline functionality - browse patches without internet
22+
- Background updates with smart caching
23+
- Push notification support (future feature)
24+
25+
### 🎨 **Modern UI/UX**
26+
- Beautiful frosted glass design with dynamic backgrounds
27+
- Dark/Light theme toggle with system preference detection
28+
- Responsive design optimized for all screen sizes
29+
- Smooth animations and professional polish
30+
31+
### **Accessibility & Performance**
32+
- **WCAG 2.1 AAA compliant** - Full accessibility for users with disabilities
33+
- **Skip links** for keyboard navigation
34+
- **Screen reader support** with comprehensive ARIA labels
35+
- **Keyboard shortcuts** for all functionality (press `?` for help)
36+
- **High contrast focus indicators** for visibility
37+
- **Reduced motion support** for users with vestibular disorders
38+
- **44×44px minimum touch targets** (WCAG 2.1 AAA)
39+
- Optimized performance with sub-second load times
40+
- Error boundaries with automatic retry mechanisms
41+
- 📖 **[Full Accessibility Documentation](ACCESSIBILITY.md)**
42+
43+
### 📊 **Analytics & Monitoring**
44+
- Privacy-friendly user behavior tracking
45+
- Performance monitoring and diagnostics
46+
- Search pattern analysis for continuous improvement
47+
- Session analytics for usage insights
48+
49+
### 🛡️ **Reliability & Quality**
50+
- Comprehensive error handling and recovery
51+
- Background sync for seamless updates
52+
- Resource optimization and intelligent caching
53+
- Cross-browser compatibility with fallback support
54+
55+
## 🚀 How to Use
56+
57+
### **Web Browser**
58+
Visit: 👉 [https://patchnotes.faforever.com/](https://patchnotes.faforever.com/)
59+
60+
### **Install as App**
61+
1. **Desktop**: Click the install prompt or use your browser's "Install" option
62+
2. **Mobile**: Tap "Add to Home Screen" when prompted
63+
3. **Benefits**: Faster loading, offline access, native app experience
64+
65+
### **Search & Navigation**
66+
- Use the search bar to find specific patches, units, or changes
67+
- Filter by year using the dropdown menu
68+
- Press `Ctrl/Cmd + K` for quick search access
69+
- Press `?` to view all keyboard shortcuts
70+
- Toggle between Dark/Light themes in the footer
71+
72+
### **Offline Usage**
73+
Once installed, the app works completely offline - perfect for reviewing patches during gameplay or when internet is limited.
74+
75+
## 🛠️ Technical Stack
76+
77+
- **Frontend**: Vanilla JavaScript (ES6+), CSS3 with advanced features
78+
- **PWA**: Service Worker, Web App Manifest, Background Sync
79+
- **Styling**: CSS Grid, Flexbox, Backdrop-filter, Custom Properties
80+
- **Performance**: Resource preloading, critical CSS inlining, optimized caching
81+
- **Accessibility**: ARIA labels, semantic HTML, keyboard navigation, WCAG 2.1 AAA
82+
- **Monitoring**: Performance tracking, error boundaries, user analytics
83+
84+
## 📂 Project Structure
85+
86+
```
87+
├── index.html # Main application entry point
88+
├── manifest.json # PWA configuration
89+
├── sw.js # Service Worker for offline functionality
90+
├── assets/
91+
│ ├── data/
92+
│ │ └── patches.json # Patch metadata
93+
│ └── images/ # Icons, backgrounds, faction logos, unit images
94+
│ ├── backgrounds/
95+
│ ├── Enhancements/
96+
│ ├── faction/
97+
│ ├── icons/
98+
│ ├── orders/
99+
│ ├── thumbnail/
100+
│ └── units/
101+
├── pages/ # Individual patch note HTML files
102+
│ ├── 2017/ ... 2026/
103+
│ └── Template/
104+
├── scripts/
105+
│ ├── analytics.js # User behavior tracking
106+
│ ├── backToTop.js # Back to top button
107+
│ ├── collapse.js # Collapsible sections
108+
│ ├── contentSidemenu.js # Content navigation
109+
│ ├── coreUI.js # Core UI functionality
110+
│ ├── errorBoundary.js # Error handling
111+
│ ├── headConfig.js # Head configuration
112+
│ ├── keyboardShortcuts.js # Keyboard shortcuts (? for help)
113+
│ ├── lazyLoader.js # Lazy loading images
114+
│ ├── logger.js # Logging system
115+
│ ├── performance.js # Performance monitoring
116+
│ ├── populatePatches.js # Patch list generation
117+
│ ├── pwa.js # PWA installation and updates
118+
│ ├── search.js # Advanced search functionality
119+
│ ├── updatePatchFiles.js # Patch file updates
120+
│ └── validatePatches.js # Patch data validation
121+
└── style/
122+
├── balance.css # Balance change styling
123+
├── critical.css # Critical inline CSS
124+
├── index.css # Main styles with frosted glass
125+
├── pwa.css # PWA-specific styling
126+
├── root.css # CSS variables and base styles
127+
└── components/ # Component-specific styles
128+
├── accessibility.css
129+
├── button.css
130+
├── enhanced-ui.css
131+
├── images.css
132+
├── keyboard-shortcuts.css
133+
├── patch_*.css # Patch page components
134+
└── ...
135+
```
136+
137+
## 🤝 Contributing
4138

5139
Contributions are welcome and appreciated!
6140
If you'd like to help improve the site or suggest new features:
@@ -57,7 +191,8 @@ Your efforts help keep Supreme Commander: Forged Alliance Forever and this proje
57191

58192
---
59193

60-
*Built with ❤️ for the Supreme Commander: Forged Alliance Forever community*ance Forever* (FAF), featuring advanced search capabilities, offline functionality, and a beautiful frosted glass interface.
194+
*Built with ❤️ for the Supreme Commander: Forged Alliance Forever community*
195+
61196

62197
---
63198

3.14 KB
Loading

0 commit comments

Comments
 (0)