feat: implement CSS sprite system for image optimization

Reduces HTTP requests from 44+ individual images to 3 sprite sheets
(~93% reduction). Includes Go sprite generator tool, CSS classes,
template integration, and E2E tests.

- Add cmd/sprites/main.go for sprite generation (60x60px + 120x120px @2x)
- Add _sprites.css with responsive sizing and retina support
- Update templates to use sprites with logoIndex fallback
- Add Makefile targets: sprites, sprites-clean
- Add 9-test E2E suite for sprite functionality
- Add doc/22-SPRITES.md with usage documentation
This commit is contained in:
juanatsap
2025-12-04 11:38:36 +00:00
parent 7727405c25
commit b5a50ca3ef
25 changed files with 2194 additions and 76 deletions
+175
View File
@@ -0,0 +1,175 @@
/* ============================================================================
CSS SPRITES - Image Request Optimization
============================================================================
Reduces HTTP requests from 44+ individual images to just 3 sprite sheets.
Each sprite uses CSS custom property --icon-index for positioning.
============================================================================ */
/* Base sprite class */
.icon-sprite {
display: inline-block;
width: 50px;
height: 50px;
background-repeat: no-repeat;
background-size: auto 50px;
vertical-align: middle;
}
/* Company icons */
.icon-company {
background-image: url('/static/images/sprites/sprite-companies.png');
background-position-x: calc(var(--icon-index, 0) * -50px);
}
/* Project icons */
.icon-project {
background-image: url('/static/images/sprites/sprite-projects.png');
background-position-x: calc(var(--icon-index, 0) * -50px);
}
/* Course icons */
.icon-course {
background-image: url('/static/images/sprites/sprite-courses.png');
background-position-x: calc(var(--icon-index, 0) * -50px);
}
/* Retina displays - use @2x sprites for crisp rendering */
@media (-webkit-min-device-pixel-ratio: 2), (min-resolution: 192dpi) {
.icon-company {
background-image: url('/static/images/sprites/sprite-companies@2x.png');
background-size: auto 50px; /* Display at 1x size */
}
.icon-project {
background-image: url('/static/images/sprites/sprite-projects@2x.png');
background-size: auto 50px;
}
.icon-course {
background-image: url('/static/images/sprites/sprite-courses@2x.png');
background-size: auto 50px;
}
}
/* Size variants for different contexts */
.icon-sprite.icon-small {
width: 32px;
height: 32px;
background-size: auto 32px;
}
.icon-sprite.icon-small.icon-company {
background-position-x: calc(var(--icon-index, 0) * -32px);
}
.icon-sprite.icon-small.icon-project {
background-position-x: calc(var(--icon-index, 0) * -32px);
}
.icon-sprite.icon-small.icon-course {
background-position-x: calc(var(--icon-index, 0) * -32px);
}
.icon-sprite.icon-large {
width: 64px;
height: 64px;
background-size: auto 64px;
}
.icon-sprite.icon-large.icon-company {
background-position-x: calc(var(--icon-index, 0) * -64px);
}
.icon-sprite.icon-large.icon-project {
background-position-x: calc(var(--icon-index, 0) * -64px);
}
.icon-sprite.icon-large.icon-course {
background-position-x: calc(var(--icon-index, 0) * -64px);
}
/* For section logos - match .company-logo img styling */
/* Use a wrapper approach: 80px box, 60px icon centered inside */
.icon-sprite.icon-section {
/* Outer box matches img styling */
width: 80px;
height: 80px;
border-radius: 4px;
border: 1px solid var(--icon-border, #ddd);
background-color: transparent;
box-sizing: border-box;
/* Inner content area for sprite */
padding: 10px;
background-size: auto 60px;
background-origin: content-box;
background-clip: content-box;
background-position: 0 0;
}
.icon-sprite.icon-section.icon-company {
background-position-x: calc(var(--icon-index, 0) * -60px);
}
.icon-sprite.icon-section.icon-project {
background-position-x: calc(var(--icon-index, 0) * -60px);
}
.icon-sprite.icon-section.icon-course {
background-position-x: calc(var(--icon-index, 0) * -60px);
}
/* Retina overrides for size variants */
@media (-webkit-min-device-pixel-ratio: 2), (min-resolution: 192dpi) {
.icon-sprite.icon-small {
background-size: auto 32px;
}
.icon-sprite.icon-small.icon-company {
background-position-x: calc(var(--icon-index, 0) * -32px);
}
.icon-sprite.icon-small.icon-project {
background-position-x: calc(var(--icon-index, 0) * -32px);
}
.icon-sprite.icon-small.icon-course {
background-position-x: calc(var(--icon-index, 0) * -32px);
}
.icon-sprite.icon-large {
background-size: auto 64px;
}
.icon-sprite.icon-large.icon-company {
background-position-x: calc(var(--icon-index, 0) * -64px);
}
.icon-sprite.icon-large.icon-project {
background-position-x: calc(var(--icon-index, 0) * -64px);
}
.icon-sprite.icon-large.icon-course {
background-position-x: calc(var(--icon-index, 0) * -64px);
}
.icon-sprite.icon-section {
padding: 10px;
background-size: auto 60px;
background-position: 0 0;
}
.icon-sprite.icon-section.icon-company {
background-size: auto 60px;
background-position-x: calc(var(--icon-index, 0) * -60px);
}
.icon-sprite.icon-section.icon-project {
background-size: auto 60px;
background-position-x: calc(var(--icon-index, 0) * -60px);
}
.icon-sprite.icon-section.icon-course {
background-size: auto 60px;
background-position-x: calc(var(--icon-index, 0) * -60px);
}
}
+1
View File
@@ -35,6 +35,7 @@
@import './04-interactive/_toasts.css';
@import './04-interactive/_zoom-control.css';
@import './04-interactive/_contact-form.css';
@import './04-interactive/_sprites.css';
/* 05 - Responsive */
@import './05-responsive/_breakpoints.css';
+1 -1
View File
File diff suppressed because one or more lines are too long
Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 176 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 78 KiB

+184
View File
@@ -0,0 +1,184 @@
{
"companies": [
{
"index": 0,
"name": "accenture.png"
},
{
"index": 1,
"name": "aena-long.png"
},
{
"index": 2,
"name": "aena.png"
},
{
"index": 3,
"name": "clicplan-short.png"
},
{
"index": 4,
"name": "clicplan.png"
},
{
"index": 5,
"name": "drolosoft.png"
},
{
"index": 6,
"name": "drosoloft-plain.png"
},
{
"index": 7,
"name": "ebantic.png"
},
{
"index": 8,
"name": "emailing-network.png"
},
{
"index": 9,
"name": "everis.png"
},
{
"index": 10,
"name": "gigya.png"
},
{
"index": 11,
"name": "indra.png"
},
{
"index": 12,
"name": "insa.png"
},
{
"index": 13,
"name": "livgolf.png"
},
{
"index": 14,
"name": "megabanner.png"
},
{
"index": 15,
"name": "olympic-broadcasting.png"
},
{
"index": 16,
"name": "pentamsi-long.png"
},
{
"index": 17,
"name": "pentamsi.png"
},
{
"index": 18,
"name": "sap.png"
},
{
"index": 19,
"name": "twentic.png"
},
{
"index": 20,
"name": "uex.png"
},
{
"index": 21,
"name": "webratio.png"
},
{
"index": 22,
"name": "webratioa.png"
}
],
"projects": [
{
"index": 0,
"name": "HERRUMBRE_NEGATIVO VER 2@4x.png"
},
{
"index": 1,
"name": "deliverybikes.png"
},
{
"index": 2,
"name": "herrumbre-vivo.png"
},
{
"index": 3,
"name": "jorpack.png"
},
{
"index": 4,
"name": "laporra-doc.png"
},
{
"index": 5,
"name": "laporra.png"
},
{
"index": 6,
"name": "lidering.png"
},
{
"index": 7,
"name": "ola-logo-squared-blue.png"
},
{
"index": 8,
"name": "sap.png"
},
{
"index": 9,
"name": "somosunaola#.png"
},
{
"index": 10,
"name": "somosunaola.png"
},
{
"index": 11,
"name": "twentic.png"
}
],
"courses": [
{
"index": 0,
"name": "camaracomercio.png"
},
{
"index": 1,
"name": "codecademy.png"
},
{
"index": 2,
"name": "forem.png"
},
{
"index": 3,
"name": "linkedin-blue.png"
},
{
"index": 4,
"name": "linkedin.png"
},
{
"index": 5,
"name": "servoy-logo.png"
},
{
"index": 6,
"name": "servoy.png"
},
{
"index": 7,
"name": "udemy.png"
},
{
"index": 8,
"name": "uex.png"
}
]
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 147 KiB

+371
View File
@@ -0,0 +1,371 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>CSS Sprite Showcase</title>
<link rel="stylesheet" href="/static/css/04-interactive/_sprites.css">
<style>
* {
box-sizing: border-box;
}
body {
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
max-width: 1200px;
margin: 0 auto;
padding: 2rem;
background: #f5f5f5;
}
h1 {
color: #333;
border-bottom: 2px solid #333;
padding-bottom: 0.5rem;
}
h2 {
color: #666;
margin-top: 2rem;
}
h3 {
color: #888;
margin-top: 1.5rem;
}
.sprite-full {
background: white;
padding: 1rem;
border-radius: 8px;
box-shadow: 0 2px 4px rgba(0,0,0,0.1);
margin: 1rem 0;
overflow-x: auto;
}
.sprite-full img {
display: block;
height: 48px;
image-rendering: crisp-edges;
}
.icon-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(120px, 1fr));
gap: 1rem;
margin: 1rem 0;
}
.icon-item {
background: white;
padding: 1rem;
border-radius: 8px;
box-shadow: 0 2px 4px rgba(0,0,0,0.1);
text-align: center;
}
.icon-item label {
display: block;
margin-top: 0.5rem;
font-size: 0.75rem;
color: #666;
word-break: break-all;
}
.zoom-test {
background: white;
padding: 1rem;
border-radius: 8px;
box-shadow: 0 2px 4px rgba(0,0,0,0.1);
margin: 1rem 0;
}
.zoom-test div {
display: flex;
align-items: center;
gap: 1rem;
margin: 0.5rem 0;
}
.zoom-test span:first-child {
width: 60px;
font-weight: bold;
}
.retina-test {
background: white;
padding: 1rem;
border-radius: 8px;
box-shadow: 0 2px 4px rgba(0,0,0,0.1);
margin: 1rem 0;
display: flex;
gap: 2rem;
}
.retina-test div {
text-align: center;
}
.retina-test label {
display: block;
margin-top: 0.5rem;
font-size: 0.875rem;
color: #666;
}
.summary {
background: #e8f5e9;
padding: 1rem;
border-radius: 8px;
margin: 1rem 0;
}
.summary ul {
margin: 0.5rem 0;
padding-left: 1.5rem;
}
</style>
</head>
<body>
<h1>CSS Sprite Showcase</h1>
<div class="summary">
<strong>Summary:</strong>
<ul>
<li>Companies: 23 icons</li>
<li>Projects: 12 icons</li>
<li>Courses: 9 icons</li>
<li><strong>Total: 44 icons</strong></li>
</ul>
</div>
<section>
<h2>Companies (Full Sprite)</h2>
<div class="sprite-full">
<img src="/static/images/sprites/sprite-companies.png" alt="companies sprite">
</div>
<h3>Individual Icons</h3>
<div class="icon-grid">
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 0;"></span>
<label>0: accenture</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 1;"></span>
<label>1: aena-long</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 2;"></span>
<label>2: aena</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 3;"></span>
<label>3: clicplan-short</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 4;"></span>
<label>4: clicplan</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 5;"></span>
<label>5: drolosoft</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 6;"></span>
<label>6: drosoloft-plain</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 7;"></span>
<label>7: ebantic</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 8;"></span>
<label>8: emailing-network</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 9;"></span>
<label>9: everis</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 10;"></span>
<label>10: gigya</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 11;"></span>
<label>11: indra</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 12;"></span>
<label>12: insa</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 13;"></span>
<label>13: livgolf</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 14;"></span>
<label>14: megabanner</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 15;"></span>
<label>15: olympic-broadcasting</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 16;"></span>
<label>16: pentamsi-long</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 17;"></span>
<label>17: pentamsi</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 18;"></span>
<label>18: sap</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 19;"></span>
<label>19: twentic</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 20;"></span>
<label>20: uex</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 21;"></span>
<label>21: webratio</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-companie" style="--icon-index: 22;"></span>
<label>22: webratioa</label>
</div>
</div>
</section>
<section>
<h2>Projects (Full Sprite)</h2>
<div class="sprite-full">
<img src="/static/images/sprites/sprite-projects.png" alt="projects sprite">
</div>
<h3>Individual Icons</h3>
<div class="icon-grid">
<div class="icon-item">
<span class="icon-sprite icon-project" style="--icon-index: 0;"></span>
<label>0: HERRUMBRE_NEGATIVO VER 2@4x</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-project" style="--icon-index: 1;"></span>
<label>1: deliverybikes</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-project" style="--icon-index: 2;"></span>
<label>2: herrumbre-vivo</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-project" style="--icon-index: 3;"></span>
<label>3: jorpack</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-project" style="--icon-index: 4;"></span>
<label>4: laporra-doc</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-project" style="--icon-index: 5;"></span>
<label>5: laporra</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-project" style="--icon-index: 6;"></span>
<label>6: lidering</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-project" style="--icon-index: 7;"></span>
<label>7: ola-logo-squared-blue</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-project" style="--icon-index: 8;"></span>
<label>8: sap</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-project" style="--icon-index: 9;"></span>
<label>9: somosunaola#</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-project" style="--icon-index: 10;"></span>
<label>10: somosunaola</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-project" style="--icon-index: 11;"></span>
<label>11: twentic</label>
</div>
</div>
</section>
<section>
<h2>Courses (Full Sprite)</h2>
<div class="sprite-full">
<img src="/static/images/sprites/sprite-courses.png" alt="courses sprite">
</div>
<h3>Individual Icons</h3>
<div class="icon-grid">
<div class="icon-item">
<span class="icon-sprite icon-course" style="--icon-index: 0;"></span>
<label>0: camaracomercio</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-course" style="--icon-index: 1;"></span>
<label>1: codecademy</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-course" style="--icon-index: 2;"></span>
<label>2: forem</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-course" style="--icon-index: 3;"></span>
<label>3: linkedin-blue</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-course" style="--icon-index: 4;"></span>
<label>4: linkedin</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-course" style="--icon-index: 5;"></span>
<label>5: servoy-logo</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-course" style="--icon-index: 6;"></span>
<label>6: servoy</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-course" style="--icon-index: 7;"></span>
<label>7: udemy</label>
</div>
<div class="icon-item">
<span class="icon-sprite icon-course" style="--icon-index: 8;"></span>
<label>8: uex</label>
</div>
</div>
</section>
<section>
<h2>Zoom Test</h2>
<div class="zoom-test">
<div style="zoom: 1;"><span>100%:</span><span class="icon-sprite icon-company" style="--icon-index: 0;"></span></div>
<div style="zoom: 2;"><span>200%:</span><span class="icon-sprite icon-company" style="--icon-index: 0;"></span></div>
<div style="zoom: 3;"><span>300%:</span><span class="icon-sprite icon-company" style="--icon-index: 0;"></span></div>
</div>
</section>
<section>
<h2>Retina Test</h2>
<p>On retina displays, the @2x sprite should load automatically for crisp rendering.</p>
<div class="retina-test">
<div>
<span class="icon-sprite icon-company" style="--icon-index: 0;"></span>
<label>Should be crisp on retina</label>
</div>
<div>
<span class="icon-sprite icon-project" style="--icon-index: 0;"></span>
<label>Project icon</label>
</div>
<div>
<span class="icon-sprite icon-course" style="--icon-index: 0;"></span>
<label>Course icon</label>
</div>
</div>
</section>
<section>
<h2>Network Verification</h2>
<p>Open DevTools (Network tab, filter by Images) to verify:</p>
<ul>
<li>Only 3 sprite images should load (not 44+ individual images)</li>
<li>On retina displays, @2x versions should load</li>
</ul>
</section>
</body>
</html>