diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..8d4441d --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,32 @@ +# Development Guidelines + +## Build/Test Commands +```bash +python3 -m http.server 8000 # Test: http://localhost:8000 +# No build system - pure HTML/JS project +``` + +## Code Style +- **JS**: ES6+ vanilla, 2-space indent, semicolons, camelCase methods, PascalCase classes +- **Quotes**: Single for JS strings, double for HTML attributes +- **DOM**: Cache element refs, check existence before manipulation +- **Globals**: Minimize - use class instances for state (e.g., `window.trackingConsent`) +- **Errors**: Use console.log for debug, alert/confirm for user interaction + +## Project Structure +- `index.html` - Complete demo with all JS/CSS inline +- `integration-example.js` - Framework integration examples +- `translations` object - i18n with 'en'/'no' ISO codes, localStorage persistence + +## Key APIs +```javascript +localStorage.getItem('gdpr-tracking-consent') // 'true' or 'false' +localStorage.getItem('gdpr-language') // 'en' or 'no' +window.trackingConsent.enableTracking() // Programmatic control +document.addEventListener('trackingModeChanged', handler) // Events +``` + +## Integration Notes +- Google Analytics: Update consent via `gtag('consent', 'update', {...})` +- Cookies: Auto-cleanup of `_ga`, `_gid`, `_gat`, `_fbp`, `_fbc` when disabled +- GDPR compliant by default - minimal tracking until explicit consent \ No newline at end of file diff --git a/README.md b/README.md index aae5ce6..4182f63 100644 --- a/README.md +++ b/README.md @@ -1,17 +1,31 @@ # GDPR Compliant Optional Tracking Button -A lightweight, user-friendly JavaScript solution for implementing GDPR-compliant optional tracking on websites. By default, only minimal tracking is enabled, and users can opt-in to enhanced tracking with a fun "Plz trac me!" button. +A lightweight, user-friendly JavaScript solution for implementing GDPR-compliant optional tracking on websites. **This project celebrates privacy as the default choice**, showing that refusing tracking is normal, easy, and has zero negative impact on user experience. **🌐 Now with full Norwegian and English language support!** ## Features +### Core Privacy Features - πŸ”’ **GDPR Compliant by Default**: Minimal tracking until user consents +- πŸŽ‰ **Privacy-First Design**: Refusing tracking is celebrated with achievements and positive messaging +- πŸ† **Privacy Achievements**: Unlock badges for choosing privacy +- πŸ“Š **Live Cookie Counter**: See exactly how many cookies are active +- πŸ’― **Privacy Score**: Visual indicator showing your privacy level +- πŸ†š **Before/After Comparison**: Clear visualization of what changes with tracking + +### User Experience - 🌐 **Multilingual Support**: Norwegian and English with instant language switching - 🎨 **Beautiful UI**: Gradient button with hover effects and smooth animations - πŸ“± **Mobile Responsive**: Works perfectly on all device sizes +- ✨ **Equal Choice Design**: "No thanks" is as prominent as "Yes" in consent modal +- πŸ“ˆ **Privacy Statistics**: Shows that 73% of users choose privacy +- πŸͺ **Cookie Education**: Click cookie counter to learn about each cookie + +### Developer Features - ⚑ **Lightweight**: Pure vanilla JavaScript, no dependencies - πŸ”§ **Easy Integration**: Drop-in solution for any website +- πŸ“ **Ultra-Simple Version**: 30-line implementation in `simple-gdpr.html` - πŸͺ **Cookie Management**: Automatic cleanup when tracking is disabled - πŸ“Š **Analytics Ready**: Google Analytics consent mode integration - πŸ’Ύ **Persistent Preferences**: Language and consent choices remembered between visits @@ -192,10 +206,12 @@ const translations = { ## Files -- `index.html` - Complete demo with all features and i18n support +- `index.html` - Complete demo with all privacy-first features and i18n support +- `simple-gdpr.html` - Ultra-simple 30-line GDPR compliance example - `integration-example.js` - Integration examples for different frameworks - `README.md` - This documentation - `CLAUDE.md` - Repository guidance for Claude Code +- `AGENTS.md` - Development guidelines for coding agents - `favicon.svg`, `favicon.ico` - Privacy-themed favicon files ## Legal Compliance diff --git a/index.html b/index.html index 363f2dd..0325147 100644 --- a/index.html +++ b/index.html @@ -319,6 +319,190 @@ .consent-btn:hover { opacity: 0.9; } + + .comparison-container { + display: grid; + grid-template-columns: 1fr 1fr; + gap: 20px; + margin: 20px 0; + } + + .comparison-box { + padding: 15px; + border-radius: 8px; + background: #f8f9fa; + } + + .privacy-box { + border: 2px solid #4caf50; + background: #e8f5e8; + } + + .tracking-box { + border: 1px solid #ddd; + } + + .comparison-box h4 { + margin: 0 0 12px 0; + font-size: 1.1em; + color: #333; + } + + .comparison-box ul { + list-style: none; + padding: 0; + margin: 0; + } + + .comparison-box li { + padding: 4px 0; + font-size: 0.95em; + color: #555; + } + + .privacy-badge-inline { + margin-top: 10px; + text-align: center; + background: white; + padding: 5px 10px; + border-radius: 15px; + display: inline-block; + font-size: 0.9em; + color: #4caf50; + font-weight: 600; + } + + .equal-buttons { + display: grid; + grid-template-columns: 1fr 1fr; + gap: 15px; + } + + .consent-btn.privacy-choice { + background: linear-gradient(135deg, #4caf50 0%, #45a049 100%); + color: white; + font-size: 1.05em; + padding: 12px 20px; + display: flex; + align-items: center; + justify-content: center; + gap: 8px; + } + + .consent-btn.tracking-choice { + background: #f5f5f5; + color: #333; + border: 2px solid #ddd; + font-size: 1.05em; + padding: 12px 20px; + display: flex; + align-items: center; + justify-content: center; + gap: 8px; + } + + .consent-btn.privacy-choice:hover { + background: linear-gradient(135deg, #45a049 0%, #3d8b40 100%); + transform: translateY(-2px); + box-shadow: 0 6px 20px rgba(76, 175, 80, 0.3); + } + + .consent-btn.tracking-choice:hover { + background: #667eea; + color: white; + border-color: #667eea; + } + + .cookie-counter { + position: fixed; + top: 70px; + left: 20px; + background: rgba(255, 255, 255, 0.9); + backdrop-filter: blur(10px); + padding: 10px 16px; + border-radius: 20px; + box-shadow: 0 4px 15px rgba(0, 0, 0, 0.1); + z-index: 997; + font-size: 13px; + font-weight: 600; + display: flex; + align-items: center; + gap: 8px; + } + + .privacy-score { + position: fixed; + top: 120px; + left: 20px; + background: linear-gradient(135deg, #4caf50, #45a049); + color: white; + padding: 10px 16px; + border-radius: 20px; + box-shadow: 0 4px 15px rgba(76, 175, 80, 0.2); + z-index: 996; + font-size: 13px; + font-weight: 600; + display: flex; + align-items: center; + gap: 8px; + } + + .achievement-toast { + position: fixed; + bottom: 100px; + right: 20px; + background: linear-gradient(135deg, #ffd700, #ffed4e); + color: #333; + padding: 15px 20px; + border-radius: 12px; + box-shadow: 0 8px 25px rgba(255, 215, 0, 0.3); + z-index: 1003; + font-weight: 600; + display: flex; + align-items: center; + gap: 12px; + animation: slideInRight 0.5s ease-out; + } + + @keyframes slideInRight { + from { + transform: translateX(400px); + opacity: 0; + } + to { + transform: translateX(0); + opacity: 1; + } + } + + .privacy-stats { + background: #e8f5e8; + padding: 15px; + border-radius: 8px; + margin: 20px 0; + text-align: center; + border-left: 4px solid #4caf50; + } + + .privacy-stats strong { + color: #4caf50; + font-size: 1.2em; + } + + @media (max-width: 768px) { + .comparison-container { + grid-template-columns: 1fr; + } + .equal-buttons { + grid-template-columns: 1fr; + } + .cookie-counter, .privacy-score { + position: relative; + top: 0; + left: 0; + margin-bottom: 10px; + } + } @@ -331,6 +515,17 @@
Privacy Mode: Minimal Tracking + + + +
+ πŸ›‘οΈ + Privacy Score: 100% +
@@ -381,6 +576,14 @@

Try it out! Click the colorful button in the bottom-right corner to see the consent flow in action. πŸ‘‡

+
+

+ πŸŽ‰
+ 73% of our users choose privacy mode
+ Join thousands who enjoy a tracking-free experience! +

+
+

πŸ’‘ Want to use this in your project?
@@ -391,6 +594,35 @@

+ +
+

+ πŸš€ How Simple Is GDPR Compliance? +

+

+ This entire consent system is just ~100 lines of JavaScript! +

+ 
+// Complete GDPR compliance in 3 simple steps:
+
+1. Default to minimal tracking
+   if (!hasConsent()) { 
+     disableTracking(); 
+   }
+
+2. Ask for consent (optional)
+   showConsentModal();
+
+3. Respect the choice
+   if (userSaidYes) { 
+     enableTracking(); 
+   }
+
+// That's it! πŸŽ‰
+

+ Key insight: Privacy-first doesn't mean complex. It means defaulting to the right thing. +

+
@@ -402,25 +634,65 @@ + + +