Proposal and Mockup Style Guide

Version: 1.0 · Last updated: Aug 7, 2026 · Applies to: All proposal pages and all mockup pages

1. Versioning Convention

Version	Description	URL Pattern	Behavior
v1	Original submission — frozen, never edited	`proposals.iamgmb.com/slug`	Yellow "SUPERSEDED" banner. Footer links to v2 + verdict.
v2	Post-pipeline rewrite — incorporates review feedback	`proposals.iamgmb.com/slug` (rebranded if needed)	Active proposal. Footer links to v1 + verdict + itself (bolded).

Rules:

v1 is immutable after submission. Only add the superseded banner — never edit content.
v2 is created fresh after the pipeline runs. It is a full rewrite, not a diff.
The pipeline verdict lives at mockup.iamgmb.com/project/critical-review.html.

2. Footer Standard (NON-NEGOTIABLE)

<footer>
  <p><strong>PROJECT NAME</strong> — a product of IT Pro Partner</p>
  <p style="margin-top:0.5rem;">
    <a href="https://proposals.iamgmb.com/PROJECT-V1">Original Proposal (v1)</a> ·
    <a href="https://mockup.iamgmb.com/PROJECT/critical-review.html">Pipeline Verdict</a> ·
    <a href="https://proposals.iamgmb.com/PROJECT-V2" style="font-weight:700;">Post-Review Proposal (v2)</a> ·
    <a href="https://itpropartner.com">IT Pro Partner</a>
  </p>
</footer>

Hard Rules

v2 link is ALWAYS bolded (font-weight:700)
v1 link points to the frozen original
Pipeline Verdict link is ALWAYS present
IT Pro Partner link is ALWAYS last
NO "All Proposals" link — removed permanently
NO "Live Demo" or "Product Landing Page" links in footer
All five pages share this footer: v1, v2, landing mockup, critical review, logo exploration

VerdictTank Implementation Reference

Page	v1 link	Verdict link	v2 link	Bolded
proposals/sharktank	self	critical-review	verdicttank	v1
proposals/verdicttank	sharktank	critical-review	self	v2
mockup/index.html	sharktank	critical-review	verdicttank	v2
mockup/critical-review.html	sharktank	self	verdicttank	v2
mockup/logo-exploration.html	sharktank	critical-review	verdicttank	v2

3. Design Tokens

Colors

--accent: #dc2626;     /* crimson — primary brand */
--accent-hover: #b91c1c;
--accent-light: #fef2f2;
--bg: #ffffff;
--bg-dark: #0a0a0a;
--text: #171717;
--text-dark: #ededed;
--text2: #525252;
--text3: #737373;
--border: #e5e5e5;
--border-dark: #262626;
--red: #dc2626;       /* risk-high */
--amber: #d97706;     /* risk-med */
--green: #16a34a;     /* risk-low */

Typography

Font: 'Inter', -apple-system, sans-serif
Mono: 'JetBrains Mono', monospace
h1: 2rem  |  h2: 1.25rem  |  h3: 1rem  |  body: 0.95rem

Spacing and Borders

Section gap: 2rem  |  Card padding: 1.25-1.5rem
Border: 1px solid var(--border)  |  Radius: 10px (cards), 8px (buttons)

4. Page Structure Template

Proposals use this skeleton:

<!DOCTYPE html>
<html lang="en">
<head>...</head>
<body>
<div class="container">
  <header>...</header>
  <!-- Superseded banner (v1 ONLY) -->
  <section>...</section>
  <footer>... STANDARD FOOTER ...</footer>
</div>
</body>
</html>

5. Superseded Banner (v1 Pages Only)

<div class="superseded-banner">
  SUPERSEDED — This is the original proposal (v1).
  <a href="v2-url">Read the post-review proposal (v2)</a>
</div>

6. Theme Toggle (Mockups)

Mockups must support light and dark via data-theme on <html>. Persist preference to localStorage, fall back to system preference.

7. Forbidden

Item	Reason
Em dashes	Fuse adjacent text on Telegram
"All Proposals" in footer	Version links provide all navigation
"Live Demo" / "Product Landing Page" in footer	Not versioning — belongs in body
Shark emoji / "SharkTank" branding	Rebranded to VerdictTank
Model vendor names	Use functional roles only
API keys or credentials	Never in source
target="_blank" without rel="noopener"	Security baseline

8. New Project Checklist

Create v1 proposal at proposals.iamgmb.com/slug
Submit v1 through the VerdictTank pipeline
Save verdict as mockup.iamgmb.com/project/critical-review.html
Create v2 proposal incorporating all pipeline feedback
Add superseded banner to v1, linking to v2
Apply standard footer to v1, v2, and ALL mockup pages
Bold the "current" version link in each footer
Create landing mockup
Ensure light/dark theme toggle
Push all changes to Gitea
chmod 644 all web-facing files
Verify all five pages return 200