homupe - Drop files, get a website

特徴

ファイルを置くだけ — HTML/CSS/JS/画像をアップロードするだけで公開
サブドメイン自動割り当て — {site}-{user}.homupe.dev
JSX静的ビルド — pages/ に .jsx を置くと ono で自動ビルド
デスクトップアプリで自動同期 — ~/homupe を監視してDropbox的に同期
.homupeignore — 公開したくないファイルをパターンで除外

クイックスタート

Googleでログイン

上の「Googleで始める」からアカウントを作成し、ダッシュボードでクレデンシャルをコピー。

デスクトップアプリで接続

Electronアプリを起動し、クレデンシャルを貼り付けて接続。~/homupe フォルダの監視が自動で始まります。

ファイルを置くだけ

# 静的サイト
~/homupe/mysite/index.html

# JSXサイト（ono で自動ビルド）
~/homupe/mysite/pages/index.jsx

公開！

https://mysite-you.homupe.dev でアクセスできます。

デスクトップクライアント

Electronアプリが ~/homupe フォルダを監視し、変更を自動で同期します。

フォルダごとに独立したサイトとして公開（~/homupe/mysite/ → mysite-you.homupe.dev）
ファイルの作成・変更・削除を即座に反映
サイトはフォルダを作るだけで自動作成

JSX静的ビルド（ono連携）

サイトフォルダ内に pages/ ディレクトリを作り .jsx ファイルを置くと、ono で自動ビルドされ静的HTMLとしてアップロードされます。

プロジェクト構造

~/homupe/mysite/
├── pages/
│   ├── index.jsx     → index.html として公開
│   └── about.jsx     → about.html として公開
├── components/       → 再利用可能コンポーネント
├── public/           → 静的ファイル（そのままコピー）
└── uno.config.js     → UnoCSS設定（任意）

書き方

// pages/index.jsx
export default function Page() {
  return (
    <html>
      <head>
        <title>My Site</title>
        <link rel="stylesheet" href="/uno.css" />
      </head>
      <body>
        <h1 class="text-3xl font-bold">Hello!</h1>
      </body>
    </html>
  );
}

デスクトップクライアントが pages/ を検出すると ono build を自動実行し、dist/ の中身をアップロードします。UnoCSS も自動生成されます。

.homupeignore

プロジェクトルートに置くと、マッチするファイルが非公開に。CLIでのアップロードとサーバー配信の両方で適用されます。

*.env
secrets/
_draft/
*.bak

対応パターン: *（ワイルドカード）、**（再帰）、末尾 /（ディレクトリ）。

APIリファレンス

認証が必要なエンドポイントは Authorization: Bearer <token> ヘッダーを付けてください。

認証

メソッド	パス	説明
`GET`	`/auth/google`	Googleログイン（OAuth開始）
`GET`	`/auth/me`	ログインユーザー情報
`GET`	`/auth/tokens`	トークン一覧
`DELETE`	`/auth/tokens/:id`	トークン削除

サイト

メソッド	パス	説明
`GET`	`/sites`	サイト一覧
`POST`	`/sites`	サイト作成
`DELETE`	`/sites/:name`	サイト削除

ファイル

メソッド	パス	説明
`GET`	`/files/:site`	ファイル一覧（?type=published\|source）
`GET`	`/files/:site/download/<path>`	ファイルダウンロード
`PUT`	`/files/:site/<path>`	ファイルアップロード（?type=published\|source）
`DELETE`	`/files/:site/<path>`	ファイル削除

username は小文字英数字のみ（ハイフン不可）。サイト name は小文字英数字とハイフン。

URL構成

URL	内容
`homupe.dev`	このページ
`api.homupe.dev`	API
`{user}.homupe.dev`	ユーザーのサイト一覧
`{site}-{user}.homupe.dev`	サイト本体

技術スタック

Cloudflare Workers — ルーティング・API
Cloudflare R2 — ファイルストレージ
Cloudflare D1 — メタデータDB
Hono — Webフレームワーク
Electron — デスクトップクライアント
ono — JSX静的サイトジェネレーター