Rails 8 読書ログアプリ スターターテンプレート

📚 ミニ読書ログアプリ — Rails 8 スターターテンプレート

**「未読・読書中・読了」でステータス管理できる、シンプルな読書記録アプリ。**

enumやActive Storageの使い方を実装ごと確認できます。

---

## こんな人におすすめ

- Railsチュートリアルを終えて、自分でアプリを作ってみたい方

- enumを使ったステータス管理・画像アップロードの実装を参考にしたい方

- AIを使った開発のベースコードとして使いたい方

- AIと壁打ちしながら開発を進めたい方

- 余計な機能がなく、読みやすいコードを求めている方

---

## 含まれる機能

| 機能 | 内容 |

|------|------|

| 認証 | Deviseによるログイン・新規登録（日本語化済み） |

| 読書ログのCRUD | タイトル・著者・ステータス・読み始め日・読了日・感想・表紙画像 |

| ステータス管理 | 未読・読書中・読了をenumで管理 |

| 表紙画像アップロード | Active Storageを使った画像添付 |

| ダッシュボード | ステータス別冊数・読了率バー・最近追加した本 |

| 検索・絞り込み | キーワード・ステータスで絞り込み |

| CSVエクスポート | 検索結果をそのままダウンロード |

| ページネーション | 10件ずつ表示（Kaminari） |

| レスポンシブ対応 | PC・スマホどちらでも使えるUI |

---

## セットアップは3ステップで完了

```bash

bundle install

bin/rails db:create db:migrate db:seed

bin/rails server

```

`http://localhost:3000` を開くと、すぐにサンプルデータ入りで動きます。

（テストアカウント：[email protected] / password123）

詳細なセットアップ手順・動作環境の前提条件は、同梱の **README.md** をご確認ください。

---

## 技術スタック

- Ruby on Rails 8.1

- SQLite3

- Tailwind CSS（CDN）

- Active Storage（画像管理）

- Devise（認証）

- Kaminari（ページネーション）

- RSpec + FactoryBot（テスト）

---

## 購入後に届くもの

- ソースコード一式（zip）

- seedデータ付き（未読・読書中・読了のサンプル本27冊）

---

## ライセンス

- 個人・商用利用：✅ OK

- 改変・改変後の販売：✅ OK

- そのままの再配布・転売：❌ NG

---

## サポート

動作しない場合はX（Twitter）のDMからお気軽にどうぞ。

回答に時間がかかる場合があります。あらかじめご了承ください。

動かない場合はまずAIに聞いてみるのもおすすめです。意外と解決します。