vercel-analytics — команда для Claude Code
Настраивает Vercel Analytics и Speed Insights в проектах на React или Vite. Добавляет нужные пакеты, вставляет компоненты и прописывает правила маршрутизации в vercel.json.
npx claude-code-templates@latest --command setup/vercel-analyticsЧто делает vercel-analytics
Команда настраивает сбор метрик в проектах на базе Vite или Create React App. Сначала агент устанавливает пакеты @vercel/analytics и @vercel/speed-insights через npm. Затем он ищет входной файл приложения. Проверяются пути src/App.tsx, src/App.jsx, src/main.tsx и src/main.jsx.
В найденный файл вставляются компоненты Analytics и SpeedInsights. Команда берёт импорты строго из подпутей /react, поэтому для Next.js она не годится. В корне создаётся vercel.json с перенаправлением всех маршрутов на index.html. Это решает проблему ошибок 404 при прямом открытии ссылок в SPA.
В конце агент проверяет целостность импортов и наличие конфигурационного файла. Разработчику остаётся только выполнить vercel deploy в терминале и открыть панель Vercel.
Какие задачи решает
- подключить сбор метрик Vercel Analytics и Speed Insights к React-приложению
- настроить перенаправление маршрутов SPA в vercel.json для устранения ошибок 404
- внедрить компоненты аналитики в App.tsx или main.tsx без ручной правки кода
- установить зависимости @vercel/analytics и @vercel/speed-insights через npm
Примеры запросов агенту
- /vercel-analytics
- Подключи Vercel Analytics и Speed Insights к этому проекту с помощью /vercel-analytics
Как установить vercel-analytics
1Через claude-code-templates
npx claude-code-templates@latest --command setup/vercel-analytics2Вручную: положить файлы
.claude/commands/vercel-analytics.mdВызов — /vercel-analytics. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/vercel-analytics.mdВызов — /prompts:vercel-analytics. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/vercel-analytics.prompt.mdВручную: положить файлы
.gemini/commands/vercel-analytics.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о vercel-analytics
Как установить команду vercel-analytics в Claude Code?
Выполните в терминале команду npx claude-code-templates@latest --command setup/vercel-analytics. Файл команды будет сохранён по пути .claude/commands/vercel-analytics.md.
Что делает vercel-analytics?
Она скачивает официальные пакеты аналитики Vercel, добавляет компоненты отслеживания в код React и создаёт файл vercel.json для роутинга.
Зачем команда создаёт файл vercel.json?
В vercel.json прописывается правило перезаписи всех маршрутов на index.html. Без этого прямой переход по ссылкам внутри SPA на хостинге Vercel возвращает ошибку 404.
Исходный текст
vercel-analytics.md · MIT
---
allowed-tools: Read, Write, Edit, Bash
argument-hint:
description: Set up Vercel Analytics and Speed Insights for React/Vite projects
---
# Vercel Analytics Setup
Automatically configure Vercel Analytics and Speed Insights for your React/Vite project.
**Usage:** `/vercel-analytics` (no arguments needed)
**What it does:**
- Installs @vercel/analytics and @vercel/speed-insights packages
- Adds components to your React app
- Configures SPA routing for Vercel deployment
- Fixes 404 errors for direct route access
**Process:**
1. **Install Vercel Packages**
```bash
npm install @vercel/analytics @vercel/speed-insights
```
2. **Detect Main App File**
- Search for main React entry point:
- `src/App.tsx` or `src/App.jsx`
- `src/main.tsx` or `src/main.jsx`
- Read file to determine current structure
3. **Add Analytics Components**
- Import Analytics from '@vercel/analytics/react'
- Import SpeedInsights from '@vercel/speed-insights/react'
- Add both components to the main App component
- Use `/react` imports (not `/next`)
4. **Create vercel.json Configuration**
- Create `vercel.json` in project root
- Add SPA rewrite rules:
```json
{
"rewrites": [
{ "source": "/(.*)", "destination": "/index.html" }
]
}
```
- This ensures all routes serve index.html (fixes 404s)
5. **Verify Setup**
- Confirm components are properly imported
- Check vercel.json exists and is valid
- Display success message with next steps
**Expected Outcome:**
- ✅ Analytics tracking active
- ✅ Speed Insights monitoring configured
- ✅ SPA routing works correctly on Vercel
- ✅ No 404 errors on direct route access
**Next Steps:**
1. Deploy to Vercel: `vercel deploy`
2. View analytics at: https://vercel.com/dashboard/analytics
3. Check Speed Insights: https://vercel.com/dashboard/speed-insights
**Note**: Works with React, Vite, Create React App, and other SPA frameworks.
© davila7 · MIT · davila7/claude-code-templates