https://github.com/dcversus/snake-game
https://github.com/dcversus/snake-game
Last synced: 2 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/dcversus/snake-game
- Owner: dcversus
- License: mit
- Created: 2025-10-24T07:19:48.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-24T08:12:09.000Z (8 months ago)
- Last Synced: 2026-03-31T12:39:34.190Z (3 months ago)
- Language: TypeScript
- Size: 50.8 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 🐍 Snake Game
[](https://dcversus.github.io/snake-game/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/dcversus/snake-game/actions)
[](https://github.com/dcversus/snake-game/actions)
[](https://www.typescriptlang.org/)
[](https://developer.mozilla.org/en-US/docs/Web/HTML)
[](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
[](https://developer.mozilla.org/en-US/docs/Web/CSS)
Классическая игра "Змейка" с современным минималистичным дизайном и 3D эффектами, созданная с помощью AI-ассистента **Ampcode**.
> 💭 **Небольшая история:** Этот проект был создан в шутку для друга, чтобы показать, как легко и весело можно создавать крутые штуки с помощью AI! Надеюсь, это вдохновит тебя изучать программирование и экспериментировать с новыми технологиями! 🚀
## 🎮 [Играть онлайн](https://dcversus.github.io/snake-game/)
## 📖 [Полное руководство: Как создать игру с AI](HOWTO.md)
> 🎓 Хотите создать свою игру? Прочитайте [HOWTO.md](HOWTO.md) — там полная переписка создания этого проекта с анализом промптов и лучшими практиками!
## ✨ Особенности
- 🎨 Минималистичный дизайн в стиле Nebius Academy
- 🤖 **3 AI-бота противника** с умным поведением
- 🍎 **8 яблочек** на поле одновременно
- ⚡ **Динамическая скорость** — растёт с длиной змейки
- 🎭 **3D эффекты** — градиенты, тени, плавные переходы
- 🔊 **Простые звуки** при поедании еды и проигрыше
- 📐 **Большое поле** 800×600 пикселей
- 💾 Сохранение рекорда в localStorage
- ⌨️ Управление стрелками или WASD
- ⏸️ Пауза на пробел
- 🌀 Проход сквозь стены
## 🎯 Управление
- **← ↑ → ↓** или **W A S D** — движение змейки
- **Пробел** — пауза/продолжить
- **Кнопка "Играть снова"** — рестарт после проигрыша
## 🤖 О создании
Этот проект создан как демонстрация возможностей [**Ampcode**](https://ampcode.com) — AI-ассистента для разработки от Sourcegraph.
### 🧠 Технологии AI
Проект полностью разработан с использованием:
- **Claude 3.7 Sonnet** — основная модель для генерации кода и архитектурных решений
### 🛠️ Стек технологий
- **TypeScript** — строгая типизация
- **Vite** — быстрый zero-config бандлер
- **HTML5** Canvas для рендеринга
- **Vitest** — unit-тестирование
- **GitHub Pages** для хостинга
- **GitHub Actions** для CI/CD
## 🚀 Локальный запуск
```bash
# Клонировать репозиторий
git clone https://github.com/dcversus/snake-game.git
# Перейти в папку
cd snake-game
# Установить зависимости
npm install
# Запустить dev-сервер
npm run dev
# Или собрать для production
npm run build
npm run preview
```
## 🧪 Разработка
```bash
# Запустить тесты
npm test
# Запустить тесты в watch mode
npm run test:watch
# Проверить типы TypeScript
npm run typecheck
# Собрать проект
npm run build
```
## 📦 Структура проекта
```
snake-game/
├── src/
│ ├── __tests__/ # Unit-тесты
│ ├── Bot.ts # Логика AI ботов
│ ├── Game.ts # Основная игровая логика
│ ├── constants.ts # Константы игры
│ ├── types.ts # TypeScript типы
│ ├── utils.ts # Утилиты
│ ├── main.ts # Точка входа
│ └── style.css # Стили
├── index.html # HTML страница
├── package.json # Зависимости
├── tsconfig.json # TypeScript конфигурация
├── vite.config.ts # Vite + Vitest конфигурация
└── .github/
└── workflows/
└── quality.yml # Quality Pipeline CI/CD
```
## 🔧 Quality Pipeline
Проект использует GitHub Actions с автоматическими проверками:
- ✅ **TypeScript check** — проверка типов
- ✅ **Unit Tests** — запуск всех тестов (15 тестов)
- ✅ **Build** — сборка проекта с Vite
- ✅ **Deploy** — автоматический деплой на GitHub Pages
- ✅ Запуск при каждом push в main и PR
## 📝 Лицензия
Этот проект распространяется под лицензией MIT. Подробности в файле [LICENSE](LICENSE).
## 🙏 Благодарности
- **Ampcode** за помощь в разработке
- **Sourcegraph** за создание Ampcode
- **Claude (Anthropic)** за AI-модель
## 🔗 Ссылки
- [🎮 Демо игры](https://dcversus.github.io/snake-game/)
- [📖 Ampcode](https://ampcode.com)
- [🐙 GitHub репозиторий](https://github.com/dcversus/snake-game)
---