docs: init

Author: GKVSO

README.md

@@ -0,0 +1,228 @@
+# GameStore WordPress Theme & Blocks
+
+> 📖 **Documentation Language**: [Русский](./docs/ru/README.md) | **English** (current)
+
+A modern WordPress block theme for gaming stores, built with full-site editing support and custom React-based blocks.
+
+## 🎮 Project Overview
+
+GameStore is a comprehensive WordPress solution featuring:
+
+- **Block Theme**: Modern FSE (Full Site Editing) theme optimized for gaming stores
+- **Custom Blocks**: React-based Gutenberg blocks for enhanced functionality
+- **Core Plugin**: Essential functionality and customizations
+- **MU Plugin**: Must-use plugin for site-wide features
+- **Automated Deployment**: GitHub Actions CI/CD pipeline
+
+## 🏗️ Project Structure
+
+```
+game-store/
+├── .github/workflows/
+│   └── CICD.yml                 # Automated deployment pipeline
+├── docs/
+│   └── ru/                      # Russian documentation
+├── mu-plugins/
+│   └── gamestore-general.php    # Must-use plugin
+├── plugins/
+│   ├── blocks-gamestore/        # Custom React blocks
+│   └── core-gamestore/          # Core functionality plugin
+├── themes/
+│   └── game-store/              # Main block theme
+├── docker-compose.yml           # Local development environment
+├── wp-version-control.cfg       # WordPress version management
+└── README.md                    # This file
+```
+
+## 🔧 Components
+
+### Theme: `game-store`
+- **Type**: Block Theme (FSE)
+- **Author**: GKVSO
+- **Features**: 
+  - Full Site Editing support
+  - Custom color palette for gaming aesthetics
+  - Responsive design patterns
+  - Gaming-optimized layouts
+
+### Plugin: `blocks-gamestore`
+- **Type**: Custom Gutenberg Blocks
+- **Technology**: React, WordPress Scripts
+- **Features**:
+  - Custom gaming-related blocks
+  - Modern build pipeline with `@wordpress/scripts`
+  - Block manifest optimization
+
+### Plugin: `core-gamestore`
+- **Type**: Core Functionality
+- **Features**: Essential site customizations and utilities
+
+### MU Plugin: `gamestore-general`
+- **Type**: Must-Use Plugin
+- **Features**: Site-wide functionality that cannot be deactivated
+
+## 🚀 Development Setup
+
+### Prerequisites
+- Node.js 18+
+- Docker & Docker Compose
+- Git
+
+### Local Development
+
+1. **Clone the repository**
+   ```bash
+   git clone https://github.com/GKVSO/GameStore.git>
+   cd game-store
+   ```
+
+2. **Start development environment**
+   ```bash
+   docker-compose up -d
+   ```
+
+3. **Build custom blocks**
+   ```bash
+   cd plugins/blocks-gamestore
+   npm install
+   npm run start
+   ```
+
+### Block Development Commands
+
+```bash
+# Development mode with hot reload
+npm run start
+
+# Production build
+npm run build
+
+# Code formatting
+npm run format
+
+# Linting
+npm run lint:js
+npm run lint:css
+
+# Create plugin zip
+npm run plugin-zip
+```
+
+## 🔐 CI/CD Configuration
+
+### Required GitHub Secrets
+
+The automated deployment requires the following secrets to be configured in your GitHub repository:
+
+| Secret Name | Description | Example |
+|-------------|-------------|---------|
+| `SERVER_HOST` | Server IP address or domain | `192.168.1.100` or `example.com` |
+| `SERVER_USER` | SSH username | `ubuntu` |
+| `SERVER_SSH_PASSWORD` | SSH password | `your-secure-password` |
+| `SERVER_PORT` | SSH port (usually 22) | `22` |
+| `SERVER_DEV_TARGET_PATH` | Development deployment path | `/var/www/dev.example.com` |
+| `SERVER_PROD_TARGET_PATH` | Production deployment path | `/var/www/example.com` |
+
+### Setting Up Secrets
+
+1. Go to your GitHub repository
+2. Navigate to **Settings** → **Secrets and variables** → **Actions**
+3. Click **New repository secret**
+4. Add each secret with its corresponding value
+
+### WordPress Version Control
+
+The `wp-version-control.cfg` file contains the WordPress download URL:
+```
+https://wordpress.org/latest.zip
+```
+
+This ensures consistent WordPress versions across deployments.
+
+## 🚀 Deployment Process
+
+### Trigger Events
+
+- **Development Deployment**: Push to `dev` branch
+- **Production Deployment**: Create a release
+
+### Deployment Stages
+
+1. **Preparation**
+   - Download WordPress from `wp-version-control.cfg`
+   - Package plugins, themes, and mu-plugins
+
+2. **File Transfer**
+   - Upload WordPress and content packages to server
+   - Enable maintenance mode
+
+3. **WordPress Core Update**
+   - Backup existing configuration
+   - Replace WordPress core files (preserving `wp-config.php`)
+   - Update admin and includes directories
+
+4. **Content Update**
+   - Update plugins, themes, and mu-plugins
+   - Preserve existing uploads and configurations
+
+5. **Cleanup**
+   - Disable maintenance mode
+   - Remove temporary files
+   - Verify deployment
+
+### Deployment Features
+
+- **Zero-downtime deployment**: Maintenance mode prevents broken states
+- **Selective updates**: Preserves `wp-config.php` and uploads
+- **Automatic cleanup**: Removes temporary files post-deployment
+- **Environment-specific paths**: Different paths for dev/prod
+
+## 🛠️ Development Workflow
+
+### Working with Blocks
+
+1. **Create new block**
+   ```bash
+   cd plugins/blocks-gamestore
+   npx @wordpress/create-block new-block-name
+   ```
+
+2. **Development workflow**
+   ```bash
+   npm run start  # Start development server
+   # Edit files in src/
+   # Browser auto-refreshes
+   ```
+
+3. **Production build**
+   ```bash
+   npm run build
+   ```
+
+### Theme Development
+
+- Edit template files in `themes/game-store/templates/`
+- Modify patterns in `themes/game-store/patterns/`
+- Update styles in `themes/game-store/style.css`
+- Configure theme in `themes/game-store/theme.json`
+
+## 📝 Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make changes following WordPress coding standards
+4. Test locally with Docker
+5. Submit a pull request
+
+## 📄 License
+
+This project is licensed under the GPL v2 or later - see the [LICENSE](LICENSE) file for details.
+
+## 👨‍💻 Author
+
+**GKVSO**
+- Telegram: [@GKVSO](https://t.me/GKVSO)
+
+---
+
+📖 **Documentation**: [Русская версия](./docs/ru/README.md) | **English** (current)