Lince Tracker 👁️‍🗨️

Визуальное ревью и система комментариев для UI прямо в браузере.

Модуль для Nuxt 4, который позволяет удобно оставлять комментарии поверх элементов интерфейса. Никаких изменений в коде — всё работает Zero-Config прямо "из коробки" в dev режиме.

Фичи

• 🎯 Точная привязка — наводите на элементы, кликайте и оставляйте комментарии (использует уникальные CSS-селекторы).
• 🧩 Zero-config — UI кнопки автоматически инжектируется в интерфейс, вам не нужно добавлять компоненты в app.vue.
• 🔒 Авторизация — доступ через простой пароль (из .env).
• 📂 Группировка по маршрутам — комментарии автоматически фильтруются по текущей странице (route).
• ✔️ Статусы — помечайте комментарии как open или resolved.
• ✏️ Удобная панель — боковая slide-панель для работы со списком замечаний.

🚀 Установка

npm install lince-tracker

В вашем nuxt.config.ts подключите модуль:

export default defineNuxtConfig({
  modules: ['lince-tracker'],

  // (Опционально) Кастомные настройки
  tracker: {
    enabled: true,                          // Включается автоматически только в dev-режиме
    storageFile: '.tracker-comments.json',  // Где хранить JSON с комментариями
  }
})

В корне проекта создайте или дополните .env файл секретным паролем для входа в панель:

NUXT_TRACKER_PASSWORD=мой_надежный_пароль

Совет: Вы можете принудительно выключить модуль в .env: NUXT_TRACKER_ENABLED=false

🛠 Использование

1. Запустите ваш проект npm run dev.
2. В правом нижнем углу появится floating-кнопка с галочкой.
3. Нажмите на неё, введите своё Имя и Пароль из .env.
4. Нажмите «Войти». Теперь вы находитесь в режиме комментирования — просто наведите мышку на любой блок (он подсветится мягким outline) и кликните, чтобы оставить к нему замечание.

Все комментарии складываются в файл .tracker-comments.json, который можно легко добавить в репозиторий вместе с кодом (или игнорировать через .gitignore, если вам это не нужно).

📄 Лицензия

MIT License © 2026 Aleksandr Pletnev