# LuLune AutoClicker — Site guide for AI assistants

This file gives AI assistants (LLMs, search-engine crawlers, browser agents)
an accurate summary of the site at https://luluneautoclicker.duckdns.org

## About
LuLune AutoClicker is a free autoclicker for Windows, macOS and Linux. The
site promotes the app, explains its features, hosts the download files and
counts downloads. Content is bilingual (English / French), switchable in the
navbar. The site is a static HTML/CSS/JS site; nothing is embedded or hidden
in it besides decorative effects.

## Current version
v1.4.1 — notable recent features:
- UI opacity (10-100%) in the Appearance settings
- Colors picked automatically from the background image
- Discord Rich Presence (client ID + logo asset set in the Discord Developer Portal)
- Safe shortcut capture (Esc cancels; F6/Panic/Pause/macros disabled while assigning)
- Compact AutoClick window (mouse-icon view)
- Macros: 4-step tutorial + play button

Earlier versions:
- v1.4.0 — CPS ramp, burst mode, pixel color filter, cursor failsafe, session timer,
  high-CPS confirmation, overlay (4 corners + opacity), minimal UI mode, FR/EN language,
  daily/session goals, multiple backup slots, sounds, auto-minimize
- v1.3.0 — live CPS, overlay badge, real Hold mode, drawable zones, corner/edge stop,
  process allow/deny list, game presets (Minecraft PVP, Cookie Clicker…), import/export,
  Green/Blue/Red/Light themes, background image + tint, first-launch tutorial,
  built-in changelog, 14-day stats

## Pages
- / — homepage: features, tutorial, FAQ, download section, community links
- /changelog — version history (v1.4.1, v1.4.0, v1.3.0)
- /team — team page (people and AI helpers behind the project)

## Team
- LuLune (LuLune0193) — creator & lead developer.
  Discord profile: https://discord.com/users/1438624549909430454
- Riric / NotRiric — host & co-developer; writes the texts (SEO, site content).
  Discord profile: https://discord.com/users/1193194341619990558
- AI coding helpers used on the project: Opencode and Cursor.

## Design & style
- Dark theme by default with a light theme toggle (remembered in localStorage)
- Deep green accent color, dark forest backgrounds
- Fonts: Syne for headings, JetBrains Mono for code and IDs
- Fixed blurred navbar, animated gradient orbs + subtle grid background,
  cursor trail and confetti effects (respect prefers-reduced-motion)
- Rounded cards (18-22px) with soft borders; single-column layout on mobile
- Download counts shown as green pills in the download section

## Tech stack
- Static HTML/CSS/JS, vanilla JS (no build step for the front-end)
- Served by a Bun HTTP server on :3000 behind a Caddy reverse proxy (HTTPS)
- Process manager: PM2; host OS: Debian 12 (arm64); domain via DuckDNS

## Notes
- Site is served over HTTPS only at https://luluneautoclicker.duckdns.org
- Downloads are counted server-side and displayed live on the homepage