Day 90:最終完成・公開
Day 90では、最終制作アプリの機能やエラーを確認し、GitHubへ保存して、READMEを整え、必要ならWeb上に公開します。ここでの完成は「コードを書き終えた状態」ではなく、初めて使う人がアプリの目的を理解し、基本操作を試せる状態にすることです。
この教材では、これまでの例に合わせて「学習管理アプリ」を使います。GitHubへコードを保存することと、アプリをWeb上で公開することは別の作業です。公開しない場合も、GitHubのリポジトリとREADMEを整えるところまで進めれば、成果物を共有しやすくなります。
ステップ1:公開する前に完成範囲を確認する
まず、Day 81で決めたアプリの目的と完成条件を読み返します。追加機能を増やすより、最初に約束した機能が正しく動くことを優先します。
- アプリの目的を、短く説明できますか。
- 最初の完成版に入れると決めた機能はすべて動きますか。
- 未完成の機能や、正しく動かない機能を把握していますか。
- 公開するコードや画面に、個人情報や秘密情報が含まれていませんか。
未完成の機能を無理に完成したように見せるのではなく、READMEに「今後追加したい機能」として明記する方法もあります。
ステップ2:機能を一通りテストする
アプリを初めて使う人になったつもりで、画面を最初から操作します。基本機能だけでなく、入力エラーや検索結果がない状態も確認します。
| 確認対象 | テストする操作 | 期待する結果 |
|---|---|---|
| 追加 | 学習内容、時間、日付を入力して記録 | 一覧と合計時間が更新される |
| 入力確認 | 学習内容を空欄にして送信 | 案内が表示され、空の記録は追加されない |
| 入力確認 | 時間に0や不正な値を入力 | 案内が表示され、記録は追加されない |
| 編集 | 記録の内容を変更して更新 | 対象の記録だけが更新される |
| 削除 | 記録を削除 | 確認後に一覧と合計が更新される |
| 検索・フィルター | 語句や期間を指定 | 条件に合う記録だけが表示される |
| 保存 | ページを再読み込み | 保存した記録や設定が読み込まれる |
| 空の状態 | 記録をすべて削除 | 次の操作が分かる案内が表示される |
検索結果が0件の状態と、アプリに記録が1件もない状態は別です。それぞれに合ったメッセージが表示されるかも確認しましょう。
ステップ3:画面とブラウザーのエラーを確認する
ブラウザーでアプリを開き、開発者ツールのConsoleを確認します。赤いエラーが表示されていないかを見て、エラーがあれば上から一つずつ解決します。HTMLやCSSのパス、JavaScriptの読み込み、要素のidの誤記などがよくある原因です。
- 画面の文字やボタンが重なったり、画面外にはみ出したりしていませんか。
- スマートフォン程度の幅でも、フォームや一覧を操作できますか。
- キーボードのTabキーで入力欄やボタンを選べますか。
- エラーメッセージが具体的で、修正方法を想像できますか。
- 入力された文字をHTMLとして実行させず、文字列として表示していますか。
特に、利用者が入力した内容を一覧に表示する部分では、textContentなどの安全な表示方法を使います。入力値をHTML文字列として直接挿入しないようにします。
ステップ4:公開してはいけない情報がないか確認する
GitHubのリポジトリを公開設定にする場合、コードやファイルを多くの人が閲覧できる可能性があります。公開前に、次のような情報が含まれていないか確認します。
- APIキーやアクセストークン
- パスワードや認証情報
- 個人のメールアドレスや電話番号
- 個人情報を含むテストデータ
- 端末内だけで使うつもりだった設定ファイル
秘密情報をコードから削除しても、過去のコミットに残っている場合があります。秘密情報を誤って公開した場合は、単にファイルから消すだけでなく、利用先でそのキーを無効化・再発行するなど、サービスの案内に従って対応します。
ステップ5:GitHubへ保存する
GitHubは、コードの変更履歴を保存し、ほかの人と共有できるサービスです。まずGitHub上で新しいリポジトリを作成し、プロジェクトのファイルを登録します。
Gitがインストールされ、コマンドを使える環境では、プロジェクトのフォルダーで次のように操作できます。your-repository-urlの部分は、GitHubが作成後に表示する実際のリポジトリURLに置き換えてください。
# このフォルダーをGitで管理し始める
git init
# 変更したファイルを登録対象にする
git add .
# 現在の状態を履歴として保存する
git commit -m "Complete study tracker app"
# GitHub上のリポジトリを接続先として登録する
git remote add origin your-repository-url
# mainブランチの内容をGitHubへ送る
git branch -M main
git push -u origin main
GitHubの画面からファイルをアップロードする方法もあります。どちらの場合も、アップロード後にリポジトリを開き、index.html、CSS、JavaScript、READMEなど必要なファイルがそろっているか確認します。
ステップ6:READMEを作成する
READMEは、リポジトリを開いた人に「このアプリは何か」「どう使うか」を伝える説明書です。プロジェクトのルートにREADME.mdを作成し、次の内容を記載します。
- アプリ名と概要
- 主な機能
- 使い方
- 使った技術
- ローカルでの起動方法
- 公開版へのリンク(公開した場合)
- 現在の制限や、今後追加したい機能
学習管理アプリのREADME例です。実際のアプリの内容に合わせて、文章や機能を調整してください。
# 学習管理アプリ
学習した内容と時間を記録し、履歴を振り返るためのWebアプリです。
## 主な機能
- 学習記録の追加・一覧表示・編集・削除
- 学習内容やメモの検索
- 期間による絞り込み
- 学習日の並べ替え
- ダークモード
- ブラウザー内への記録保存
## 使い方
1. 学習内容、学習時間、学習日を入力します。
2. 「記録する」ボタンを押します。
3. 登録した記録を一覧で確認します。
4. 必要に応じて、編集・削除・検索を行います。
## 使用技術
- HTML
- CSS
- JavaScript
- localStorage
## 起動方法
`index.html`をブラウザーで開いてください。
ES Modulesを利用している場合は、ローカル開発サーバーから開いてください。
## データについて
学習記録は、利用しているブラウザーのlocalStorageに保存されます。
別の端末やブラウザーとの自動同期には対応していません。
## 今後追加したい機能
- 学習記録の編集履歴
- 月ごとの学習時間表示
「使用技術」や「機能」は、実際に作ったものだけを記載します。実装していない機能をREADMEに書かないようにしましょう。
ステップ7:必要な場合はGitHub Pagesで公開する
HTML、CSS、JavaScriptで作った静的なアプリなら、GitHub Pagesを公開先の候補にできます。GitHub Docsでは、ブランチとフォルダーを公開元に設定する方法や、GitHub Actionsを使う方法が案内されています。(🔗 docs.github.com)
基本的な流れは次のとおりです。
- アプリのファイルをGitHubリポジトリへ保存します。
- リポジトリのSettingsからPagesの設定を開きます。
- 公開元としてブランチを選び、公開するフォルダーを指定します。
- 保存後、公開状態になったことを確認します。
- 表示された公開先を開き、実際にアプリを操作します。
ブランチから公開する場合は、公開したいブランチとフォルダーを設定します。サイトの入口になるindex.htmlは、選んだ公開元の一番上の階層に置きます。(🔗 docs.github.com)
設定変更やファイルのアップロード後、公開反映まで少し時間がかかることがあります。GitHub Docsのクイックスタートでは、公開まで最大10分かかる場合があると案内されています。(🔗 docs.github.com)
公開後は、リポジトリ内のファイルを確認するだけでなく、公開された画面も実際に操作します。公開先では、CSSやJavaScriptの読み込みパスがローカル環境と異なることがあるため、画面崩れやConsoleのエラーも確認してください。
ステップ8:アプリの説明を書く
アプリの説明は、利用者が「何ができるのか」をすぐ理解できるよう、目的、主な機能、保存方法を簡潔に書きます。
- 何のためのアプリかを最初の一文で伝えます。
- 主な機能を、利用者ができることとして説明します。
- データの保存場所や制限があれば明記します。
- 未対応の機能を、対応済みであるかのように書かないようにします。
説明文の例です。
学習管理アプリは、学習した内容や時間を記録し、履歴を検索・整理できるWebアプリです。記録は利用中のブラウザーに保存されるため、別の端末との自動同期には対応していません。
最終チェックリスト
公開前に、次の項目を一つずつ確認します。
- 追加・一覧表示・編集・削除が動きます。
- 検索、フィルター、並べ替えなど、実装した追加機能が動きます。
- 空入力や不正な値に対して適切な案内が表示されます。
- 記録がない場合や検索結果が0件の場合の表示があります。
- 再読み込み後も、保存する設計にしたデータが保たれます。
- スマートフォン程度の画面幅でも操作できます。
- 開発者ツールのConsoleに、解決していないエラーがありません。
- APIキーや個人情報など、公開できない情報が含まれていません。
- READMEにアプリの目的、機能、使い方、制限を記載しています。
- 公開した場合は、公開先で実際に操作を確認しています。
よくあるつまずき
- 公開先でCSSが読み込まれない場合は、`href`のパスやファイル名の大文字・小文字を確認します。
- JavaScriptが動かない場合は、`script`のパスとConsoleのエラーを確認します。
- 公開ページが見つからない場合は、Pagesの公開元と`index.html`の場所を確認します。
- ローカルでは動くのに公開先で動かない場合は、相対パス、モジュール読み込み、APIの接続先を確認します。
- 公開したデータが他の端末に出ない場合は、`localStorage`はブラウザーごとの保存であり、自動同期ではないことを確認します。
Day 90のゴール
- 完成条件に沿ってアプリの機能を確認できます。
- エラーや入力漏れを調べ、必要な案内を表示できます。
- ソースコードをGitHubのリポジトリへ保存できます。
- READMEでアプリの目的と使い方を説明できます。
- 必要に応じて公開し、公開先でも動作確認できます。
まとめ
Day 90では、アプリの全機能をテストし、エラーや公開前の情報漏れを確認してから、GitHubへ保存し、READMEを作成します。静的なWebアプリであれば、GitHub Pagesを公開先の候補にできます。公開後も、公開URLで実際に操作し、画面や機能が正しく動くことを確かめましょう。
90日間の最終制作では、すべての機能を盛り込むことより、決めた範囲を動く形で完成させ、ほかの人が理解して試せる状態にすることが大切です。完成したアプリとREADMEは、学習の成果を伝えるポートフォリオの一部にもなります。

