Как я настраиваю aliases в Vite

Коротко. @/components и resolve.alias.

Суть

Алиасы сокращают импорты и держат структуру читаемой: вместо ../../../components/Button — @/components/Button.

Ниже — практика без лишней теории: что делаю в реальных проектах (лендинги, визитки, MVP).

Базовая настройка

Синхронизирую пути в vite.config.ts и tsconfig.json, иначе IDE и сборка расходятся.

Что не стоит алиасить

Не делаю алиас на каждую папку — хватает @ для src и иногда @ui для дизайн-системы.

Проверка после деплоя

Если алиасы работают локально, но падают в CI — смотрю baseUrl и что path.resolve указывает на корень проекта.

// vite.config.ts
import path from 'node:path'
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()],
  resolve: { alias: { '@': path.resolve(__dirname, 'src') } },
})

// tsconfig.json
{ "compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["src/*"] } } }

import { Button } from '@/components/ui/Button'

Как применять на проекте

• Зафиксируйте минимальный стек в README и не добавляйте библиотеки «на будущее».
• Договоритесь о структуре папок до второй недели — позже рефактор дороже.
• Каждый PR: линтер, типы, preview-ссылка для заказчика.
• Для MVP — один layout, переиспользуемые компоненты, без преждевременного микрофронта.

Если задача — лендинг на 5 блоков, React иногда избыточен; честно проверьте, нужен ли он сейчас.

Типичные ошибки

Перегруз эффектами и библиотеками «на всякий случай»; отсутствие проверки на слабом интернете и старых телефонах; копирование чужого дизайна без адаптации под свою аудиторию; отсутствие явного CTA; ожидание, что «сайт сам продаст» без трафика и оффера.

Для коммерческих проектов отдельно болит размытое ТЗ и бесконечные правки без доплаты — лечится этапами и лимитом итераций.

Когда имеет смысл привлечь разработчика

Если нужен не шаблон, а связка дизайна, скорости, интеграций и сопровождения — проще обсудить задачу один раз, чем чинить конструктор полгода. Я беру лендинги, визитки и MVP под ключ; ориентиры по срокам и бюджету — на странице цен.

Читать дальше

• Core Web Vitals — метрики скорости
• Vite вместо CRA — стек сборки
• Услуги — разработка под задачу

Короткие ответы на частые вопросы

Это подойдёт моему бизнесу? Если вам нужен понятный сайт с заявкой или звонком — да; если десятки кабинетов и сложная логика — обсудим отдельный объём.

Что подготовить до старта? Тексты или тезисы, логотип, примеры конкурентов, доступы к домену и хостингу (если уже есть).

Как оценить результат? Скорость на мобилке, ясный CTA, отсутствие «битых» блоков и совпадение страницы с рекламой/поисковым запросом.

Итог по теме «Как я настраиваю aliases в Vite»

Сфокусируйтесь на сценарии пользователя, а не на количестве фич. Остальное — вопрос исполнения и дисциплины в проекте. Готов помочь с оценкой — контакты или Telegram из кнопки ниже.