first commit

README.md

@@ -0,0 +1,52 @@
+# X-Kater WordPress Starter
+
+Минимальный каркас проекта для многостраничного сайта на WordPress с использованием ACF Pro.
+
+## Быстрый старт
+
+1. Скопировать переменные окружения:
+   ```bash
+   cp .env.example .env
+   ```
+2. Запустить окружение:
+   ```bash
+   docker compose up -d
+   ```
+3. Открыть установку WordPress:
+   - `http://localhost:8080`
+4. В админке активировать тему `X-Kater Theme`.
+
+## ACF Pro
+
+- Установите ACF Pro через админку WordPress (`Plugins -> Add New -> Upload Plugin`) или положите папку плагина в `wp-content/plugins/acf-pro`.
+- JSON полей ACF сохраняется в `wp-content/themes/xkater/acf-json`.
+
+## SCSS
+
+Структура SCSS находится в `wp-content/themes/xkater/assets/scss`.
+
+1. Установить зависимости:
+   ```bash
+   npm install
+   ```
+2. Разовая сборка:
+   ```bash
+   npm run scss:build
+   ```
+3. Режим разработки (watch + autoprefixer):
+   ```bash
+   npm run scss:dev
+   ```
+4. Продакшен-сборка:
+   ```bash
+   npm run scss:prod
+   ```
+
+Скомпилированный CSS: `wp-content/themes/xkater/assets/css/main.css`.
+
+Для резиновой верстки добавлены:
+
+- SCSS-функция `fluid(...)` для `clamp(...)`;
+- миксин `fluid-property(...)`;
+- миксин `container(...)`;
+- миксин `respond(...)` для брейкпоинтов.