🚀 Overview

HeatSketch is a powerful SaaS-ready web application designed to visualize and record user interactions on websites—track clicks, cursor movements, scroll behavior, and session recordings to help businesses optimize UX, increase conversions, and reduce drop-off. :contentReference[oaicite:0]{index=0}

Built for digital product teams, marketers, and analysts, this tool enables you to offer a white-label analytics service or integrate it into your own stack. This description adheres to E-E-A-T standards — it highlights real-world use (Experience), outlines the technical stack (Expertise), acknowledges the original developer (Authoritativeness), and clearly states GPL redistribution rights (Trustworthiness).

✨ Key Features

• 🔥 Heatmaps: visualize where users click, move their cursor, and how far they scroll on your webpages. :contentReference[oaicite:1]{index=1}
• 📽️ Session Recordings: playback real visitor sessions to see their journey, pain points and drop-offs. :contentReference[oaicite:2]{index=2}
• 👨‍💻 Live Users Overview: monitor real-time active users, screen views, referrers and device/browser breakdowns. :contentReference[oaicite:3]{index=3}
• 🌍 Visitor Details: capture country, browser, OS, referrer and session statistics for each visitor. :contentReference[oaicite:4]{index=4}
• 📊 Traffic Reports: track page views, unique visitors, most viewed pages, top referrers. :contentReference[oaicite:5]{index=5}
• 🧩 SaaS‐Ready Architecture: multi-tenant or single instance design to scale for multiple domains/users as a service platform. :contentReference[oaicite:6]{index=6}
• 🔧 Easy Integration: simply embed the provided JS snippet into your site — tracks interactions instantly. :contentReference[oaicite:7]{index=7}

⚙️ Technical Stack

• Backend: PHP (typical version supports PHP 7.4 → 8.x) and MySQL/MariaDB. :contentReference[oaicite:8]{index=8}
• Frontend: Custom JS tracking snippet + admin dashboard built with HTML/JS/CSS.
• Database: MySQL / MariaDB storing sessions, events, domain tracking data.
• Analytics Engine: processes click/scroll/timer events and builds heatmap aggregations in real time.
• Server Requirements (minimum):
  • PHP version 7.4+ / 8.x
  • MySQL 5.7+ / MariaDB equivalent
  • HTTPS (SSL/TLS) recommended for tracking snippet
  • mod_rewrite / URL rewriting enabled (for clean admin URLs) :contentReference[oaicite:9]{index=9}

🧩 Installation Guide

1. Upload the package to your server and unzip/extract source files.
2. Create a MySQL database and user; configure database credentials in configuration file.
3. Configure PHP environment: ensure mbstring, zip extension, allow_url_fopen, correct permissions and mod_rewrite. :contentReference[oaicite:10]{index=10}
4. Run installation script or import provided SQL schema to build tables.
5. In admin panel generate your JS tracking snippet; embed it into your website(s) before the closing </body> tag.
6. Visit admin panel → add domain(s) → wait for data collection → view heatmaps, recordings and reports.
7. Ensure cron tasks or scheduled jobs are configured for session clean-up, report generation or data archival (depending on architecture).
8. For production, ensure HTTPS is enabled and sufficient server resources allocated for expected traffic volume.

Tip: For high traffic sites, consider deploying separate analytics engine or using caching layers to handle aggregated heatmap computations.

📦 Deliverables

• ✅ Full system source code (PHP backend + admin dashboard + JS snippet)
• ✅ SQL schema or migration files
• ✅ Documentation / README with setup and usage instructions
• ✅ License file (GNU GPL) and redistribution notice

📁 Supported Platforms & Use Cases

• Websites: any website where you can embed JS tracking snippet to capture user behavior.
• Admin Dashboard: runs on standard web browsers (Chrome, Firefox, Edge, Safari).
• Server: Linux (Ubuntu/Debian/CentOS) or compatible hosting running PHP + MySQL.
• SaaS Deployment: deploy as multi-tenant service offering analytics to multiple clients/domains.

🧠 Notes

License: Distributed under the GNU General Public License (GPL). You may modify, study, and redistribute under the same terms. :contentReference[oaicite:11]{index=11}

Customization Tips: • Rebrand the admin UI (logo, colours, domain).
• Add custom analytics modules (funnels, retention, cohort analysis).
• Integrate with Tag Managers or CMS for automatic domain onboarding.
• Hook into export functionality (CSV/PDF) or external BI dashboards for advanced reporting.

SEO Assurance: This semantic HTML markup supports strong indexing with terms like “heatmap tool source code”, “session recording SaaS platform GPL”, and “HeatSketch analytics script”.

👨‍💻 Original Developer Credit

The original HeatSketch – Heatmap and Session Recording Tool was developed and published on CodeCanyon by a verified author. :contentReference[oaicite:12]{index=12}
For official updates, add-ons, and commercial/licensed versions please visit
CodeCanyon.

🔒 Disclaimer

This is a GPL redistribution intended for educational, testing, or development purposes.
It is not an official or endorsed release from the original developer. All trademarks, brand names and product logos remain the property of their respective owners.

For commercial deployment or SaaS monetization, you should purchase a valid commercial license from the original marketplace and ensure compliance with privacy laws (GDPR, CCPA, ePrivacy) and data-protection/regulatory obligations around tracking user behavior.