Add direct downloads and first-run support

MDSD0 · MDSD0 · commit 9fe3bd0b7dda · 2026-06-18T18:03:52.000+05:30
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,44 @@
+name: Bug report
+description: Tell us what went wrong in GazeOff.
+title: "[Bug]: "
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: Thanks for helping improve GazeOff. Please avoid including private information.
+  - type: textarea
+    id: problem
+    attributes:
+      label: What happened?
+      description: Describe the problem and what you expected instead.
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      placeholder: "1. Open…\n2. Choose…\n3. See…"
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: GazeOff version
+      placeholder: "0.1.1"
+    validations:
+      required: true
+  - type: dropdown
+    id: windows
+    attributes:
+      label: Windows version
+      options:
+        - Windows 11
+        - Windows 10
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: notes
+    attributes:
+      label: Anything else?
+      description: Screenshots and relevant details are welcome.
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Private feedback by email
+    url: mailto:mr.imcommon@gmail.com?subject=GazeOff%20feedback
+    about: Email the developer when your feedback should not be public.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,23 @@
+name: Feature request
+description: Suggest an improvement or a new GazeOff capability.
+title: "[Feature]: "
+labels: [enhancement]
+body:
+  - type: textarea
+    id: need
+    attributes:
+      label: What would you like GazeOff to help with?
+      description: Describe the situation or problem, not only the proposed button or setting.
+    validations:
+      required: true
+  - type: textarea
+    id: idea
+    attributes:
+      label: What would a good solution feel like?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives or examples
+      description: Share any workarounds or similar features you have seen.
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "gazeoff"
-version = "0.1.0"
+version = "0.1.1"
 edition = "2021"
 
 [build-dependencies]
diff --git a/README.md b/README.md
@@ -12,7 +12,7 @@
   <p>
     <a href="https://gazeoff.vercel.app"><strong>Website</strong></a>
     ·
-    <a href="https://github.com/MDSD0/GazeOff/releases/latest"><strong>Download</strong></a>
+    <a href="https://github.com/MDSD0/GazeOff/releases/latest/download/GazeOff-windows-x64.exe"><strong>Download</strong></a>
     ·
     <a href="docs/FEATURE_CATALOG.md"><strong>Feature catalog</strong></a>
   </p>
@@ -91,9 +91,11 @@ These signals are processed on-device. GazeOff has no account system, analytics
 
 ## Install
 
-Download the newest Windows build from [GitHub Releases](https://github.com/MDSD0/GazeOff/releases/latest), run `gazeoff.exe`, and find GazeOff in the system tray.
+Download the [newest Windows build directly](https://github.com/MDSD0/GazeOff/releases/latest/download/GazeOff-windows-x64.exe), run `GazeOff-windows-x64.exe`, and find GazeOff in the system tray.
 
-> The current release is not signed with a public code-signing certificate. Windows SmartScreen may show a warning on first launch.
+> **Windows security note:** GazeOff is not yet code-signed. Windows SmartScreen may offer **More info → Run anyway**. Windows 11 **Smart App Control** is a different protection layer and may block unsigned apps without a per-app bypass. We do not recommend disabling system-wide protection just for GazeOff. See [Microsoft’s Smart App Control guidance](https://support.microsoft.com/en-us/windows/smart-app-control-frequently-asked-questions-285ea03d-fa88-4d56-882e-6698afdb7003).
+
+On the first successful launch, GazeOff opens a welcome window confirming that it is running and showing where to find its tray icon and settings.
 
 ## Development
 
@@ -127,7 +129,7 @@ The release artifact is built with Cargo's optimized release profile. Every GitH
 Get-FileHash .\gazeoff.exe -Algorithm SHA256
 ```
 
-Public code signing is not yet configured, so Windows SmartScreen can ask for confirmation on first launch.
+Public code signing is not yet configured. SmartScreen may allow a manual confirmation; Smart App Control may block the unsigned executable entirely.
 
 </details>
 
@@ -150,6 +152,11 @@ capabilities/        Tauri permission configuration
 - [Complete feature catalog](docs/FEATURE_CATALOG.md)
 - [Publishing checklist](docs/PUBLISHING_CHECKLIST.md)
 
+## Feedback and support
+
+- [Report a bug or request a feature](https://github.com/MDSD0/GazeOff/issues/new/choose)
+- Email [mr.imcommon@gmail.com](mailto:mr.imcommon@gmail.com?subject=GazeOff%20feedback) for private feedback
+
 <div align="center">
   <sub>Gaze off. See how beautiful the sky is.</sub>
 </div>
diff --git a/src/main.rs b/src/main.rs
@@ -1576,6 +1576,46 @@ fn settings_window_action(app: AppHandle, action: String) {
     }
 }
 
+#[tauri::command]
+fn open_contact(kind: String) -> Result<(), String> {
+    let target = match kind.as_str() {
+        "issues" => "https://github.com/MDSD0/GazeOff/issues/new/choose",
+        "email" => "mailto:mr.imcommon@gmail.com?subject=GazeOff%20feedback",
+        _ => return Err("unknown contact destination".into()),
+    };
+
+    #[cfg(windows)]
+    let result = std::process::Command::new("rundll32.exe")
+        .args(["url.dll,FileProtocolHandler", target])
+        .spawn();
+
+    #[cfg(not(windows))]
+    let result = std::process::Command::new("xdg-open").arg(target).spawn();
+
+    result
+        .map(|_| ())
+        .map_err(|error| format!("could not open contact destination: {error}"))
+}
+
+#[tauri::command]
+fn welcome_action(app: AppHandle, eng: State<Eng>, action: String) {
+    match action.as_str() {
+        "start" => {
+            eng.0.lock().unwrap().paused_until = 0;
+            hide(&app, "welcome");
+        }
+        "settings" => {
+            hide(&app, "welcome");
+            if let Some(window) = app.get_webview_window("settings") {
+                let _ = window.show();
+                let _ = window.set_focus();
+            }
+        }
+        "close" => hide(&app, "welcome"),
+        _ => {}
+    }
+}
+
 #[tauri::command]
 fn wallpaper_data_url() -> Option<String> {
     current_wallpaper_data_url()
@@ -1721,6 +1761,8 @@ fn main() {
             toggle_pause,
             open_settings,
             settings_window_action,
+            open_contact,
+            welcome_action,
             wallpaper_data_url,
             get_recovery_score,
             get_stats,
@@ -1731,6 +1773,7 @@ fn main() {
         ])
         .setup(move |app| {
             let handle = app.handle().clone();
+            let first_run = !store_path(&handle).exists();
 
             // 60fps hardware cursor tracking thread for smooth pre-break texts
             let tracker_handle = handle.clone();
@@ -1763,6 +1806,9 @@ fn main() {
             {
                 let mut e = engine.lock().unwrap();
                 load(&handle, &mut e);
+                if first_run {
+                    save(&handle, &e);
+                }
                 if !e.s.start_timer_on_launch {
                     e.paused_until = u64::MAX;
                 }
@@ -1778,6 +1824,16 @@ fn main() {
             };
 
             // windows (all hidden until needed)
+            let _welcome =
+                WebviewWindowBuilder::new(app, "welcome", WebviewUrl::App("welcome.html".into()))
+                    .transparent(false)
+                    .decorations(false)
+                    .resizable(false)
+                    .title("Welcome to GazeOff")
+                    .inner_size(720.0, 540.0)
+                    .center()
+                    .visible(first_run)
+                    .build()?;
             let overlay =
                 WebviewWindowBuilder::new(app, "overlay", WebviewUrl::App("overlay.html".into()))
                     .transparent(true)
@@ -1863,7 +1919,7 @@ fn main() {
             }
 
             // overlay and settings never truly close - they hide
-            for label in ["overlay", "settings", "panel", "nudge", "dim", "afk_prompt"] {
+            for label in ["welcome", "overlay", "settings", "panel", "nudge", "dim", "afk_prompt"] {
                 if let Some(w) = app.get_webview_window(label) {
                     let wc = w.clone();
                     let is_panel = label == "panel";
diff --git a/tauri.conf.json b/tauri.conf.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "gazeOff",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "identifier": "com.gazeoff.app",
   "build": {
     "frontendDist": "ui"
diff --git a/ui/settings.html b/ui/settings.html
@@ -868,7 +868,22 @@
         <div class="group-title">About</div>
         <div class="row">
           <div class="label">gazeOff<br><span class="hint">A Windows-first eye-care companion.</span></div>
-          <div class="muted">0.1.0</div>
+          <div class="muted">0.1.1</div>
+        </div>
+        <div class="group-title" style="margin-top: 32px;">Feedback &amp; support</div>
+        <div class="row">
+          <div class="label">
+            Report a bug or request a feature
+            <div class="hint">Use GitHub Issues so progress and follow-up stay visible.</div>
+          </div>
+          <button class="preview-btn" id="contact_issues" type="button">Open GitHub</button>
+        </div>
+        <div class="row">
+          <div class="label">
+            Email the developer
+            <div class="hint">For private feedback: mr.imcommon@gmail.com</div>
+          </div>
+          <button class="preview-btn" id="contact_email" type="button">Send email</button>
         </div>
         <div class="row">
           <div class="label">
@@ -1111,6 +1126,8 @@
   $('test_debt_nudge').onclick = e => { e.preventDefault(); e.stopPropagation(); invoke('test_nudge', { kind: 'debt' }); };
   $('test_afk_prompt').onclick = e => { e.preventDefault(); e.stopPropagation(); invoke('test_afk_prompt'); };
   $('test_break_overlay').onclick = e => { e.preventDefault(); e.stopPropagation(); invoke('break_now'); };
+  $('contact_issues').onclick = () => invoke('open_contact', { kind: 'issues' });
+  $('contact_email').onclick = () => invoke('open_contact', { kind: 'email' });
   $('reset_settings').onclick = async e => {
     e.preventDefault();
     e.stopPropagation();
diff --git a/ui/welcome.html b/ui/welcome.html
@@ -0,0 +1,44 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <meta name="color-scheme" content="dark">
+  <title>Welcome to GazeOff</title>
+  <style>
+    :root{color-scheme:dark;--ink:#f7eedb;--soft:rgba(247,238,219,.72);--faint:rgba(247,238,219,.48);--rule:rgba(247,238,219,.16);--accent:#e8a874}
+    *{box-sizing:border-box}html,body{width:100%;height:100%;margin:0;overflow:hidden}body{position:relative;background:linear-gradient(180deg,#050714 0%,#0a0c1f 28%,#1a1730 58%,#5e3454 100%);color:var(--ink);font-family:Georgia,"Times New Roman",serif;-webkit-font-smoothing:antialiased}
+    body::before{content:"";position:absolute;inset:0;background:radial-gradient(ellipse at 70% 105%,rgba(232,168,116,.32),transparent 48%);pointer-events:none}
+    .stars{position:absolute;inset:0;background-image:radial-gradient(circle,#f7eedb 0 1px,transparent 1.2px),radial-gradient(circle,#f7eedb 0 .7px,transparent 1px);background-size:137px 137px,83px 83px;background-position:18px 24px,57px 41px;opacity:.28}
+    .drag{position:absolute;z-index:3;top:0;left:0;right:54px;height:46px}.close{position:absolute;z-index:4;top:0;right:0;width:54px;height:44px;border:0;background:transparent;color:var(--soft);font:20px sans-serif;cursor:pointer}.close:hover{background:rgba(255,255,255,.08);color:var(--ink)}
+    main{position:relative;z-index:2;height:100%;padding:58px 64px 48px;display:flex;flex-direction:column}.brand{display:flex;align-items:center;gap:10px;font-size:17px}.mark{width:27px;height:27px;fill:none;stroke:currentColor;stroke-width:1.5}
+    h1{max-width:560px;margin:46px 0 14px;font-size:54px;line-height:.98;font-weight:400;letter-spacing:-.035em}h1 em{display:block;color:#f2d7b8;font-weight:400}p{margin:0;color:var(--soft);font-size:17px;line-height:1.55}.tray-guide{margin-top:34px;padding:20px 0;display:grid;grid-template-columns:48px 1fr;gap:18px;border-top:1px solid var(--rule);border-bottom:1px solid var(--rule)}.tray-icon{width:42px;height:42px;display:grid;place-items:center;border:1px solid var(--rule);border-radius:8px;background:rgba(5,7,20,.62)}.tray-icon svg{width:25px;height:25px;fill:#f2d7b8}.tray-guide strong{display:block;margin-bottom:4px;font:600 14px system-ui,sans-serif}.tray-guide span{color:var(--faint);font:13px/1.45 system-ui,sans-serif}
+    .actions{margin-top:auto;display:flex;align-items:center;gap:10px}.actions button{min-height:42px;padding:0 17px;border:1px solid var(--rule);border-radius:7px;background:transparent;color:var(--ink);font:600 13px system-ui,sans-serif;cursor:pointer}.actions .primary{border-color:var(--ink);background:var(--ink);color:#151525}.actions button:hover{border-color:var(--ink)}.actions small{margin-left:auto;color:var(--faint);font:11px system-ui,sans-serif}
+  </style>
+</head>
+<body>
+  <div class="stars" aria-hidden="true"></div>
+  <div class="drag" data-tauri-drag-region></div>
+  <button class="close" type="button" aria-label="Close welcome window">×</button>
+  <main>
+    <div class="brand"><svg class="mark" viewBox="0 0 32 32" aria-hidden="true"><path d="M4 17c3-6 7-9 12-9s9 3 12 9c-3 5-7 8-12 8S7 22 4 17Z"/><circle cx="16" cy="16.5" r="3.5"/></svg>GazeOff</div>
+    <h1>You’re all set. <em>Your eyes can exhale.</em></h1>
+    <p>GazeOff is running quietly in the background and will keep interruptions brief.</p>
+    <div class="tray-guide">
+      <div class="tray-icon" aria-hidden="true"><svg viewBox="0 0 32 32"><path d="M5 19c0-4 3-7 7-7 1-4 4-6 8-6 5 0 9 4 9 9 2 1 3 3 3 5 0 4-3 7-7 7H11c-3 0-6-3-6-6v-2Z"/></svg></div>
+      <div><strong>Look beside the Windows clock</strong><span>Left-click the GazeOff tray icon for your timer. Right-click it for breaks, pause, settings, and quit.</span></div>
+    </div>
+    <div class="actions">
+      <button class="primary" id="start" type="button">Start GazeOff</button>
+      <button id="settings" type="button">Open settings</button>
+      <small>GazeOff stays in the tray—not the taskbar.</small>
+    </div>
+  </main>
+  <script>
+    const invoke=window.__TAURI__.core.invoke;
+    document.querySelector('#start').onclick=()=>invoke('welcome_action',{action:'start'});
+    document.querySelector('#settings').onclick=()=>invoke('welcome_action',{action:'settings'});
+    document.querySelector('.close').onclick=()=>invoke('welcome_action',{action:'close'});
+  </script>
+</body>
+</html>
diff --git a/website/index.html b/website/index.html
@@ -23,10 +23,10 @@
       <a href="#how-it-works">How it works</a>
       <a href="#science">Eye science</a>
       <a href="#intelligence">Smart pause</a>
-      <a href="#stats">Stats</a>
+      <a href="#support">Support</a>
       <a href="https://github.com/MDSD0/GazeOff" target="_blank" rel="noreferrer">GitHub</a>
     </nav>
-    <a class="button button-compact" href="https://github.com/MDSD0/GazeOff/releases/latest">Download</a>
+    <a class="button button-compact" href="https://github.com/MDSD0/GazeOff/releases/latest/download/GazeOff-windows-x64.exe" download>Download</a>
   </header>
 
   <main id="top">
@@ -36,7 +36,7 @@
         <h1>Give your eyes<br>somewhere else to be.</h1>
         <p class="hero-intro">Brief, well-timed breaks that protect your eyes without treating your work like an interruption.</p>
         <div class="hero-actions">
-          <a class="button" href="https://github.com/MDSD0/GazeOff/releases/latest">Download for Windows</a>
+          <a class="button" href="https://github.com/MDSD0/GazeOff/releases/latest/download/GazeOff-windows-x64.exe" download>Download for Windows</a>
           <span>Windows 10 and 11</span>
         </div>
       </div>
@@ -185,16 +185,33 @@ <h2>See whether your habits are actually improving.</h2>
       <div class="sky-strip" aria-label="GazeOff time of day skies"><div data-time="Dawn"></div><div data-time="Day"></div><div data-time="Dusk"></div><div data-time="Night"></div></div>
     </section>
 
+    <section class="support-section" id="support">
+      <div>
+        <h2>Help shape GazeOff.</h2>
+        <p>Found a bug or have an idea? Open a GitHub Issue so it can be tracked, or email the developer privately.</p>
+      </div>
+      <div class="support-actions">
+        <a href="https://github.com/MDSD0/GazeOff/issues/new/choose" target="_blank" rel="noreferrer">Report a bug or request a feature</a>
+        <a href="mailto:mr.imcommon@gmail.com?subject=GazeOff%20feedback">mr.imcommon@gmail.com</a>
+      </div>
+    </section>
+
+    <section class="windows-note" aria-label="Windows security information">
+      <strong>Before your first launch</strong>
+      <p>GazeOff is not yet code-signed. Windows SmartScreen may offer <b>More info → Run anyway</b>. Windows 11 Smart App Control is different and may block unsigned apps without a per-app bypass. We do not recommend turning off system-wide protection just for GazeOff.</p>
+      <a href="https://support.microsoft.com/en-us/windows/smart-app-control-frequently-asked-questions-285ea03d-fa88-4d56-882e-6698afdb7003" target="_blank" rel="noreferrer">Microsoft’s Smart App Control guidance</a>
+    </section>
+
     <section class="closing" id="download">
       <div><h2>Your eyes have done enough scrolling.</h2><p>Install GazeOff and let the next break find you.</p></div>
-      <a class="button button-light" href="https://github.com/MDSD0/GazeOff/releases/latest" aria-label="Download GazeOff for Windows">Download for Windows</a>
+      <a class="button button-light" href="https://github.com/MDSD0/GazeOff/releases/latest/download/GazeOff-windows-x64.exe" download aria-label="Download GazeOff for Windows">Download for Windows</a>
     </section>
   </main>
 
   <footer>
     <a class="brand" href="#top"><img src="assets/tray_blob.png" alt=""><span>GazeOff</span></a>
     <p>Quiet recovery for Windows.</p>
-    <div><a href="https://github.com/MDSD0/GazeOff">GitHub</a><a href="https://github.com/MDSD0/GazeOff/releases/latest">Releases</a><a href="mailto:hello@gazeoff.app">Contact</a></div>
+    <div><a href="https://github.com/MDSD0/GazeOff">GitHub</a><a href="https://github.com/MDSD0/GazeOff/issues/new/choose">Issues</a><a href="mailto:mr.imcommon@gmail.com?subject=GazeOff%20feedback">Email</a></div>
     <p>© 2026 GazeOff</p>
   </footer>
   <script src="app.js"></script>
diff --git a/website/style.css b/website/style.css

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"$schema": "https://schema.tauri.app/config/2",`
`3`	`3`	`"productName": "gazeOff",`
`4`		`- "version": "0.1.0",`
	`4`	`+ "version": "0.1.1",`
`5`	`5`	`"identifier": "com.gazeoff.app",`
`6`	`6`	`"build": {`
`7`	`7`	`"frontendDist": "ui"`