Skip to content

rock-hill/random-cat

Repository files navigation

Random Cat

ランダムに猫の画像を表示するシンプルで楽しい Next.js アプリケーションです。

📋 プロジェクト概要

このプロジェクトは、公開 API から猫の画像をランダムに取得して表示します。Next.js と React の基本的な使い方を学ぶのに最適なチュートリアルアプリケーションです。

デモ: https://random-cat-seven-gamma.vercel.app

🚀 はじめに

前提条件

以下がインストールされていることを確認してください:

  • Node.js: v18 以上
  • npm: v9 以上(または yarn、pnpm、bun)

インストール手順

  1. リポジトリをクローン
git clone <repository-url>
cd random-cat
  1. 依存パッケージをインストール
npm install
  1. 環境変数を設定(必要な場合)

.env.local ファイルをプロジェクトルートに作成します:

# .env.local
# 必要な環境変数を追加してください

: このプロジェクトでは特に必須の環境変数はありませんが、API キーが必要になった場合はここに記述します。

  1. 開発サーバーを起動
npm run dev

ブラウザで http://localhost:3000 を開くと、アプリケーションが表示されます。

📁 プロジェクト構成

random-cat/
├── app/                    # Next.js App Router
│   ├── page.tsx           # ホームページ
│   ├── layout.tsx         # ルートレイアウト
│   └── globals.css        # グローバルスタイル
├── public/                # 静的ファイル
├── .env.local             # 環境変数(.gitignore で除外)
├── package.json           # プロジェクト設定
├── next.config.ts         # Next.js 設定
└── tsconfig.json          # TypeScript 設定

🛠️ 利用可能なコマンド

コマンド 説明
npm run dev 開発サーバーを起動(ホットリロード対応)
npm run build 本番用にビルド
npm start 本番サーバーを起動
npm run lint ESLint で静的解析を実行

📚 技術スタック

🔧 環境変数の設定(詳細ガイド)

基本的な流れ

  1. プロジェクトルートに .env.local ファイルを作成
touch .env.local
  1. 必要な環境変数を追加
# 例:API キーが必要な場合
NEXT_PUBLIC_API_URL=https://api.example.com
NEXT_PUBLIC_API_KEY=your_api_key_here

# 次のような接頭辞の使い分けに注意
# - NEXT_PUBLIC_: ブラウザで使用される(フロントエンド)
# - それ以外: サーバーのみで使用(バックエンド)
  1. コード内で使用
// ブラウザで安全に使用可能
const apiKey = process.env.NEXT_PUBLIC_API_KEY;

本番環境への設定

Vercel でホストされている場合:

  1. Vercel ダッシュボード にアクセス
  2. プロジェクトを選択 → Settings
  3. Environment Variables から環境変数を追加
  4. 自動的にデプロイが再実行されます

📖 学習リソース

Next.js についてもっと学びたい方:

🚢 デプロイ方法

Vercel へのデプロイ(推奨)

最も簡単にデプロイできます:

  1. Vercel にアクセス
  2. GitHub リポジトリを接続
  3. デフォルト設定でデプロイ

自動的に本番環境が構築され、Git にプッシュするたびに自動デプロイされます。

その他のホスティングサービス

Next.js デプロイメントドキュメント を参照してください。

💡 トラブルシューティング

ポート 3000 が既に使用されている場合

npm run dev -- -p 3001

別のポートで起動できます。

環境変数が反映されない場合

  1. .env.local ファイルが作成されているか確認
  2. 開発サーバーを再起動(Ctrl+C で停止 → npm run dev で再起動)
  3. ブラウザのキャッシュをクリア

📝 ライセンス

このプロジェクトは MIT License の下で公開されています。

🤝 フィードバック

バグレポートやご質問は、GitHub Issues で報告してください。


Acknowledgments (謝辞)

このプロジェクトは、サバイバルTypeScript のチュートリアル 「Next.jsで猫画像アプリを作ろう」 を参考に作成しました。

Happy Coding! 🎉

About

The Cat APIを使った、癒やしの猫画像表示アプリ🐱

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published