Skip to content

MaxGog/characterbook

Repository files navigation

Flutter Dart License

🎭 CharacterBook

Кроссплатформенное приложение для создания и управления персонажами в настольных RPG.

Хотите организовать всех своих персонажей и NPC в одном месте? CharacterBook поможет вам быстро создать детализированного персонажа с помощью гибких шаблонов, структурировать его по папкам и тегам, а затем экспортировать в красивый PDF-лист.

Google Play Microsoft Store GitHub Release

✨ Ключевые возможности

  • 🎲 Гибкое создание персонажей: Используйте встроенные шаблоны (D&D 5e, универсальный) или создавайте свои с помощью конструктора!
  • 🗂️ Удобная организация: Раскладывайте персонажей по папкам, добавляйте теги и используйте поиск для быстрого доступа
  • 📄 Экспорт в PDF и Word: Превращайте ваших персонажей, расы и шаблоны в готовые листы (PDF) или редактируемые документы (DOCX) в один клик
  • 📱 Кроссплатформенность: Приложение одинаково хорошо работает на Android, Windows и macOS. Версии для Web и iOS в разработке.
  • 💯 Бесплатно и без рекламы: Все функции доступны без ограничений и скрытых платежей

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

📥 Для пользователей

Просто скачайте приложение из удобного для вас магазина:

Платформа Ссылка
Android Google Play или RuStore
Windows Microsoft Store или GitHub Releases
macOS GitHub Releases (бета-версия)

🛠️ Для разработчиков

Чтобы собрать и запустить проект локально:

  1. Клонируйте репозиторий:
    git clone https://github.com/maxgog/characterbook.git
    cd characterbook
  2. Установите зависимости:
    flutter pub get
  3. Запустите приложение:
    flutter run

Для получения подробной информации ознакомьтесь с нашим руководством по установке.

🧱 Технологический стек

  • Фреймворк: Flutter (3.13+).
  • Язык: Dart (3.7+).
  • База данных: Hive для быстрого локального хранения.
  • Управление состоянием: Provider и flutter_bloc.
  • Генерация документов: Пакеты pdf, printing и docs_gee для создания PDF и DOCX-файлов.

Для ознакомления с полным списком зависимостей и архитектурой проекта обратитесь к файлу ARCHITECTURE.md.

👥 Внесение вклада

Приветствуются любые предложения и помощь в развитии проекта! Пожалуйста, ознакомьтесь с CONTRIBUTING.md для получения информации о том, как сообщать об ошибках, предлагать улучшения и отправлять Pull Request.

⚖️ Лицензия

Распространяется под лицензией GNU General Public License v3.0. Подробнее см. в файле LICENSE.

💖 Поддержка проекта

Если вам нравится CharacterBook, вы можете поддержать его разработчика:

Boosty

📞 Контакты


⭐ Не забудьте поставить звезду репозиторию, если проект вам понравился!