# Tremors Changelogs

> **Project:** Tremors  
> **Version:** 3.0.1
> **Last Updated:** 12-04-2026

---

## [v3.0.1] - 12-04-2026

### ✨ **New Features**

- **New Android App (Arcile):** Added "Arcile" to the portfolio, an advanced Android file manager built from scratch with Kotlin, Jetpack Compose, and Hilt featuring deep system integration, multi-volume support, and robust asynchronous caching.
- **Experience Timeline:** Designed and implemented a dynamic new "Experience" section tracing professional milestones (Pre-Sales Engineer, Independent Software Engineer). The timeline features expressive glowing nodes, responsive opposing-side layout tracking, and semantic HTML article structures.
- **Skills Reorganization:** Reorganized skills section with new categories: Frameworks & Libraries, Databases & ORM, AI & Data Science, and DevOps & Tooling.

### 🎨 **UI & Visual Consistency**

- **Card Standardization:** Normalized `.timeline-content` (Experience section) and `.contact-card` styling to fully align structurally with Skills and Portfolio cards (unified 1rem border-radius, background surface variants, borders, and shadows).
- **Glass Effect Fix:** Resolved a bug where the Dark Mode glass blur effect explicitly ignored Experience section backgrounds.
- **Appearance Settings:** Updated spotlight helper text in modal to accurately read "Hero & All Cards".
- **Head Tags:** Updated `<title>` and OpenGraph/Twitter meta tags to reflect the Software Engineer identity.
- **Spotlight Fixes:** Resolved an issue where the radial mouse spotlight was not clipped correctly by adding `overflow: hidden` and `position: relative` to card host selectors.
- **Contrast & Styling:** Improved color contrast for `.timeline-date` and `.emp-badge` using theme-aware tokens and added light-theme overrides for status badges.
- **Icons & Badges:** Replaced emoji indicators with SVG icons throughout the interface, enhanced badge contrast and styling for improved visibility, and updated portfolio badge appearance.
- **Linting:** Fixed a declaration-empty-line-before stylelint error in the experience timeline wave mask.

### 📝 **Content Verification & Updates**

- **Personal Branding:** Updated personal branding from "Python Developer" to "Software Engineer".
- **About Section:** Expanded and restructured about section.
- **About Highlights:** Refined highlight chips in the About section and synced all chips with proper high-quality Material SVG UI icons.
- **Typewriter Flow:** Polished interactive Typewriter roles string sequence.
- **Skill Highlights:** Reorganized and expanded skill highlights.

### 🐛 **Bug Fixes & Performance**

- **Typewriter Animation:** Fixed typewriter animation scroll behavior.
- **Optimization:** Optimized asset loading and preconnect handling for faster performance.

---

## [v3.0.0] - 25-02-2026

### 🎨 **UI Refinements & Theme Compatibility**

- **Hero Waves Redesign:** Replaced faint linear-gradient stripes with a multi-layered, organic CSS wave effect using radial and linear gradients (`waves.css`), with dedicated light mode colors across all themes.
- **Project Summary Section:** Added a dedicated "Summary" section to `project.html` with Scroll Spy integration.
- **Badge Color Audit:** Revised 11 badge colors for better visual distinction — lightened 6 OLED-unsafe dark badges, moved 4 out of the overcrowded blue hue range, and resolved the purple cluster collision.

### 🛡️ **Security & Code Quality**

- **XSS Prevention:** Replaced the unsafe identity-return fallback in `escapeHtmlSafe` (`project.js`) with a built-in deterministic HTML-escaping routine. Converted error state rendering from `innerHTML` to `document.createElement()` + `.textContent`.

### 🔧 **Maintainability**

- **Theme Attribute Targeting:** Unified `theme-init.js` and `index.js` to target `document.documentElement` (`<html>`) instead of `document.body`. Updated all `body[data-*]` CSS selectors to `html[...]` across theme and effect files.

### ⚡ **Performance**

- **Script Loading:** Reordered `history.html` script tags to canonical pattern and added `defer` attribute.
- **Typewriter Optimization:** Added `IntersectionObserver` to `home.js` typewriter — pauses automatically when scrolled out of view.

### ♿ **Accessibility & SEO**

- **`<noscript>` Fallback:** Added a JavaScript-required message to `project.html` for users with JS disabled.

### 🆕 **New Badges**

- Added `tech-playwright` (green), `tech-gemini` (blue), `tech-htmx` (rose), and `tech-html-css-js` (unified gradient) CSS styling and JS label mappings.

### 🐛 **Bug Fixes**

- **Data Corrections:** Fixed broken uvicorn entrypoints, clone URLs, and project paths in `projects.json`. Corrected Diff Viewer sitemap ID. Fixed Arcade Nexus description from "cloud-synced" to "local" save states.
- **UI Fixes:** Changed easter egg toast from "Python Mode Activated" to "Easter Egg Found". Removed trailing slashes from all live link URLs.

### 🔄 **Cross-File Synchronization**

- **TUI Full Sync:** Synchronized all 20 project descriptions, tech badge lists, titles, and ordering in `tui.html` to match `projects.json` — correcting names, casing, adding missing badges, and removing incorrect ones.
- **History Pages:** Added 6 new timeline entries (v2.6.5 through v3.0.0) to both `history.html` and `history-tui.html`. Updated HEAD tag and subtitle. Removed video quality toggle — consolidated to single `v0.0.0-v3.0.0.mp4` file.
- **README Evolution:** Added 5 missing version rows to the Evolution table.

### 📊 **Badge Audit (from Project Docs)**

- Audited all 20 projects against their source documentation. Corrected mismatched badges (e.g., replaced incorrect `tech-ts` with `tech-gemini` on Quizzer AI), added missing badges across 8 projects, and applied the new unified `tech-html-css-js` badge to 6 projects.

### 📝 **Content Expansion & Refinement**

- **Project Descriptions:** Rewrote `description` and `longDescription` fields for all 20 projects in `projects.json`, incorporating technical context from each project's documentation.
- **Features:** Refined and expanded the `features` arrays across all projects with specific, verifiable details.

### 🖥️ **Project Page Redesign**

- **Banner Layout:** Replaced fixed `max-height` banner with `aspect-ratio: 2/1` to prevent image zoom/crop. Sidebar stretches to match banner height.
- **Sidebar Restructure:** Removed "LINKS" heading and tech badges from sidebar. Added **Clone** (copies `git clone` command) and **Share** (copies page URL) action buttons with toast feedback.
- **Tech Badges Strip:** Moved technology badges from sidebar to a full-width horizontal strip below the banner. Centered on mobile with badges-above-sidebar ordering.
- **Context-Aware Icons:** Each sidebar link now gets a distinct icon based on content — GitHub logo, download arrow, play triangle (demo), globe (website), copy (clone), share nodes.
- **Fog Effect:** Improved section fog from 50px to 100px with multi-stop `color-mix()` gradients for softer transitions.
- **Portfolio Spotlight:** Extended the cursor spotlight effect to portfolio cards with matching CSS and JS.
- **1440p Container:** Reduced container `max-width` from `1400px` to `1200px` at the 1440p breakpoint for better spacing on high-DPI displays.

### 📚 **Documentation & Licensing**

- **LICENSE.md:** Created Tremors Source License (TSL) with quick-reference table and full legal terms.
- **DEVELOPMENT.md:** Added Naming Conventions, Security Practices, Badge Color Guidelines, Intended Changes, Project Auditing & Quality Standards, Contributing sections, and content writing guidelines for `projects.json` entries.
- **README:** Added TSL license badge and section, expanded Documentation table with `TASKS.md` and `LICENSE.md`.

---

## [v2.9.2] - 24-02-2026

### 🆕 **New Projects & Data Updates**

- **New Projects Added:** Added three new projects to `projects.json` — **Localghost** (pentesting & benchmarking toolkit), **xcrape** (smart web scraper with MD3 terminal UI), and **Side-by-Side Diff Viewer** (GitHub-style diff viewer).
- **Ranking Reorder:** Updated project ranking order in `projects.json` to reflect current priority.

---

## [v2.9.1] - 24-02-2026

### 📋 **Codebase Audit & Task Discovery**

- **Comprehensive Review:** Performed a full codebase audit across JS modules, CSS themes, HTML templates, and data files to identify outstanding issues.
- **TASKS.md Updated:** Documented 9 findings spanning Security, Maintainability, Performance, SEO, Accessibility, Data Integrity, and Code Quality — covering `project.js`, `theme-init.js`, `history.html`, `project.html`, `home.js`, `index.js`, and `projects.json`.

---

## [v2.9.0] - 21-02-2026

### 🛠️ **PR Feedback & Bug Fixes**

- **Javascript Hygiene:** Refactored inline safe-cast HTML parsing in `project.js` into an `escapeHtmlSafe` helper. Fixed an invalid `a.className="undefined"` injection during dynamic project link generation in `home.js`. Safely wrapped the document resize listener initialization.
- **Dependency Guarding:** Added safe lookup (`typeof window.Tremors.utils`) to prevent `debounce` reference errors for edge cases, and injected missing `utils.js` imports across auxiliary templates (`404.html`, `history.html`).
- **DOM & Schema Continuity:** 
  - Standardized all `sitemap.xml` timestamps into standard ISO `YYYY-MM-DD` notation.
  - Inserted missing version segment boundaries inside the historical changelog cascade.
  - Aligned development docs to strictly define `terminal_theme` mappings for MacOS/Windows/Linux instead of shorthand code names. 
  - Substituted the 1x1 base64 GIF fallback directly against `img.src` missing links to stop cascading undefined requests.
  - Rebound `theme-init.js` targeting to safely fetch `document.documentElement` if the `body` is blocked during `<head>` parsing.

---

## [v2.8.7] - 21-02-2026

### 📚 **Documentation & Refinement**

- **Documentation Overhaul:** Completely rewrote `DEVELOPMENT.md` to accurately reflect the current `v2.8.7` architecture, detailing the dual-theme systems (JS for Modern UI, Pure CSS for Terminal TUI), centralized javascript injection patterns, and `localStorage` schemas.
- **License Cleanup:** Removed deprecated `LICENSE.md` references from `README.md` following the file's deletion.
- **Data Standardization:** Converted all `<lastmod>` timestamps in `sitemap.xml` to `DD-MM-YYYY` format for parity with the Changelog structure.
- **DOM & Schema Anomalies:** 
  - Restored a missing closing `</div>` tag that was malforming the "E-commerce Website" item within `tui.html`.
  - Scrubbed the trailing 404 "Website" routing link for the local-only Plant Disease Detector model across both `projects.json` and the `tui.html` command output.

---

## [v2.8.6] - 21-02-2026

### 🛡️ **Security & Performance Improvements**

- **Improved Performance:** Restructured reusable `debounce` logic globally and specifically applied it to CPU-hot mousemove events within `extras.js` to eliminate frame dropping during magnetic text interaction.
- **XSS Prevention:** Sanitized project image URLs within `project.js` by casting all injection flows through `encodeURI()`.
- **Anti-Scraping Obfuscation:** Replaced hardcoded email instances in `index.html` and `index.js` with an encoded script-driven implementation to limit crawler indexing. Retained standard mailto fallback in TUI.
- **Better LCP:** Removed negligent `loading="lazy"` attributes from above-the-fold hero assets (e.g. `aman.png`) to directly improve First Contentful Paint.

---

## [v2.8.5] - 21-02-2026

### 🛠️ **Code Quality & Maintainability**

- **HTML Deduplication:** Replaced massively duplicated HTML strings across `index.html`, `project.html`, and `404.html` with centralized JavaScript injection using a new `components.js` file for standardizing the Settings Modal and Header Nav markup.
- **Theme Initialization Optimization:** Extracted inline scripts scattered across multiple pages into a reusable, cached `theme-init.js` module. The script logic safely verifies feature toggles, avoiding initialization errors on smaller pages.
- **Global Namespace Safety:** Purged sprawling properties from the `window` object by encapsulating common tools (`getBadgeLabel`, `escapeHtml`, `debounce`, `showToast`) inside a consolidated `window.Tremors.utils` namespace.
- **Safer DOM Interactions:** Eliminated insecure template string interpolation (`innerHTML`) from the `createProjectCard` flow in `home.js`. Switched structure strictly to standard memory-allocated `HTMLElement` node builders (`document.createElement`).
- **Clean Event Attachments:** Scrubbed all inline `onclick=...` overrides from `<button>` and `<a>` elements, swapping to standard `.addEventListener()` methods mapped internally within modules.

## [v2.8.4] - 20-02-2026

### 🚀 **SEO & Social Optimization**

-   **Sitemap Synchronization:** Fully synced `sitemap.xml` with `projects.json`. Removed phantom project IDs (`pygame-calculator`, `local-team-chat`) and added missing active projects (`socnet`, `material-design`, `recontext`).
-   **Lastmod Update:** Updated all `<lastmod>` entries in `sitemap.xml` to `2026-01-24` to reflect the latest state.
-   **Dynamic OG Tags:** Implemented dynamic Open Graph meta tags in `project.html`. Project pages now correctly display project-specific titles, descriptions, and preview images when shared on social platforms.
-   **DOM Targeting:** Added unique IDs to OG meta tags for reliable JavaScript-based updates.

---
    
## [v2.8.3] - 19-02-2026

### 📝 **Documentation & Architecture Sync**

-   **Technical Reference:** Comprehensive audit and update of `DEVELOPMENT.md` to accurately reflect the v2.8.x architecture.
-   **Schema Alignment:** Synced `projects.json` documentation with the actual production schema (Links, Badges, Installation strings).
-   **State Management:** Corrected `localStorage` keys and default settings in technical docs to match the actual implementation.
-   **File Architecture:** Updated project structure maps to include missing modules (`utils.js`, `index.js`) and correct CSS/Effect paths.

## [v2.8.2] - 19-02-2026

### 🛠️ **Bug Fixes**

-   **Color Contrast:** Fixed accessibility issue where sidebar cards in `project.html` (Links/Technologies) remained dark in Light Mode when the Glass effect was active.
-   **HTML Stability:** Removed duplicate `#toast` ID in `index.html` and synced theme initialization to target `document.body` for consistency.
-   **Navigation & SEO:** Fixed `tui.html` canonical URL to correctly point to itself and updated `project.html` footer version.
-   **Initialization Logic:** Cleaned up redundant spotlight and pattern logic/links in `project.html` to optimize secondary page loading.
-   **Defensive JS:** Added safety guards to `home.js` and `extras.js` to prevent silent failures on pages where specific DOM elements (magnet text, hero sections) are missing.
-   **Security & UX:** Implemented error handling for the "Copy Command" feature in `project.js` to provide user feedback if clipboard operations fail.

## [v2.8.1] - 24-01-2026

### 📝 **Content & Persona Refresh**

-   **Portfolio Bio:** Refined Hero intro and "About Me" sections (Index & TUI) to focus on professional philosophy and full-stack specialization, prioritizing narrative over chronological details.
-   **Typewriter Roles:** Updated `home.js` roles to a cohesive "Identity -> Role -> Action" sequence (e.g., "Building Scalable Apps", "Crafting Developer Tools").
-   **TUI Corrections:** Fixed outdated tech stack for GitNexus (Flask → FastAPI) and corrected minor typos.

### ⚙️ **Process Updates**

-   **Installation Guides:** Updated `projects.json` to explicitly show concurrent terminal commands for split-stack projects and corrected Quizzer AI path.
-   **SEO & Metadata:** Synced `sitemap.xml` dates and meta descriptions with the new content.

### 🐛 **Bug Fixes**

-   **Project Navigation:** Implemented Scroll Spy in `project.js` for accurate section highlighting and fixed Logo link to return to Portfolio Home.
-   **TUI Synchronization:** Synced skills list in `tui.html` to exactly match the categorized skills in `index.html`.
-   **Typo Fixes:** Corrected grammar in Beta status messages ("features may be incomplete").

## [v2.8.0] - 17-01-2026

### 🛠️ **Unified Tooling (gtrmrs)**

-   **New unified CLI Utility:** Unified `repo-tree`, `locr`, and `gitmig` into a single, cohesive CLI tool named `gtrmrs`.
-   **Simplified Installation:** Users can now install one tool to get directory visualization, LOC counting, and git migration features.
-   **Documentation Update:** Expanded project description to clearly explain the unification.

### 🎨 **TUI Portfolio Enhancements**

-   **Status Badges (Corner Tags):** Added graphical status indicators (BETA, ARCHIVED, DEVELOPMENT) to portfolio items.
    -   **Design:** Styled as bottom-right corner tags with dotter borders, matching the tech stack badge aesthetic.
    -   **Visibility:** Subtle content highlight tells the status at a glance without clutter.
-   **Ranking Update:** Updated `tui.html` project order to prioritize `gtrmrs` and other active projects.

---

## [v2.7.0] - 14-01-2026

### 📝 **Documentation Overhaul**

- **README Reformat:** Complete restructure using modern portfolio template format:
    - Added centered header with logo, title link, and tech badges (HTML5, CSS3, JavaScript, License).
    - Added GitHub-style NOTE callout for personal portfolio tag.
    - Converted features to scannable feature table with emoji icons.
    - Added condensed Quick Start section with clear commands.
    - Added Tech Stack table replacing inline technology list.
    - Added formatted Project Structure code block.
    - Split Modern UI and Terminal TUI into dedicated feature sections.
    - Added Evolution table summarizing version highlights.
    - Added Documentation links table.
    - Added centered footer with attribution.

- **DEVELOPMENT.md Created:** Technical reference documentation:
    - Architecture Overview with Static-First diagram.
    - Complete Project Structure breakdown.
    - File Conventions tables for HTML, CSS, and JS modules.
    - Theme System documentation (OLED/MD/MD3, effects, localStorage keys).
    - Data Schema with `projects.json` format and status values.
    - Code Style standards and Performance Targets.
    - Browser Compatibility matrix.

---

## [v2.6.5] - 02-01-2026

### 🎨 **UI Refinements & Theme Compatibility**

- **Theme Initialization:** Fixed initialization logic in `history.html`, `404.html`, `system/index-404.html`, and `project.html` to consistently apply themes by targeting `document.body`.
- **Simplified Settings Modal:** Unified settings modal to a single-view layout (no tabs) across all pages for better usability.
- **Context-Aware Settings:** Removed irrelevant "Spotlight" and "Hero" settings from secondary pages (`history`, `404`, `project`) while retaining them on `index.html`.
- **Glass Effect Fix:** Resolved Light Mode visibility issues where the glass effect background was too dark; now uses a proper semi-transparent light surface.
- **Contrast Fixes:** Updated "Spotlight Effect" toggle switch to use theme-aware variables (`var(--md-on-primary)`), fixing visibility in Dark/MD3 modes.
- **Code Cleanup:** Removed duplicated HTML content blocks and stray closing tags across multiple files.


## [v2.6.0] - 02-01-2026

### 🚦 **Project Status Indicators**

- **Dynamic Banners:** Added visual status indicators for projects marked as `wip` (Warning), `beta` (Info), `archive` (Error), and `featured` (Success) in `projects.json`.
- **Automatic Styling:** Banners are auto-generated above the description with corresponding emojis (⚠️, 🧪, 📦, ⭐) and color schemes.

### 🧭 **Navigation & Discovery**

- **Recommended Projects:** Implemented a new "Recommended" section above the footer navigation.
    - **Smart Recommendations:** Can display single or multiple related projects defined via a `recommended` array in JSON.
    - **Unified Styling:** Cards match the standard navigation design but feature a highlighted primary border and glow effect.
    - **Circular CLI Loop:** Configured `locr` ↔ `gitmig` ↔ `repo-tree` to recommend each other.
    - **Legacy Redirection:** `eshopper` (Archived) now recommends `amanzon` (Modern).

- **Navigation Refinements:**
    - **Directional Arrows:** Added visual `←` and `→` arrows to navigation cards, removing text labels for a cleaner look.
    - **Improved Mobile Layout:** "Next" card now uses a symmetrical right-aligned layout (Image Right) while maintaining left-aligned text for readability.
    - **Text Fix:** Removed JavaScript description truncation to ensure text fills the card properly on mobile, eliminating "middle start" visual gaps.

### 🎞️ **History Timeline**

-   **High Quality Toggle:** Added a "Switch to HQ" feature on history pages.
    -   **Modern UI:** Interactive JS toggle to swap between 720p (Optimized) and 1080p (Original) renders on demand.
    -   **TUI:** CSS-only radio switch to toggle players without JavaScript.
    -   **Lazy Loading:** HQ video is set to `preload="none"` to save bandwidth until explicitly requested.

---

## [v2.5.2] - 01-01-2026

### 🧹 **Code Hygiene & Cleanup**

- **Documentation Overhaul:** Performed a comprehensive cleanup of code comments across the entire `static/` directory (JS, CSS, Themes, Effects).
- **Consistent Style:** Standardized all file headers and section titles to "Minimalist Structural Commenting" style.
- **Noise Reduction:** Removed excessive numbered steps, redundant inline comments, and verbose explanations from production code.
- **Files Processed:** `home.js`, `project.js`, `utils.js`, `index-*.css`, `tui-*.css`, `themes/*.css`, and `effects/*.css`.

### 🛡️ **Security**

- **XSS Prevention:** Verified and enhanced HTML escaping in `project.js` rendering logic.

---

## [v2.5.1] - 22-12-2025

### 🔄 **Project Updates**

- **Tremors Portfolio:** Replaced "Nexus" project with the new integrated "Tremors Portfolio" — a multi-mode portfolio website with 5 viewing modes (Default, Terminal, Paper, Newspaper, Nexus), GitHub API integration, AI newspaper generation, and secret admin controls.
- **New Tech Badge:** Added `tech-prisma` badge (CSS color + JS label mapping) for Prisma ORM.

### 📦 **Data Synchronization**

- **Sitemap Cleanup:** Removed invalid `tremors-music-app` URL, added missing `cosmos` and `gitmig` projects, updated all dates to 2025-12-22.
- **TUI Sync:** Updated `tui.html` to replace "Nexus" with "Tremors Portfolio" including new tech badges (TypeScript, Tailwind, Prisma).
- **GitNexus Demo Link:** Updated live demo URL in TUI to point to correct scrap projects demo.

---

## [v2.5.0] - 19-12-2025

### 🆕 **New Projects & Content**

- **GitMig:** Added Git migration utility for clean repo backups (Python CLI).
- **Earnslate:** Updated with live URL (earnslate.vercel.app) and full project details.
- **Cosmos:** Added 3D solar system simulation project (WIP).

### 📦 **Project Ranking & Organization**

- **Major Reorder:** Updated `projects.json` with new priority ranking (Quizzer AI → GitNexus → Algorithm Visualizer → Arcade Nexus → Tremors Music → Earnslate → Cosmos → ...).
- **TUI Sync:** Updated `tui.html` portfolio section to match the new project order with 5 visible and 12 hidden projects.

### 🐛 **Bug Fixes**

- **Theme Flash Prevention:** Fixed FOUC (flash of unstyled content) issues across all pages.
- **Waves Pattern:** Rewrote animated gradient waves to use background layers instead of pseudo-elements (prevents conflict with fog/spotlight effects).
- **Pattern Animation Refresh:** Added repaint trigger for instant CSS animation apply on pattern switch.
- **Mobile Navigation:** Added media query for screens under 360px to prevent navigation overlap.
- **Linux Terminal Icon:** Added Tux penguin icon to terminal style switcher button.
- **localStorage Keys:** Standardized `terminal-theme` to `terminal_theme` (snake_case).
- **Dead Code Removal:** Removed unused Auto button handler from `project.js`.
- **History Page Init:** Fixed theme initialization in `system/history.html` to match standardized pattern.
- **Three.js Badge:** Added missing `tech-threejs` label mapping to `utils.js`.
- **CSS Typo:** Fixed "potfolio" → "portfolio" in animation comment.
- **Duplicate Entry:** Removed duplicate Earnslate entry from `tui.html`.

### 📝 **Documentation**

- **DEVELOPMENT.md:** Created development guidelines for theme system, adding projects/badges, and consistency rules.
- **TASKS.md:** Updated with all review findings and marked as complete.

---


## [Older Versions]

For older changelogs (v0.0.0 - v2.3.0), please see [CHANGELOG_ARCHIVE.md](CHANGELOG_ARCHIVE.md).
