SnapForge

Язык: Русский | English

Превращайте обычные скриншоты в красивые карточки, готовые для GitHub.

SnapForge — это готовое локальное приложение с веб-интерфейсом и CLI на C#/.NET для генерации аккуратных PNG-карточек из обычных скриншотов. Проект помогает быстро готовить изображения для GitHub README, портфолио, журнала изменений, социальных сетей и презентаций.

Проблема

Скриншоты полезны, но в документации они часто выглядят сыро: разные размеры, нет контекста, нет рамки, тени и визуального порядка. Открывать дизайнерский инструмент ради одной README-картинки — лишний шаг.

Решение

SnapForge берёт исходный скриншот, помещает его в минималистичный тематический макет и экспортирует готовую PNG-карточку:

• чистый фон;
• заголовок и подзаголовок;
• скриншот внутри рамки;
• скруглённые углы;
• мягкая тень;
• тонкая граница;
• подпись Generated with SnapForge.

Быстрый старт

SnapForge можно проверить без сборки из исходников:

https://github.com/rndv1/SnapForge/releases

Скачайте архив приложения для своей платформы, распакуйте и запустите snapforge. На Windows можно просто открыть snapforge.exe: приложение поднимет локальный веб-интерфейс и откроет браузер.

Windows:

.\snapforge.exe

Linux/macOS:

./snapforge

CLI остаётся доступен отдельно в архивах snapforge-cli-* и в .nupkg:

snapforge-cli card ./examples/input/sample.png \
  --output ./examples/output/sample-card.png \
  --title "SnapForge" \
  --subtitle "Скриншоты, готовые для GitHub" \
  --preset github \
  --theme dark

Запуск из исходников:

dotnet restore
dotnet build
dotnet test
dotnet run --project src/SnapForge.Cli -- card ./examples/input/sample.png \
  --output ./examples/output/sample-card.png \
  --title "SnapForge" \
  --subtitle "Скриншоты, готовые для GitHub" \
  --preset github \
  --theme dark

CLI

snapforge-cli card <input> --output <output> --title <title> --subtitle <subtitle> --preset <preset> --theme <theme> [--background <hex>] [--padding <pixels>] [--config <path>]
snapforge-cli batch <config> [--stop-on-error]

Если SnapForge установлен как .NET tool из .nupkg, команда называется snapforge.

--background принимает цвет в формате #RRGGBB или RRGGBB.

--padding задаёт внешний отступ карточки от 32 до 240 пикселей.

--config позволяет хранить повторяемые настройки проекта в JSON.

Пресеты

Пресет	Размер	Для чего
github	1280x720	README, журнал изменений, превью проекта
open-graph	1200x630	Open Graph и превью ссылок
social	1080x1080	квадратные карточки для соцсетей
portfolio	1600x900	портфолио и кейсы
slide	1920x1080	слайды 16:9
slide-4-3	1600x1200	слайды 4:3

Темы

Тема	Стиль
light	светлый нейтральный фон и тёмный читаемый текст
dark	тёмный GitHub-стиль для инструментов разработчика и светлый текст

Возможности

• Генерация PNG-карточек из локальных скриншотов.
• Проверка входного файла и создание выходной директории.
• Защита от перезаписи исходного изображения.
• Пресеты, темы, пользовательский фон и настройка отступов.
• JSON-конфиги для повторяемого брендинга проекта.
• Пакетная генерация нескольких карточек за один запуск.
• Готовое локальное веб-приложение, запускаемое через snapforge.exe.
• Переключение интерфейса между русским и английским языком.
• Загрузка скриншота через выбор файла, перетаскивание на панель настроек или вставку из буфера обмена.
• GitHub Actions CI и процесс релизов.
• Готовые релизные архивы веб-приложения для Windows, Linux и macOS.
• Отдельные CLI-архивы snapforge-cli-*.
• .nupkg для установки как .NET tool.
• SHA256SUMS.txt для проверки целостности релизных файлов.

До и после

Исходный скриншот	Готовая карточка

Больше примеров: examples/README.md.

Документация

• Установка
• Руководство пользователя
• Руководство разработчика
• Чеклист проверяющего
• Участие в разработке
• Кодекс поведения
• Политика безопасности
• Журнал изменений

Английские версии доступны через переключатель языка в начале каждого документа.

Структура проекта

SnapForge/
├── src/
│   ├── SnapForge.Core/
│   ├── SnapForge.Cli/
│   └── SnapForge.Web/
├── tests/
├── examples/
├── docs/
├── .github/workflows/
├── README.md
├── README.en.md
└── SnapForge.sln

Разработка

dotnet restore
dotnet build
dotnet test

Запуск CLI:

dotnet run --project src/SnapForge.Cli -- --help
dotnet run --project src/SnapForge.Cli -- card --help

Запуск веб-приложения из исходников:

dotnet run --project src/SnapForge.Web

Почему SnapForge?

SnapForge намеренно маленький и сфокусированный. Он нужен разработчикам, которым нужен быстрый и воспроизводимый способ делать аккуратные визуалы проекта без ручной работы в редакторе дизайна.

План развития

• CLI-команда card
• темы light и dark
• пресеты github, social, portfolio, open-graph, slide, slide-4-3
• экспорт PNG
• JSON-конфиги
• пакетная генерация
• локальный веб-интерфейс, запускаемый через exe
• переключение языка в веб-интерфейсе
• CI и релизные архивы
• контрольные суммы для релизных файлов
• публикация в NuGet
• дополнительные шаблоны макета

Сделано на C# и .NET

SnapForge построен на .NET 8, C#, Spectre.Console, Spectre.Console.Cli, SixLabors.ImageSharp, SixLabors.ImageSharp.Drawing, ASP.NET Core Razor Pages и xUnit.

Лицензия

SnapForge распространяется по лицензии MIT. См. LICENSE.