# Skill: Install and run "Lucent" for me

You are helping a **non-technical user** set up **Lucent**, a free, open-source desktop app that prepares Amazon product images (listing and A+ content) before upload. Get it running on their computer with as little effort from them as possible: do the work yourself in the terminal, explain each step in plain language, and fix any errors yourself instead of asking them to.

- **Project:** https://github.com/kjmj-org/lucent
- **Learn more:** https://kjmj.org/app/lucent
- **Tech:** Electron + Node.js (uses the native `sharp` image library). Cross-platform: Windows, macOS, Linux.

## Step 0 — one question
Ask: *"Do you just want to use the app, or also change / develop it?"*
- **Just use it →** Option A (download a ready-made installer). Fastest, no tools needed.
- **Develop it →** Option B (run from source).
- If they're unsure, pick **Option A**.

## Option A — download and install (recommended for most people)
1. Open the latest release: https://github.com/kjmj-org/lucent/releases/latest
2. Download the file for the user's operating system:
   - **Windows:** `Lucent-<version>-x64.exe` — run it to install, then launch Lucent.
   - **macOS (Apple Silicon):** `Lucent-<version>-arm64.dmg`
   - **macOS (Intel):** `Lucent-<version>-x64.dmg` — open the .dmg, drag **Lucent** to Applications.
   - **Linux:** `Lucent-<version>-x86_64.AppImage` — `chmod +x` it, then run.
3. **macOS note:** the app is not code-signed, so the first launch needs **right-click → Open → Open** (or System Settings → Privacy & Security → "Open Anyway"). This is normal for free open-source apps.
4. **Windows note:** if SmartScreen warns, click **More info → Run anyway**.

If you (the agent) can act on the user's machine, download the correct asset and open it for them.

## Option B — run from source
Requires **Node.js 18+** and **git**. If either is missing, install it first (OS package manager or the official installer), then:

```bash
git clone https://github.com/kjmj-org/lucent.git
cd lucent
npm install
npm start
```

`npm start` launches the app.

### Build your own installer from source
```bash
npm run build:win     # Windows  (.exe installer)
npm run build:mac     # macOS    (.dmg)
npm run build:linux   # Linux    (.AppImage)
```

The installer/app appears in the `dist/` folder.

## Troubleshooting (handle these yourself)
- **`sharp` install/build errors:** run `npm rebuild sharp`; `npm install` normally fetches a prebuilt binary automatically.
- **Blank window on `npm start`:** read the terminal output and fix the reported error (usually a missing dependency).
- **Node too old:** install Node 18+ (LTS recommended).

## What the app does (so you can confirm it works)
Add product images → get a 0–100 preparation score with plain-language issues → apply one-click optimization (sRGB, sharpening, resize, format, metadata strip) → preview before/after, an estimated after-upload result, and a mobile view → export Amazon-ready files.

## Important
Lucent is **local-first**: never upload the user's images anywhere, and don't add accounts, telemetry, or external calls.