プログラマーのポートフォリオ例と作り方|載せるもの・READMEの見本・GitHubでの公開手順

プログラマーのポートフォリオは、自分で作ったアプリやツールを1〜3個、動くデモとGitHubのソースコード、READMEの説明をそろえて見せるのが基本です。未経験なら規模より「なぜ作り、何を工夫し、どう解決したか」を説明できることが評価の材料になります。

この記事では、職種別の作品の例、READMEの見本、GitHubのプロフィールやGitHub Pagesで公開する手順、公開前のチェックまでを、具体的な形で示します。ポートフォリオでやりがちな失敗の全体像は「そのポートフォリオは意味がない!制作時の致命的な注意点」、作品のレベルが低いと感じている方は「エンジニアのポートフォリオはレベルが低くても大丈夫」もあわせてご覧ください。

プログラマーのポートフォリオに載せるもの

デザイナーのポートフォリオが「見た目の作品集」なのに対し、プログラマーのポートフォリオは「作ったものと、その作り方」を見せるものです。最低限、次の4つをそろえます。

載せるもの 中身 置き場所の例
作品 自分で作ったアプリ・ツール・ゲームを1〜3個 公開したURL、実行ファイル
ソースコード 作品のコード一式と、変更の履歴 GitHubのリポジトリ
作品の説明 作った理由、使った技術、工夫、苦労と解決、動かし方 各リポジトリのREADME
自己紹介 名前、学んできたこと、使える言語、連絡先 GitHubのプロフィールREADME、自作サイト

数を増やすより、1つの作品を説明できる状態にするほうが大切です。面接では「なぜこの技術を選んだのか」「一番苦労したところは」と聞かれることが多く、READMEに書いた内容がそのまま答えの準備になります。

職種別:ポートフォリオの作品の例

目指す仕事に近いものを作ると、見る側が「入社後に何ができそうか」を想像しやすくなります。以下は題材の例です。

目指す職種 作品の例 見せたいところ
Webアプリ(バックエンド) ログイン付きの家計簿、予約管理、掲示板 データベースの設計、ログイン、他人のデータを見せない仕組み、テスト
Webアプリ(フロントエンド) 天気や路線などの公開APIを使った検索画面 画面の操作感、スマホ表示、読み込み中やエラーの表示
業務システム・社内SE ExcelやCSVの集計を自動化するツール どんな手作業をどれだけ減らせるか、入力ミスへの備え
データ分析・機械学習 公開データを分析したノートブック、予測モデル データの前処理、評価の方法、結果の読み取り
ゲームプログラマー UnityやUnreal Engine、Pythonで作った遊べるゲーム 操作の気持ちよさ、当たり判定や敵の動きなど自分で書いた処理

教材やチュートリアルで作ったものを載せる場合は、そのまま載せず、自分で足した機能や変えた点をREADMEに書き分けます。どこからが自分の工夫かが分かれば、教材が元でも評価の材料になります。

READMEの見本:1作品の説明はこう書く

GitHubのドキュメントによると、READMEはリポジトリを訪れた人が最初に目にすることが多いファイルで、プロジェクトが何をするのか、なぜ役に立つのか、どう使い始めるのかを伝える場所です。ポートフォリオでは、これに「作った理由」と「工夫・苦労」を足します。

# 家計簿アプリ(Flask)

レシートの金額を入力すると、月ごと・費目ごとの支出をグラフで表示するWebアプリです。

## デモ
https://(公開したURL)
テスト用アカウント:(閲覧専用のものを用意)

## 作った理由
手書きの家計簿が続かなかったので、入力を3項目に絞ったものを自分用に作りました。

## 使った技術
- Python 3.12 / Flask
- SQLite(開発)/ PostgreSQL(本番)
- Chart.js

## 工夫したところ
- 費目の集計をSQLのGROUP BYで行い、画面の表示を速くした
- ログインしていない人は他人のデータを見られないことをテストで確認した

## 苦労したところと解決方法
- 日付のタイムゾーンがずれて月の集計が合わなかった → 保存はUTC、表示で日本時間に変換

## 動かし方
pip install -r requirements.txt
flask run

## これから足したいこと
- CSVの読み込み

ポイントは3つです。

  • デモはすぐ触れるようにする:ログインが必要なら、閲覧用のテストアカウントを書いておく
  • 工夫は具体的に書く:「使いやすくした」ではなく「入力を3項目に絞った」のように何をしたかを書く
  • 苦労と解決をセットで書く:つまずいた原因と直し方が書いてあると、調べて解決する力が伝わる

GitHubでポートフォリオを公開する手順

1. プロフィールREADMEに作品の一覧を書く

GitHubのドキュメントによると、自分のユーザー名と同じ名前のパブリックリポジトリを作り、その直下にREADME.mdを置くと、内容がプロフィールページに表示されます(2026年10月18日確認)。ここに自己紹介と作品の一覧(作品名、ひとこと説明、デモとリポジトリへのリンク)を書けば、GitHubのページ自体がポートフォリオになります。

2. 必要ならGitHub Pagesでサイトを公開する

見た目も整えたい場合は、GitHub Pagesが手軽です。HTML・CSS・JavaScriptのファイルをリポジトリから直接公開できる静的サイトのホスティングで、<ユーザー名>.github.ioという名前のリポジトリに置くと、https://<ユーザー名>.github.ioで公開されます。サーバーで動くアプリ(FlaskやRailsなど)はGitHub Pagesでは動かないので、デモは別のサービスで公開し、Pagesには一覧と説明を置く形になります。

3. 公開前に、入れてはいけないものを確認する

一番の事故は、APIキーやパスワードを公開してしまうことです。GitHubのドキュメントによると、シークレットをパブリックリポジトリにプッシュするのを止める「ユーザーのプッシュ保護」が既定で有効になっていますが、これに頼らず自分でも確認します。次のPythonスクリプトは、READMEと.gitignoreがあるか、鍵らしき文字列や.envファイルが残っていないかを調べる簡単な例です。

"""公開前に、リポジトリに入れてはいけないものが残っていないか調べる"""
import re
import sys
from pathlib import Path

SUSPICIOUS = [
    (re.compile(r"(api[_-]?key|secret|password|token)\s*[:=]\s*['\"]?\w{8,}", re.I), "鍵・パスワードらしき値"),
    (re.compile(r"sk-[A-Za-z0-9_-]{16,}"), "APIキーらしき文字列"),
]
MUST_HAVE = ["README.md", ".gitignore"]

root = Path(sys.argv[1])
for name in MUST_HAVE:
    if not (root / name).exists():
        print(f"[不足] {name} がありません")

for path in sorted(root.rglob("*")):
    if path.is_dir() or ".git" in path.parts:
        continue
    if path.name == ".env":
        print(f"[注意] {path.relative_to(root)}: .env は公開しない(.gitignore に追加)")
        continue
    text = path.read_text(encoding="utf-8", errors="ignore")
    for no, line in enumerate(text.splitlines(), 1):
        for pattern, label in SUSPICIOUS:
            if pattern.search(line):
                print(f"[注意] {path.relative_to(root)}:{no}: {label}")
print("チェック完了")

READMEはあるが.gitignoreが無く、コードにキーを直接書き、.envも置いたままのフォルダで実行した結果です(Python 3.12)。

[不足] .gitignore がありません
[注意] .env: .env は公開しない(.gitignore に追加)
[注意] app.py:2: 鍵・パスワードらしき値
チェック完了

キーはコードに直接書かず、環境変数や.envから読み込み、.envは.gitignoreに入れて公開しないのが基本です。簡易的なチェックなので、見つからなかったから安全とは言えません。公開前にファイルの一覧を自分の目でも確かめてください。

ゲームプログラマーのポートフォリオで気をつけること

ゲーム会社では、書類選考の段階で作品の提出を求めることがあります。たとえばセガの新卒採用の募集要項では、2027年度新卒採用のプログラマの選考フローに「書類選考(適性検査/エントリーシート/職種別ES/作品・ポートフォリオ提出)」と書かれています(2026年10月18日確認)。提出の形式や締め切りは会社と年度で違うので、応募先の募集要項を必ず確認してください。

  • すぐ遊べる形で出す:実行ファイルやブラウザで動く版を用意し、動かない環境に備えてプレイ動画も付ける
  • 自分が書いた処理を示す:ゲームエンジンの機能と、自分で書いたコード(キャラクターの動き、当たり判定、敵の思考など)を分けて説明する
  • チーム制作は担当を明記する:どの部分を自分が作ったのかを書く
  • 素材の権利を確認する:画像や音楽の素材は利用規約を守り、出典をREADMEに書く

新卒・転職・フリーランスで変わること

同じ作品でも、立場によって見られるところが変わります。

立場 見られやすいところ 詳しい記事
未経験・新卒 自分で調べて完成させたか、伸びしろ この記事
転職(経験者) 実務での役割と成果、守秘義務の扱い 転職のポートフォリオの作り方
フリーランス 案件に近い実績、納品できる範囲 フリーランスエンジニアのポートフォリオの作り方

ひとりで作品を作っていると、エラーで何日も止まることがあります。テックジムは対面・通学型のプログラミングスクールで、自分のペースで課題を進めながら、詰まったところをその場でトレーナーに質問できます。料金は入会金33,000円+月額22,000円の通い放題(学生は月額16,500円)で、まずは無料Python講座・Claude Code講座から試せます。

まとめ

  • 作品・ソースコード・作品の説明・自己紹介の4つをそろえる
  • 作品は目指す職種に近い題材で1〜3個。規模より説明できることを重視する
  • READMEには作った理由、技術、工夫、苦労と解決、動かし方を書く
  • GitHubのプロフィールREADMEやGitHub Pagesで公開し、キーやパスワードを公開しない
  • ゲーム会社などは作品の提出方法が決まっているので、募集要項で確認する

よくある質問

Q. プログラマーのポートフォリオには何を載せればいいですか?

自分で作ったアプリやツールを1〜3個と、それぞれの説明(何のために作ったか、使った技術、工夫したところ、苦労と解決方法)です。動くデモのURLとGitHubのソースコードを並べ、READMEに説明を書いておくと、見る人が短い時間で中身を確かめられます。

Q. 未経験でポートフォリオに載せる作品が思いつきません。

自分や身近な人が困っていることを小さく解決するものから始めるのが確実です。家計簿、勉強時間の記録、Excel作業の自動化など、作った理由を自分の言葉で説明できる題材なら、規模が小さくても話の材料になります。教材の課題をそのまま載せる場合は、自分で足した機能や変えた点を書き添えます。

Q. ポートフォリオサイトは自作しないといけませんか?

必須ではありません。GitHubのプロフィールREADMEに作品の一覧を書き、各リポジトリのREADMEで説明する形でも十分に伝わります。自作する場合は、GitHub Pagesを使うと「ユーザー名.github.io」のURLで静的なサイトを公開できます。

Q. ゲームプログラマーのポートフォリオは何が違いますか?

実際に遊べるもの(実行ファイルやブラウザで動くもの)と、プレイ動画、担当した部分の説明が中心になります。新卒採用で作品・ポートフォリオの提出を求める会社もあり、たとえばセガの2027年度新卒採用ではプログラマの書類選考で作品・ポートフォリオの提出が必要とされています。提出の形式は会社ごとに違うので、必ず募集要項で確認してください。

Q. GitHubに公開するときに気をつけることは?

APIキーやパスワード、.envファイルなどを公開しないことです。GitHubには、シークレットをパブリックリポジトリにプッシュするのを止める機能が既定で有効になっていますが、それに頼らず、.gitignoreで除外し、公開前に自分でも確認してください。

あわせて読みたい

対面・無料|東京・永田町で毎週土曜日13時

1回の参加で、プログラミングの構造がわかる

ゼロからはじめるPython入門講座

8年間・累計600回開催/これまで全国で2万人以上が参加

「やはり対面で聞けるのはとても気づきがあり、価値があると思います」

参加者の声

  • 本当に初心者からの講座です。プログラミングに触ったことがなくて大丈夫です
  • 対面だから、その場で聞けます。つまずいた所を持ち帰らずに解決できます
  • 講座は1時間。そのあとも残って学習を続けられ、講師にも質問できます
  • 独学で挫折した方も。糸口が見つかって、講座のあと会員になる方が多くいます

無料で参加する|開催日程を見る

参加費は無料です