@jaimevalasek/aioson 1.7.0 → 1.7.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +25 -0
- package/package.json +1 -1
- package/src/constants.js +13 -0
- package/template/.aioson/agents/copywriter.md +463 -0
- package/template/.aioson/agents/dev.md +29 -1
- package/template/.aioson/agents/deyvin.md +1 -0
- package/template/.aioson/agents/neo.md +5 -1
- package/template/.aioson/agents/qa.md +101 -0
- package/template/.aioson/agents/setup.md +17 -1
- package/template/.aioson/agents/squad.md +190 -0
- package/template/.aioson/agents/ux-ui.md +169 -3
- package/template/.aioson/genomes/copywriting.md +204 -0
- package/template/.aioson/skills/design/cognitive-core-ui/references/motion.md +2 -0
- package/template/.aioson/skills/marketing/references/anti-patterns.md +254 -0
- package/template/.aioson/skills/marketing/references/fascinations.md +192 -0
- package/template/.aioson/skills/marketing/references/five-acts.md +248 -0
- package/template/.aioson/skills/marketing/references/market-intelligence.md +198 -0
- package/template/.aioson/skills/marketing/references/offer-structure.md +203 -0
- package/template/.aioson/skills/marketing/references/one-belief.md +149 -0
- package/template/.aioson/skills/marketing/references/patterns.md +218 -0
- package/template/.aioson/skills/marketing/references/pms-research.md +193 -0
- package/template/.aioson/skills/marketing/vsl-craft.md +385 -0
- package/template/.aioson/skills/static/landing-page-deploy.md +192 -0
- package/template/.aioson/skills/static/landing-page-forge.md +730 -0
- package/template/.aioson/skills/static/ui-ux-modern.md +1 -0
- package/template/.aioson/tasks/squad-create.md +22 -0
- package/template/.aioson/tasks/squad-design.md +30 -0
- package/template/.aioson/templates/squads/digital-marketing-agency/template.json +96 -0
- package/template/CLAUDE.md +1 -0
- package/template/.aioson/skills/design-system/components/SKILL.md:Zone.Identifier +0 -0
- package/template/.aioson/skills/design-system/dashboards/SKILL.md:Zone.Identifier +0 -0
- package/template/.aioson/skills/design-system/foundations/SKILL.md:Zone.Identifier +0 -0
- package/template/.aioson/skills/design-system/motion/SKILL.md:Zone.Identifier +0 -0
- package/template/.aioson/skills/design-system/patterns/SKILL.md:Zone.Identifier +0 -0
|
@@ -0,0 +1,730 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: landing-page-forge
|
|
3
|
+
description: Advanced landing page production skill — animation libraries (GSAP, AnimeJS), high-impact motion patterns (horizontal scroll, magnetic mouse, hero sequences), performance checklist, SEO/LLMO setup, tracking integration. Load when building landing pages, sales pages, event pages, or any conversion-focused page.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Landing Page Forge
|
|
7
|
+
|
|
8
|
+
Production playbook for landing pages that convert. Covers animation craft, performance, discoverability, and tracking — the full stack from visual to measurable.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. Animation library choice
|
|
13
|
+
|
|
14
|
+
### GSAP (GreenSock Animation Platform)
|
|
15
|
+
**Use when:** you need scroll-driven horizontal sections, magnetic mouse effects, SVG animations, or complex sequenced timelines.
|
|
16
|
+
|
|
17
|
+
```html
|
|
18
|
+
<!-- CDN (free tier covers most needs) -->
|
|
19
|
+
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js"></script>
|
|
20
|
+
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/ScrollTrigger.min.js"></script>
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
```js
|
|
24
|
+
gsap.registerPlugin(ScrollTrigger);
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
**npm:** `npm install gsap`
|
|
28
|
+
|
|
29
|
+
### AnimeJS
|
|
30
|
+
**Use when:** you want lightweight, zero-dependency micro-animations — counters, SVG morphing, staggered list reveals, hover interactions.
|
|
31
|
+
|
|
32
|
+
```html
|
|
33
|
+
<script src="https://cdnjs.cloudflare.com/ajax/libs/animejs/3.2.1/anime.min.js"></script>
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
**npm:** `npm install animejs`
|
|
37
|
+
|
|
38
|
+
### When to use which
|
|
39
|
+
|
|
40
|
+
| Effect | Library |
|
|
41
|
+
|---|---|
|
|
42
|
+
| Horizontal scroll section | GSAP + ScrollTrigger |
|
|
43
|
+
| Magnetic mouse / cursor aura | GSAP |
|
|
44
|
+
| Scroll-reveal stagger | Either (GSAP for precision, AnimeJS for light pages) |
|
|
45
|
+
| Number count-up | AnimeJS |
|
|
46
|
+
| SVG path drawing | AnimeJS |
|
|
47
|
+
| Complex parallax | GSAP |
|
|
48
|
+
| Simple fade-in sequence | CSS keyframes (no library needed) |
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## 2. High-impact motion patterns
|
|
53
|
+
|
|
54
|
+
### 2.1 Horizontal scroll marquee (infinite ticker)
|
|
55
|
+
|
|
56
|
+
Feature strip, client logos, testimonials — scrolls sideways while user scrolls down.
|
|
57
|
+
|
|
58
|
+
```html
|
|
59
|
+
<section class="marquee-section">
|
|
60
|
+
<div class="marquee-track">
|
|
61
|
+
<div class="marquee-items" id="marqueeItems">
|
|
62
|
+
<!-- items duplicated in JS -->
|
|
63
|
+
</div>
|
|
64
|
+
</div>
|
|
65
|
+
</section>
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
```css
|
|
69
|
+
.marquee-section { overflow: hidden; }
|
|
70
|
+
.marquee-track { display: flex; }
|
|
71
|
+
.marquee-items { display: flex; gap: 48px; white-space: nowrap; will-change: transform; }
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
```js
|
|
75
|
+
// GSAP infinite marquee
|
|
76
|
+
gsap.to("#marqueeItems", {
|
|
77
|
+
x: "-50%",
|
|
78
|
+
duration: 20,
|
|
79
|
+
ease: "none",
|
|
80
|
+
repeat: -1
|
|
81
|
+
});
|
|
82
|
+
// Clone items for seamless loop
|
|
83
|
+
const items = document.getElementById("marqueeItems");
|
|
84
|
+
items.innerHTML += items.innerHTML;
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### 2.2 Horizontal scroll section (scroll → move sideways)
|
|
88
|
+
|
|
89
|
+
Cards or features that slide horizontally as user scrolls vertically.
|
|
90
|
+
|
|
91
|
+
```html
|
|
92
|
+
<section class="h-scroll-wrapper">
|
|
93
|
+
<div class="h-scroll-pin">
|
|
94
|
+
<div class="h-scroll-track" id="hTrack">
|
|
95
|
+
<div class="h-scroll-card">...</div>
|
|
96
|
+
<div class="h-scroll-card">...</div>
|
|
97
|
+
<div class="h-scroll-card">...</div>
|
|
98
|
+
</div>
|
|
99
|
+
</div>
|
|
100
|
+
</section>
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
```css
|
|
104
|
+
.h-scroll-wrapper { height: 300vh; }
|
|
105
|
+
.h-scroll-pin { position: sticky; top: 0; overflow: hidden; height: 100vh; }
|
|
106
|
+
.h-scroll-track { display: flex; width: max-content; }
|
|
107
|
+
.h-scroll-card { width: 80vw; flex-shrink: 0; margin-right: 32px; }
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
```js
|
|
111
|
+
const track = document.getElementById("hTrack");
|
|
112
|
+
const totalWidth = track.scrollWidth - window.innerWidth;
|
|
113
|
+
|
|
114
|
+
gsap.to(track, {
|
|
115
|
+
x: () => -totalWidth,
|
|
116
|
+
ease: "none",
|
|
117
|
+
scrollTrigger: {
|
|
118
|
+
trigger: ".h-scroll-wrapper",
|
|
119
|
+
start: "top top",
|
|
120
|
+
end: "bottom top",
|
|
121
|
+
scrub: 1,
|
|
122
|
+
pin: ".h-scroll-pin",
|
|
123
|
+
anticipatePin: 1
|
|
124
|
+
}
|
|
125
|
+
});
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
### 2.3 Magnetic mouse effect (cursor aura / hover field)
|
|
129
|
+
|
|
130
|
+
Interactive element that subtly follows the cursor — gives premium tactile feel.
|
|
131
|
+
|
|
132
|
+
```html
|
|
133
|
+
<div class="magnetic-btn" id="magneticBtn">
|
|
134
|
+
<span>Get Started</span>
|
|
135
|
+
</div>
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
```js
|
|
139
|
+
const btn = document.getElementById("magneticBtn");
|
|
140
|
+
|
|
141
|
+
btn.addEventListener("mousemove", (e) => {
|
|
142
|
+
const rect = btn.getBoundingClientRect();
|
|
143
|
+
const x = e.clientX - rect.left - rect.width / 2;
|
|
144
|
+
const y = e.clientY - rect.top - rect.height / 2;
|
|
145
|
+
const strength = 0.35;
|
|
146
|
+
|
|
147
|
+
gsap.to(btn, {
|
|
148
|
+
x: x * strength,
|
|
149
|
+
y: y * strength,
|
|
150
|
+
duration: 0.3,
|
|
151
|
+
ease: "power2.out"
|
|
152
|
+
});
|
|
153
|
+
});
|
|
154
|
+
|
|
155
|
+
btn.addEventListener("mouseleave", () => {
|
|
156
|
+
gsap.to(btn, { x: 0, y: 0, duration: 0.5, ease: "elastic.out(1, 0.4)" });
|
|
157
|
+
});
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
**Cursor aura (glow that follows mouse globally):**
|
|
161
|
+
```html
|
|
162
|
+
<div class="cursor-aura" id="cursorAura"></div>
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
```css
|
|
166
|
+
.cursor-aura {
|
|
167
|
+
position: fixed;
|
|
168
|
+
width: 300px;
|
|
169
|
+
height: 300px;
|
|
170
|
+
border-radius: 50%;
|
|
171
|
+
background: radial-gradient(circle, rgba(99,102,241,0.12) 0%, transparent 70%);
|
|
172
|
+
pointer-events: none;
|
|
173
|
+
transform: translate(-50%, -50%);
|
|
174
|
+
z-index: 0;
|
|
175
|
+
transition: opacity 0.3s;
|
|
176
|
+
}
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
```js
|
|
180
|
+
document.addEventListener("mousemove", (e) => {
|
|
181
|
+
gsap.to("#cursorAura", {
|
|
182
|
+
x: e.clientX,
|
|
183
|
+
y: e.clientY,
|
|
184
|
+
duration: 0.6,
|
|
185
|
+
ease: "power2.out"
|
|
186
|
+
});
|
|
187
|
+
});
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
### 2.4 Scroll-reveal stagger (IntersectionObserver)
|
|
191
|
+
|
|
192
|
+
Elements fade in as they enter the viewport — staggered per group.
|
|
193
|
+
|
|
194
|
+
```html
|
|
195
|
+
<div class="reveal-group">
|
|
196
|
+
<div class="reveal-item">...</div>
|
|
197
|
+
<div class="reveal-item">...</div>
|
|
198
|
+
<div class="reveal-item">...</div>
|
|
199
|
+
</div>
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
```css
|
|
203
|
+
.reveal-item {
|
|
204
|
+
opacity: 0;
|
|
205
|
+
transform: translateY(32px);
|
|
206
|
+
transition: opacity 0.6s cubic-bezier(0.16, 1, 0.3, 1),
|
|
207
|
+
transform 0.6s cubic-bezier(0.16, 1, 0.3, 1);
|
|
208
|
+
}
|
|
209
|
+
.reveal-item.visible {
|
|
210
|
+
opacity: 1;
|
|
211
|
+
transform: translateY(0);
|
|
212
|
+
}
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
```js
|
|
216
|
+
const observer = new IntersectionObserver((entries) => {
|
|
217
|
+
entries.forEach((entry, i) => {
|
|
218
|
+
if (entry.isIntersecting) {
|
|
219
|
+
setTimeout(() => entry.target.classList.add("visible"), i * 80);
|
|
220
|
+
observer.unobserve(entry.target);
|
|
221
|
+
}
|
|
222
|
+
});
|
|
223
|
+
}, { threshold: 0.15 });
|
|
224
|
+
|
|
225
|
+
document.querySelectorAll(".reveal-item").forEach(el => observer.observe(el));
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
### 2.5 Number counter animation (AnimeJS)
|
|
229
|
+
|
|
230
|
+
Stats and metrics that count up when scrolled into view.
|
|
231
|
+
|
|
232
|
+
```html
|
|
233
|
+
<span class="counter" data-target="200">0</span>
|
|
234
|
+
```
|
|
235
|
+
|
|
236
|
+
```js
|
|
237
|
+
const counterObserver = new IntersectionObserver((entries) => {
|
|
238
|
+
entries.forEach(entry => {
|
|
239
|
+
if (!entry.isIntersecting) return;
|
|
240
|
+
const el = entry.target;
|
|
241
|
+
const target = +el.dataset.target;
|
|
242
|
+
anime({
|
|
243
|
+
targets: el,
|
|
244
|
+
innerHTML: [0, target],
|
|
245
|
+
round: 1,
|
|
246
|
+
duration: 1800,
|
|
247
|
+
easing: "easeOutExpo",
|
|
248
|
+
update: () => { el.innerHTML = Math.round(el.innerHTML); }
|
|
249
|
+
});
|
|
250
|
+
counterObserver.unobserve(el);
|
|
251
|
+
});
|
|
252
|
+
}, { threshold: 0.5 });
|
|
253
|
+
|
|
254
|
+
document.querySelectorAll(".counter").forEach(el => counterObserver.observe(el));
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
### 2.6 Hero entrance sequence
|
|
258
|
+
|
|
259
|
+
Staggered load sequence for above-the-fold hero sections.
|
|
260
|
+
|
|
261
|
+
```js
|
|
262
|
+
// GSAP timeline — fires on page load
|
|
263
|
+
const heroTL = gsap.timeline({ defaults: { ease: "power3.out" } });
|
|
264
|
+
|
|
265
|
+
heroTL
|
|
266
|
+
.from(".hero-eyebrow", { y: 20, opacity: 0, duration: 0.6 })
|
|
267
|
+
.from(".hero-heading", { y: 30, opacity: 0, duration: 0.8 }, "-=0.3")
|
|
268
|
+
.from(".hero-sub", { y: 20, opacity: 0, duration: 0.6 }, "-=0.4")
|
|
269
|
+
.from(".hero-cta", { y: 20, opacity: 0, duration: 0.5, stagger: 0.1 }, "-=0.3")
|
|
270
|
+
.from(".hero-media", { scale: 0.96, opacity: 0, duration: 0.8 }, "-=0.5");
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
---
|
|
274
|
+
|
|
275
|
+
## 3. Performance checklist (< 2.5 s load target)
|
|
276
|
+
|
|
277
|
+
### Images
|
|
278
|
+
- [ ] Use WebP format for all photography and illustrations
|
|
279
|
+
- [ ] Set `loading="lazy"` on all images below the fold
|
|
280
|
+
- [ ] Preload hero/above-the-fold image: `<link rel="preload" as="image" href="hero.webp">`
|
|
281
|
+
- [ ] Specify `width` and `height` on every `<img>` to prevent layout shift
|
|
282
|
+
- [ ] Use `srcset` for responsive image sizes
|
|
283
|
+
|
|
284
|
+
### Fonts
|
|
285
|
+
- [ ] Self-host or use `font-display: swap`
|
|
286
|
+
- [ ] Preconnect to font CDN: `<link rel="preconnect" href="https://fonts.googleapis.com">`
|
|
287
|
+
- [ ] Preload critical font file: `<link rel="preload" as="font" type="font/woff2" crossorigin>`
|
|
288
|
+
- [ ] Load only the weights actually used (400, 500, 600 typically sufficient)
|
|
289
|
+
|
|
290
|
+
### CSS / JS
|
|
291
|
+
- [ ] No unused CSS (purge TailwindCSS or use inline critical CSS)
|
|
292
|
+
- [ ] Defer non-critical JS: `<script defer src="..."></script>`
|
|
293
|
+
- [ ] Load animation libraries only after hero is painted (use `defer` or dynamic import)
|
|
294
|
+
- [ ] Minify all assets before deploy
|
|
295
|
+
|
|
296
|
+
### Animation performance
|
|
297
|
+
- [ ] Use `transform` and `opacity` only — never animate `width`, `height`, `top`, `left`
|
|
298
|
+
- [ ] Add `will-change: transform` to elements with heavy animation (sparingly)
|
|
299
|
+
- [ ] Respect `prefers-reduced-motion`:
|
|
300
|
+
```css
|
|
301
|
+
@media (prefers-reduced-motion: reduce) {
|
|
302
|
+
*, *::before, *::after {
|
|
303
|
+
animation-duration: 0.01ms !important;
|
|
304
|
+
transition-duration: 0.01ms !important;
|
|
305
|
+
}
|
|
306
|
+
}
|
|
307
|
+
```
|
|
308
|
+
|
|
309
|
+
### Validation targets
|
|
310
|
+
- PageSpeed Insights score: ≥ 90 mobile, ≥ 95 desktop
|
|
311
|
+
- LCP (Largest Contentful Paint): < 2.5 s
|
|
312
|
+
- CLS (Cumulative Layout Shift): < 0.1
|
|
313
|
+
- FID/INP: < 200 ms
|
|
314
|
+
|
|
315
|
+
---
|
|
316
|
+
|
|
317
|
+
## 4. SEO / LLMO setup
|
|
318
|
+
|
|
319
|
+
### HTML head — minimum viable
|
|
320
|
+
|
|
321
|
+
```html
|
|
322
|
+
<meta charset="UTF-8">
|
|
323
|
+
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
324
|
+
<title>Primary Keyword — Brand Name</title>
|
|
325
|
+
<meta name="description" content="150–160 character description with primary keyword.">
|
|
326
|
+
<link rel="canonical" href="https://yourdomain.com/page-slug">
|
|
327
|
+
|
|
328
|
+
<!-- Open Graph -->
|
|
329
|
+
<meta property="og:title" content="Page Title">
|
|
330
|
+
<meta property="og:description" content="Description">
|
|
331
|
+
<meta property="og:image" content="https://yourdomain.com/og-image.jpg"> <!-- 1200×630 -->
|
|
332
|
+
<meta property="og:url" content="https://yourdomain.com/page-slug">
|
|
333
|
+
<meta property="og:type" content="website">
|
|
334
|
+
|
|
335
|
+
<!-- Twitter Card -->
|
|
336
|
+
<meta name="twitter:card" content="summary_large_image">
|
|
337
|
+
<meta name="twitter:title" content="Page Title">
|
|
338
|
+
<meta name="twitter:description" content="Description">
|
|
339
|
+
<meta name="twitter:image" content="https://yourdomain.com/og-image.jpg">
|
|
340
|
+
```
|
|
341
|
+
|
|
342
|
+
### H-tag hierarchy (one page = one H1)
|
|
343
|
+
|
|
344
|
+
```
|
|
345
|
+
H1 — Primary keyword, page purpose (ONE per page)
|
|
346
|
+
H2 — Major sections
|
|
347
|
+
H3 — Sub-topics within sections
|
|
348
|
+
```
|
|
349
|
+
|
|
350
|
+
### JSON-LD schema (place before `</body>`)
|
|
351
|
+
|
|
352
|
+
```html
|
|
353
|
+
<script type="application/ld+json">
|
|
354
|
+
{
|
|
355
|
+
"@context": "https://schema.org",
|
|
356
|
+
"@type": "WebPage",
|
|
357
|
+
"name": "Page Title",
|
|
358
|
+
"description": "Page description",
|
|
359
|
+
"url": "https://yourdomain.com/page-slug",
|
|
360
|
+
"publisher": {
|
|
361
|
+
"@type": "Organization",
|
|
362
|
+
"name": "Brand Name",
|
|
363
|
+
"url": "https://yourdomain.com"
|
|
364
|
+
}
|
|
365
|
+
}
|
|
366
|
+
</script>
|
|
367
|
+
```
|
|
368
|
+
|
|
369
|
+
For events:
|
|
370
|
+
```json
|
|
371
|
+
{
|
|
372
|
+
"@type": "Event",
|
|
373
|
+
"name": "Event Name",
|
|
374
|
+
"startDate": "2025-05-10T19:00",
|
|
375
|
+
"location": { "@type": "Place", "name": "Venue" },
|
|
376
|
+
"offers": { "@type": "Offer", "price": "997", "priceCurrency": "BRL" }
|
|
377
|
+
}
|
|
378
|
+
```
|
|
379
|
+
|
|
380
|
+
### Sitemap and robots
|
|
381
|
+
|
|
382
|
+
**`/sitemap.xml`:**
|
|
383
|
+
```xml
|
|
384
|
+
<?xml version="1.0" encoding="UTF-8"?>
|
|
385
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
|
|
386
|
+
<url>
|
|
387
|
+
<loc>https://yourdomain.com/</loc>
|
|
388
|
+
<lastmod>2025-04-01</lastmod>
|
|
389
|
+
<priority>1.0</priority>
|
|
390
|
+
</url>
|
|
391
|
+
</urlset>
|
|
392
|
+
```
|
|
393
|
+
|
|
394
|
+
**`/robots.txt`:**
|
|
395
|
+
```
|
|
396
|
+
User-agent: *
|
|
397
|
+
Allow: /
|
|
398
|
+
Sitemap: https://yourdomain.com/sitemap.xml
|
|
399
|
+
```
|
|
400
|
+
|
|
401
|
+
**`/llms.txt`** (LLMO — AI discoverability):
|
|
402
|
+
```markdown
|
|
403
|
+
# Brand Name
|
|
404
|
+
|
|
405
|
+
> One-line description of what this site/product is.
|
|
406
|
+
|
|
407
|
+
## What we offer
|
|
408
|
+
- Feature or service 1
|
|
409
|
+
- Feature or service 2
|
|
410
|
+
|
|
411
|
+
## Contact
|
|
412
|
+
- Site: https://yourdomain.com
|
|
413
|
+
- Email: contact@yourdomain.com
|
|
414
|
+
```
|
|
415
|
+
|
|
416
|
+
---
|
|
417
|
+
|
|
418
|
+
## 5. Tracking integration
|
|
419
|
+
|
|
420
|
+
### Meta Pixel + Advanced Matching
|
|
421
|
+
|
|
422
|
+
Place in `<head>`, replace `PIXEL_ID`:
|
|
423
|
+
|
|
424
|
+
```html
|
|
425
|
+
<script>
|
|
426
|
+
!function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){n.callMethod?
|
|
427
|
+
n.callMethod.apply(n,arguments):n.queue.push(arguments)};if(!f._fbq)f._fbq=n;
|
|
428
|
+
n.push=n;n.loaded=!0;n.version='2.0';n.queue=[];t=b.createElement(e);t.async=!0;
|
|
429
|
+
t.src=v;s=b.getElementsByTagName(e)[0];s.parentNode.insertBefore(t,s)}(window,
|
|
430
|
+
document,'script','https://connect.facebook.net/en_US/fbevents.js');
|
|
431
|
+
|
|
432
|
+
fbq('init', 'PIXEL_ID', {
|
|
433
|
+
em: '<hashed_email_if_known>' // Advanced Matching — pass SHA256 hashed email
|
|
434
|
+
});
|
|
435
|
+
fbq('track', 'PageView');
|
|
436
|
+
</script>
|
|
437
|
+
<noscript>
|
|
438
|
+
<img height="1" width="1" style="display:none"
|
|
439
|
+
src="https://www.facebook.com/tr?id=PIXEL_ID&ev=PageView&noscript=1"/>
|
|
440
|
+
</noscript>
|
|
441
|
+
```
|
|
442
|
+
|
|
443
|
+
**Standard events to fire on key actions:**
|
|
444
|
+
```js
|
|
445
|
+
// Lead capture form submit
|
|
446
|
+
fbq('track', 'Lead', { content_name: 'Newsletter Signup' });
|
|
447
|
+
|
|
448
|
+
// Checkout / purchase intent
|
|
449
|
+
fbq('track', 'InitiateCheckout', { value: 997, currency: 'BRL' });
|
|
450
|
+
|
|
451
|
+
// Purchase confirmed
|
|
452
|
+
fbq('track', 'Purchase', { value: 997, currency: 'BRL' });
|
|
453
|
+
```
|
|
454
|
+
|
|
455
|
+
### Google Tag Manager
|
|
456
|
+
|
|
457
|
+
```html
|
|
458
|
+
<!-- In <head> -->
|
|
459
|
+
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
|
|
460
|
+
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
|
|
461
|
+
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
|
|
462
|
+
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
|
|
463
|
+
})(window,document,'script','dataLayer','GTM-XXXXXXX');</script>
|
|
464
|
+
|
|
465
|
+
<!-- Immediately after <body> -->
|
|
466
|
+
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXXX"
|
|
467
|
+
height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
|
|
468
|
+
```
|
|
469
|
+
|
|
470
|
+
### UTM capture and persistence
|
|
471
|
+
|
|
472
|
+
Captures UTM parameters on landing and persists them through the session for downstream form submissions.
|
|
473
|
+
|
|
474
|
+
```js
|
|
475
|
+
(function() {
|
|
476
|
+
const params = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'];
|
|
477
|
+
const url = new URL(window.location.href);
|
|
478
|
+
|
|
479
|
+
params.forEach(param => {
|
|
480
|
+
const value = url.searchParams.get(param);
|
|
481
|
+
if (value) {
|
|
482
|
+
sessionStorage.setItem(param, value);
|
|
483
|
+
// Also set cookie for cross-page persistence
|
|
484
|
+
document.cookie = `${param}=${encodeURIComponent(value)};path=/;max-age=1800`;
|
|
485
|
+
}
|
|
486
|
+
});
|
|
487
|
+
|
|
488
|
+
// Attach UTMs to all form submissions
|
|
489
|
+
document.querySelectorAll('form').forEach(form => {
|
|
490
|
+
form.addEventListener('submit', () => {
|
|
491
|
+
params.forEach(param => {
|
|
492
|
+
const value = sessionStorage.getItem(param);
|
|
493
|
+
if (value) {
|
|
494
|
+
const input = document.createElement('input');
|
|
495
|
+
input.type = 'hidden';
|
|
496
|
+
input.name = param;
|
|
497
|
+
input.value = value;
|
|
498
|
+
form.appendChild(input);
|
|
499
|
+
}
|
|
500
|
+
});
|
|
501
|
+
});
|
|
502
|
+
});
|
|
503
|
+
})();
|
|
504
|
+
```
|
|
505
|
+
|
|
506
|
+
---
|
|
507
|
+
|
|
508
|
+
## 6. Mobile-first responsive rules for landing pages
|
|
509
|
+
|
|
510
|
+
```css
|
|
511
|
+
/* Base: mobile (< 640px) */
|
|
512
|
+
.hero-heading { font-size: clamp(2rem, 8vw, 4.5rem); }
|
|
513
|
+
.section-padding { padding: 64px 24px; }
|
|
514
|
+
.grid-cols { grid-template-columns: 1fr; }
|
|
515
|
+
|
|
516
|
+
/* Tablet (≥ 768px) */
|
|
517
|
+
@media (min-width: 768px) {
|
|
518
|
+
.section-padding { padding: 96px 48px; }
|
|
519
|
+
.grid-cols { grid-template-columns: repeat(2, 1fr); }
|
|
520
|
+
}
|
|
521
|
+
|
|
522
|
+
/* Desktop (≥ 1024px) */
|
|
523
|
+
@media (min-width: 1024px) {
|
|
524
|
+
.section-padding { padding: 128px 80px; }
|
|
525
|
+
.grid-cols { grid-template-columns: repeat(3, 1fr); }
|
|
526
|
+
}
|
|
527
|
+
```
|
|
528
|
+
|
|
529
|
+
**Key landing page responsive rules:**
|
|
530
|
+
- CTA buttons: minimum 48px height on mobile, full-width on < 480px
|
|
531
|
+
- Horizontal scroll sections: disable on mobile, show vertical stack instead
|
|
532
|
+
- Magnetic mouse effects: disable on touch devices (`@media (hover: none)`)
|
|
533
|
+
- Font size: use `clamp()` for fluid scaling between breakpoints
|
|
534
|
+
- Hero text: max 2 lines on mobile — truncate copy if needed
|
|
535
|
+
|
|
536
|
+
```js
|
|
537
|
+
// Disable magnetic effects on touch
|
|
538
|
+
const isTouchDevice = () => window.matchMedia("(hover: none)").matches;
|
|
539
|
+
if (!isTouchDevice()) {
|
|
540
|
+
// init magnetic effects
|
|
541
|
+
}
|
|
542
|
+
```
|
|
543
|
+
|
|
544
|
+
---
|
|
545
|
+
|
|
546
|
+
## 7. Pre-launch validation checklist
|
|
547
|
+
|
|
548
|
+
### Visual
|
|
549
|
+
- [ ] Renders correctly on iPhone SE (375px), iPhone 14 (390px), iPad (768px), Desktop (1280px)
|
|
550
|
+
- [ ] All CTAs visible above fold on mobile
|
|
551
|
+
- [ ] No horizontal overflow on any breakpoint
|
|
552
|
+
- [ ] All images have `alt` text
|
|
553
|
+
|
|
554
|
+
### Functional
|
|
555
|
+
- [ ] All CTA buttons and links work
|
|
556
|
+
- [ ] Form submits correctly and shows success/error state
|
|
557
|
+
- [ ] No console errors in Chrome, Firefox, Safari
|
|
558
|
+
|
|
559
|
+
### Performance
|
|
560
|
+
- [ ] PageSpeed score ≥ 90 mobile
|
|
561
|
+
- [ ] LCP < 2.5 s on mobile (test on throttled 3G in DevTools)
|
|
562
|
+
|
|
563
|
+
### Tracking
|
|
564
|
+
- [ ] Meta Pixel fires PageView on load (verify in Meta Pixel Helper)
|
|
565
|
+
- [ ] GTM fires on load (verify in Tag Assistant)
|
|
566
|
+
- [ ] UTM params captured in sessionStorage when visiting with `?utm_source=test`
|
|
567
|
+
- [ ] Lead event fires on form submit
|
|
568
|
+
|
|
569
|
+
### SEO / LLMO
|
|
570
|
+
- [ ] Single H1 present
|
|
571
|
+
- [ ] Meta description populated
|
|
572
|
+
- [ ] Canonical URL correct
|
|
573
|
+
- [ ] OG image renders correctly (test at opengraph.xyz)
|
|
574
|
+
- [ ] /robots.txt accessible
|
|
575
|
+
- [ ] /sitemap.xml accessible and valid
|
|
576
|
+
- [ ] /llms.txt present
|
|
577
|
+
|
|
578
|
+
### SSL and deploy
|
|
579
|
+
- [ ] HTTPS certificate active (no mixed content warnings)
|
|
580
|
+
- [ ] Domain resolves correctly on all subdomains being used
|
|
581
|
+
- [ ] Redirects from www/non-www consistent
|
|
582
|
+
|
|
583
|
+
---
|
|
584
|
+
|
|
585
|
+
## 8. Tech stack recommendations
|
|
586
|
+
|
|
587
|
+
| Need | Recommended |
|
|
588
|
+
|---|---|
|
|
589
|
+
| Static HTML/CSS/JS page | Plain HTML + Vite for bundling |
|
|
590
|
+
| React-based | Next.js (Static Export for max speed) |
|
|
591
|
+
| Animation library | GSAP (complex) or AnimeJS (lightweight) |
|
|
592
|
+
| Image generation | Google Imagen via API, or Flux |
|
|
593
|
+
| Hosting (BRL-friendly) | Hostinger VPS (LiteSpeed) |
|
|
594
|
+
| Hosting (automated deploy) | Vercel (Git-connected, CDN edge) |
|
|
595
|
+
| DNS / CDN | Cloudflare (free tier covers most pages) |
|
|
596
|
+
| Form backend | Formspree, Basin, or native webhook to CRM |
|
|
597
|
+
|
|
598
|
+
---
|
|
599
|
+
|
|
600
|
+
## 9. Production execution pattern — 3 parallel tracks
|
|
601
|
+
|
|
602
|
+
The most common failure in AI-generated landing pages: the page looks good but doesn't have tracking, doesn't have SEO, and fails PageSpeed. These three tracks must run **simultaneously** during implementation — not as an afterthought checklist.
|
|
603
|
+
|
|
604
|
+
### How to execute in parallel
|
|
605
|
+
|
|
606
|
+
When building a page, structure the implementation in two phases:
|
|
607
|
+
|
|
608
|
+
**Phase 1 — Structure & visual** (sequential prerequisite)
|
|
609
|
+
Build the HTML structure, CSS design system, content sections, and animations. Get the page looking correct on desktop and mobile.
|
|
610
|
+
|
|
611
|
+
**Phase 2 — Production readiness** (3 tracks in parallel)
|
|
612
|
+
Once Phase 1 is complete, execute all three tracks before considering the page done:
|
|
613
|
+
|
|
614
|
+
```
|
|
615
|
+
Phase 2 — run all three simultaneously:
|
|
616
|
+
|
|
617
|
+
┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
|
|
618
|
+
│ Track A: SEO/LLMO │ │ Track B: Tracking │ │ Track C: Performance│
|
|
619
|
+
├─────────────────────┤ ├─────────────────────┤ ├─────────────────────┤
|
|
620
|
+
│ • Single H1 │ │ • Meta Pixel init │ │ • Images → WebP │
|
|
621
|
+
│ • Meta description │ │ • PageView event │ │ • lazy loading │
|
|
622
|
+
│ • Canonical URL │ │ • Lead event (form) │ │ • Hero preload │
|
|
623
|
+
│ • OG tags │ │ • GTM container │ │ • Defer JS │
|
|
624
|
+
│ • JSON-LD schema │ │ • UTM capture │ │ • Remove unused CSS │
|
|
625
|
+
│ • /robots.txt │ │ • UTM → form inject │ │ • will-change │
|
|
626
|
+
│ • /sitemap.xml │ │ • Cookie consent │ │ • prefers-reduced- │
|
|
627
|
+
│ • /llms.txt │ │ (LGPD if BR) │ │ motion fallback │
|
|
628
|
+
└─────────────────────┘ └─────────────────────┘ └─────────────────────┘
|
|
629
|
+
↓ ↓ ↓
|
|
630
|
+
└─────────────────────────┴─────────────────────────┘
|
|
631
|
+
↓
|
|
632
|
+
Phase 3 — Validation (sequential)
|
|
633
|
+
• PageSpeed ≥ 90 mobile
|
|
634
|
+
• Cross-browser check
|
|
635
|
+
• CTAs and forms functional
|
|
636
|
+
• Pixel fires on load (Pixel Helper)
|
|
637
|
+
• Deploy
|
|
638
|
+
```
|
|
639
|
+
|
|
640
|
+
### Track A delivery checklist
|
|
641
|
+
```html
|
|
642
|
+
<!-- SEO/LLMO minimum — all in <head> -->
|
|
643
|
+
<title>Primary Keyword — Brand Name</title>
|
|
644
|
+
<meta name="description" content="150–160 chars">
|
|
645
|
+
<link rel="canonical" href="https://yourdomain.com/page">
|
|
646
|
+
<meta property="og:title" content="...">
|
|
647
|
+
<meta property="og:description" content="...">
|
|
648
|
+
<meta property="og:image" content="..."> <!-- 1200×630 -->
|
|
649
|
+
<meta property="og:url" content="...">
|
|
650
|
+
```
|
|
651
|
+
```
|
|
652
|
+
# /robots.txt
|
|
653
|
+
User-agent: *
|
|
654
|
+
Allow: /
|
|
655
|
+
Sitemap: https://yourdomain.com/sitemap.xml
|
|
656
|
+
```
|
|
657
|
+
```markdown
|
|
658
|
+
# /llms.txt — brand summary for AI discoverability
|
|
659
|
+
# [Brand Name]
|
|
660
|
+
> [One-line description]
|
|
661
|
+
## Products/Services
|
|
662
|
+
- [item]
|
|
663
|
+
## Contact
|
|
664
|
+
- [url]
|
|
665
|
+
```
|
|
666
|
+
|
|
667
|
+
### Track B delivery checklist
|
|
668
|
+
```html
|
|
669
|
+
<!-- Pixel in <head> — replace PIXEL_ID -->
|
|
670
|
+
<script>
|
|
671
|
+
!function(f,b,e,v,n,t,s){...}(window,document,'script',
|
|
672
|
+
'https://connect.facebook.net/en_US/fbevents.js');
|
|
673
|
+
fbq('init', 'PIXEL_ID');
|
|
674
|
+
fbq('track', 'PageView');
|
|
675
|
+
</script>
|
|
676
|
+
|
|
677
|
+
<!-- GTM in <head> — replace GTM-XXXXXXX -->
|
|
678
|
+
<script>(function(w,d,s,l,i){...})(window,document,'script','dataLayer','GTM-XXXXXXX');</script>
|
|
679
|
+
|
|
680
|
+
<!-- UTM capture — in <body> before </body> -->
|
|
681
|
+
<script>
|
|
682
|
+
(function() {
|
|
683
|
+
const params = ['utm_source','utm_medium','utm_campaign','utm_term','utm_content'];
|
|
684
|
+
const url = new URL(window.location.href);
|
|
685
|
+
params.forEach(p => {
|
|
686
|
+
const v = url.searchParams.get(p);
|
|
687
|
+
if (v) { sessionStorage.setItem(p, v); document.cookie = `${p}=${encodeURIComponent(v)};path=/;max-age=1800`; }
|
|
688
|
+
});
|
|
689
|
+
document.querySelectorAll('form').forEach(form => {
|
|
690
|
+
form.addEventListener('submit', () => {
|
|
691
|
+
params.forEach(p => {
|
|
692
|
+
const v = sessionStorage.getItem(p);
|
|
693
|
+
if (v) { const i = document.createElement('input'); i.type='hidden'; i.name=p; i.value=v; form.appendChild(i); }
|
|
694
|
+
});
|
|
695
|
+
});
|
|
696
|
+
});
|
|
697
|
+
})();
|
|
698
|
+
</script>
|
|
699
|
+
```
|
|
700
|
+
|
|
701
|
+
### Track C delivery checklist
|
|
702
|
+
```html
|
|
703
|
+
<!-- Hero image preload — always first in <head> -->
|
|
704
|
+
<link rel="preload" as="image" href="hero.webp">
|
|
705
|
+
|
|
706
|
+
<!-- Font preconnect -->
|
|
707
|
+
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
708
|
+
<link rel="preload" as="font" type="font/woff2" href="/fonts/inter.woff2" crossorigin>
|
|
709
|
+
|
|
710
|
+
<!-- Animation libraries — defer so they don't block render -->
|
|
711
|
+
<script defer src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js"></script>
|
|
712
|
+
```
|
|
713
|
+
```css
|
|
714
|
+
/* Reduced motion fallback — always present */
|
|
715
|
+
@media (prefers-reduced-motion: reduce) {
|
|
716
|
+
*, *::before, *::after {
|
|
717
|
+
animation-duration: 0.01ms !important;
|
|
718
|
+
transition-duration: 0.01ms !important;
|
|
719
|
+
}
|
|
720
|
+
}
|
|
721
|
+
/* will-change only on actively animated elements */
|
|
722
|
+
.hero-bg { will-change: transform; }
|
|
723
|
+
```
|
|
724
|
+
|
|
725
|
+
### Why this matters (from production data)
|
|
726
|
+
Pages without tracking have no conversion data → impossible to optimize → wasted ad spend.
|
|
727
|
+
Pages without SEO/LLMO miss organic and AI-referred traffic → dead investment.
|
|
728
|
+
Pages loading in 3+ seconds lose 40%+ of mobile traffic before the first CTA is seen.
|
|
729
|
+
|
|
730
|
+
Running the three tracks in parallel (not as afterthought) means a page is truly production-ready when it launches, not just visually finished.
|