Ко всем постам

Опубликовано

NodalDOT Блог - Первый публичный проект

Как начинался блог на Next.js: FSD-архитектура, анимации GSAP и прежний глобус навыков на Three.js

Превью блога NodalDOT

Начало

Я решил построить проект с правилом: никаких готовых UI-китов и шаблонов - всё практически с нуля.

Стек

Эта статья описывает раннюю версию проекта. Стек ниже относится к той версии, а не к текущим версиям зависимостей сайта. Сейчас на странице «Обо мне» вместо глобуса Three.js показаны иллюстрация глаза и сетка ссылок на технологии.

Выбор технологий был простым - последнее время я увлекался документацией Next.js, что и побудило меня сделать свой сайт на нём.

СлойТехнология
ФреймворкNext.js 15 (App Router)
UIReact 19
ЯзыкTypeScript 5
СтилиSass + CSS Modules (BEM)
i18nnext-intl - EN + RU
КонтентMDX + gray-matter
3DThree.js
АнимацииGSAP
КарусельSwiper
ИконкиLucide React

Архитектура: Feature-Sliced Design (почти)

Изначально я думал, что FSD - это волшебная палочка, которая решит все мои проблемы с расположением компонентов. Но как впоследствии оказалось, в проекте не так много бизнес-сущностей, и это скорее отяготило меня, чем дало какой-либо прирост в DX. Оглядываясь назад, я думаю, что FSD - не та методология, которую стоит использовать для небольших блог-приложений.

Вот как всё устроено:

app/       → маршрутизация, провайдеры, глобальные SEO-метаданные
widgets/   → Header, Footer, PostsFeed - автономные UI-блоки
sections/  → секции страниц
features/  → интерактивная логика (фильтр постов с дебаунсом)
entities/  → модель и API Post (чтение MDX из файловой системы)
shared/    → UI-кит, утилиты, конфиг i18n

Что делает проект интересным

3D-глобус навыков (Three.js)

В ранней версии секция навыков на странице «Обо мне» использовала кастомную Three.js-сцену: сферу из иконок технологий на основе SVG-текстур, нанесённых на спрайты. Этот глобус больше не является текущим интерфейсом секции навыков.

Описанное здесь взаимодействие относится к той реализации: при наведении на узел подсвечивались его соединения с ближайшими соседями через дуговую геометрию, а клик плавно поворачивал глобус к нужному узлу.

В описании исходной реализации также были указаны такие механизмы управления производительностью:

  • prefers-reduced-motion отключал анимацию по запросу accessibility
  • Battery API приостанавливал анимацию при заряде ниже 20%
  • Низкий hardwareConcurrency или deviceMemory также снижал нагрузку

Эти механизмы относятся к прежнему глобусу, а не к текущему глазу и сетке ссылок на технологии. В нынешней секции глаз реагирует на движение указателя, а также на наведение и клавиатурный фокус ссылок на технологии.

Анимированная лента карьерного пути

Секция «Мой путь» на странице «Обо мне» использует scrub-анимацию GSAP ScrollTrigger для управления прогресс-баром и плавающим шариком между карьерными вехами по мере скролла. Ресайз пересчитывает позиции через общую утилиту дебаунса.

Переходы между страницами

PageTransitionProvider рендерит полноэкранный загрузчик через React-портал. Навигация вызывает startTransition(href) вместо прямой ссылки - загрузчик успевает появиться до рендера нового маршрута.

Посты с живым поиском и сортировкой по дате

Посты показываются от новых к старым по дате публикации. Поисковый ввод дебаунсируется (300 мс) через хук useDebounce: фильтрация запускается после паузы в наборе и сохраняет порядок публикации.

i18n

Каждая видимая строка живёт в src/shared/i18n/locales/en.json и ru.json. Ничего не захардкожено в компонентах - ни лейблы, ни aria-атрибуты, ни плейсхолдеры. next-intl занимается определением локали, маршрутизацией (/en/... и /ru/...) и загрузкой сообщений.

SEO

Каждая страница генерирует собственный объект Metadata через общую утилиту createPageMetadata: канонические URL, hreflang-альтернативы для обеих локалей, Open Graph-теги и полный набор фавиконок.