Novelty

モダンで、シンプルに。そして透明性高く。

「小説家になろう」「カクヨム」の作品を読むためにゼロから再設計された、Flutter製のクロスプラットフォーム小説ビューアーです。

概要

Noveltyは、最高の読書体験を提供するために開発された、小説家になろう・カクヨムに対応したクライアントアプリケーションです。 オフラインファーストの設計思想に基づき、ネットワーク接続が不安定な環境や圏外でも、保存されたライブラリからストレスなく読書を継続できます。

サイト抽象レイヤー（NovelSource / NovelSite）により、なろう・カクヨムを同じ操作感で利用でき、 将来のプロバイダ追加にも対応しています（docs/architecture/multi_provider.md）。

複雑な要求や機能を削ぎ落とし、読書に集中できるシンプルさを追求しながら、現代の読書スタイルに求められる必須機能を備えています。

主な機能

読書体験の追求

• 縦書き・横書きの完全対応: 日本語の小説に最適な縦書き表示をサポートしています。好みに合わせて横書きへの切り替えも瞬時に行えます。
• 詳細なカスタマイズ: フォントサイズ、フォントの種類、行間などを自由に調整し、自分だけの最適な読書環境を構築できます。

快適な作品探索

• ランキング機能: なろう・カクヨムのプロバイダ切替に対応。各サイトのランキング種別（日間・週間・月間など）から人気の作品を簡単に見つけられます。
• 高度な検索: キーワード、ジャンル、文字数、完結区分など、詳細な条件を指定して作品を検索可能です（なろう）。カクヨムはキーワード検索に対応しています。

ライブラリとデータ管理

• オフライン閲覧: 徹底したオフラインファースト設計により、作品を一度ダウンロードすれば、通信環境に依存せずいつでもどこでも読書を楽しめます。
• 閲覧履歴の自動同期: 読書の進捗は自動的に記録され、どこまで読んだかを忘れることはありません。
• バックアップと復元: ライブラリや履歴データをファイルとしてエクスポート・インポートする機能を搭載しており、機種変更時も安心です。

プライバシーとセキュリティ

• 最小限の権限: ユーザーのプライバシーを最大限尊重するため、アプリケーションデータのバックアップおよび復元に必要なファイルアクセス権限以外、一切のデバイス権限（カメラ、位置情報、連絡先、マイクなど）を要求しません。

技術スタック

本アプリケーションは、モダンで堅牢な技術選択に基づき開発されています。

• Framework: Flutter
• Language: Dart
• State Management: Riverpod
• Routing: GoRouter
• Database: Drift (SQLite)
• API Client: Dio
• CI/CD: GitHub Actions

開発環境のセットアップ

前提条件

• Flutter (stable channel)

インストール手順

1. リポジトリのクローン

   git clone https://github.com/L4Ph/Novelty.git
   cd Novelty
   

2. 依存関係のインストール

   flutter pub get
   

3. コード生成の実行

   dart run build_runner build -d
   

アプリケーションの実行

flutter run

APIとドキュメント

本プロジェクトが利用するAPIや、データ構造に関するドキュメントはリポジトリ内に含まれています。

• なろう小説API (小説情報・ランキング)
• なろう小説HTML構造 (トップページ・本文ページ)

コントリビューション

バグ報告、機能提案、プルリクエストなど、あらゆるコントリビューションを歓迎します。

ライセンス

• アプリケーション本体: PolyForm Noncommercial 1.0.0
  • 非商用利用に限り、自由な再配布、改変を許可します。
• packagesディレクトリ: MIT License
  • 商用利用を含む自由な利用が可能です。

---

「小説家になろう」は株式会社ヒナプロジェクトの登録商標です。本アプリは非公式のクライアントアプリです。