People 📇

English | 日本語

---

🇬🇧 English

Organize first, sync later. A smart relay hub for all your contacts.

People is a PWA application for temporarily storing and organizing business card data and community contacts that tend to get cluttered.

It rejects the "data siloing" caused by multi-functional contact management software. Instead, it functions as a "relay hub (pipe)" that allows you to cleanly organize data by company or group, export only what you need as vCard (.vcf) or CSV, and smoothly pass it to the standard address books of Mac, iPhone, and Windows.

Philosophy & Features

1. Ultimate Data Sovereignty (No SaaS, No Subscriptions): Your contact data is never sent to third-party servers. Everything is saved as a .people file in your local PC environment. All source code is open-source.
2. Serverless & Fully Offline (PWA): No PHP or database servers are required. Once installed as an app from your browser, it runs instantly with zero latency, even in offline environments.
3. Protected by File System Access API & Strong Encryption: When saving, it applies strong encryption using AES-256-GCM via the Web Crypto API. Even if the file is leaked, it can never be decrypted without the password. (Note: Data cannot be recovered if the password is lost. Chrome/Edge recommended for direct overwrite saving).
4. A "Relay Hub" Connecting to OS Standard Address Books (and QR Coder): Filter accumulated data by tags and bulk-export in vCard (.vcf) or CSV formats (Google/Outlook, plus dedicated QR Coder support). The detailed contact editor allows for granular data input compliant with vCard standards before exporting. Import the output file to integrate clean data into Apple, Google, or Microsoft contacts. When importing QR Coder history logs, it automatically merges the generation history into contact notes and appends the #QR-Exported tag.
5. BYO-AI (Bring Your Own AI) Approach: To maintain the "fully offline" constraint, it doesn't communicate with external AI APIs. Just copy the built-in prompt and pass it to ChatGPT or Claude to format messy text data (like copied tables or lists) into a clean CSV structure ready for import.
6. Block-Editor-Like Input Experience: Create parent blocks like "Acme Inc." and add members intuitively. Also supports bulk import by dragging and dropping .vcf or .csv files.
7. Ultra-Fast Input (Grind & Polish):
   • Smart Paste: Paste email signatures to automatically parse name, contact, and role.
   • Command Palette (Cmd+K): Access all functions entirely with the keyboard.
   • Markdown Export: Copy your filtered contact lists as clean Markdown instantly via the Command Palette, perfect for sharing in chat or pasting into LLMs.
   • Templates: Save frequently used block structures as templates.
8. Flexible Category Filters & Web Share API: Dynamic grouping by hashtags. Send vCard data directly via the OS share menu on mobile devices.
9. Multiplexed Local Auto-Save: Continuous draft saving via IndexedDB prevents data loss during browser crashes.
10. Comprehensive & Universal Data Structure: The detailed editing modal supports a wide range of fields, including phonetic names, multiple addresses, phone numbers, emails, and social media profiles, based on the vCard specification. The UI is fully internationalized for both English and Japanese. The UI includes a customizable role/title dictionary with drag-and-drop ordering to speed up manual entry.

Usage

1. Access index.html in an HTTPS environment or on localhost.
2. Install the app as a PWA from the browser's address bar.
3. Use it completely offline as a native-like application.

File Structure

• index.html: The main UI
• main.js: Application logic (Wasm SQLite control, encryption, vCard/CSV output)
• i18n.js, lang/: Internationalization modules
• styles.css: Styles generated by Tailwind CSS
• sw.js: Service Worker for PWA (full offline capability, cache management)
• manifest.json: PWA manifest

Disclaimer

This software adopts a "local-first" architecture. Automatic backups to external servers are not performed. The author assumes no responsibility for any data loss. Please back up your .people files to external storage regularly.

---

🇯🇵 日本語

まずは整理、同期は後で。すべての連絡先のためのスマートな中継ハブ。

People は、ごちゃごちゃになりがちな名刺データやコミュニティの連絡先（サークルのメンバーなど）を一時的にストック・整理するためのアプリです。

多機能な名刺管理ソフトによる「データのサイロ化（分断）」を否定し、会社やグループ単位で綺麗にクレンジング（整理）した上で、必要なデータだけを vCard (.vcf) や CSV でエクスポートし、MacやiPhone、Windowsの標準アドレス帳へスムーズにパス（連携）する「中継ハブ（土管）」 として機能します。

哲学と特徴

1. 究極のデータ主権 (No SaaS, No Subscriptions)

あなたの連絡先データは、決して他社のサーバーに送信されません。月額の「家賃」も発生しません。 すべてはあなたのPCのローカル環境に .people ファイルとして保存されます。 ソースコードはすべて公開（オープンソース）されており、外部への隠れた通信がないことを誰もが確認できます。

2. サーバーレス・完全オフライン動作 (PWA)

PHPもデータベースサーバーも不要です。 一度ブラウザから「アプリとしてインストール」を行えば、Wi-Fiがないオフライン環境（カンファレンス会場や体育館など）でも、遅延ゼロで瞬時に起動・動作します。

3. File System Access API & 強固な暗号化による保護

OSのローカルにあるデータベースファイルをブラウザから直接読み書きします。 保存時には Web Crypto API を用いた AES-256-GCM による強力な暗号化が施されるため、万が一ファイルが流出してもパスワードがない限り絶対に解読されません。

• 🚨 警告: パスワードを忘れた場合、暗号化の仕組み上、データの復元は技術的に100%不可能です。パスワードの管理には十分ご注意ください。
• 💡 推奨ブラウザ: 直接の上書き保存（File System Access API）をフルサポートしている Chrome または Edge のご利用を強く推奨します（Safari/Firefoxでは毎回ダウンロード保存となります）。

4. OS標準アドレス帳と繋がる「中継ハブ」機能

People自身は最終的な住所録になることを目指していません。溜まったデータは、タグやグループで絞り込み、vCard (.vcf) や 各種CSV（Google連絡先、Outlook対応、および「QR Coder」連携）形式で一括エクスポートが可能です。詳細編集モーダルで、氏名・住所・複数の電話番号やメールアドレスなどをvCard仕様に準拠した形で細かく入力・管理できます。出力されたファイルをダブルクリックしたり読み込ませるだけで、AppleやGoogle、Microsoftの標準連絡先にクリーンなデータが統合されます。さらに、QR Coderの履歴CSVをインポートした際は、QR生成履歴を自動でマージして「#QR発行済」タグを付与する高度な連携機能も備えています。

5. BYO-AI（Bring Your Own AI）アプローチ

「完全オフライン」の制約を守り抜くため、外部のAI APIとは直接通信しません。内蔵のプロンプトをワンクリックでコピーし、普段お使いの ChatGPT や Claude に渡すだけで、乱雑なテキストデータを整形して一括インポート用のCSVに変換できます。

6. ブロックエディタのような入力体験

Excelのようなレガシーな表入力ではなく、「株式会社〇〇」や「土曜Pickleballチーム」といった親ブロックを作り、その中にメンバーを所属させていく直感的でシームレスなUXを提供します。 また、vCard（.vcf）やCSVファイルの画面へのドラッグ＆ドロップによる一括インポートにも対応しており、既存データの取り込みも一瞬です。

7. 超高速入力とハッカーライクな操作性 (Grind & Polish)

• Smart Paste (署名スマート解析): メールなどの署名テキストを氏名欄にペーストするだけで、名前・連絡先・役職を自動で振り分けて入力します。
• コマンドパレット (Cmd+K / Ctrl+K): マウスを使わずに、あらゆる機能の呼び出しやメンバーのインクリメンタル検索にアクセスできます。
• Markdownエクスポート: 絞り込んだ連絡先の一覧を、コマンドパレットから一瞬でMarkdown形式としてクリップボードにコピー可能。チャットでの共有やLLMへの貼り付けに最適です。
• テンプレート機能: よく使うブロック構成をテンプレートとして保存し、いつでも一瞬で呼び出せます。

8. 柔軟なカテゴリフィルターとWeb Share API対応

数千人のデータが溜まっても安心です。左側の目次からのインクリメンタル検索や、ハッシュタグ（カテゴリ）による動的なグループ分けを搭載。すべてのUIが再読み込みゼロで連動します。 さらに、Web Share API に対応しており、スマートフォン等からワンタップでOSの共有メニューを通じてvCardデータを直接送信できます。

9. 多重化されたローカル・オートセーブ（データ保護）

タイピング中の非同期ドラフト保存（IndexedDB）に加え、タブを閉じる瞬間の強制バックアップ機能により、万が一ブラウザがクラッシュしても直前の入力データを安全に復元します。

10. 国際化対応とユニバーサルなデータ構造

詳細編集モーダルでは、vCard仕様に基づいたフリガナ、複数の住所・電話番号・メールアドレス、SNSプロフィールなど幅広いデータ入力に対応。UIは日本語と英語に完全対応しています。また、オートコンプリート用の「役職辞書」は設定画面から自由に編集・並び替え（ドラッグ＆ドロップ）が可能で、手入力のスピードをさらに引き上げます。

使い方

1. セキュリティの都合上、必ず HTTPS環境（GitHub Pages, Vercel等）またはローカルの localhost で index.html にアクセスしてください。
2. アドレスバーのアイコン、または画面のボタンから、PWAとして「アプリをインストール」します。
3. 以降はPCやスマートフォンのアプリケーションとして完全にオフラインで利用できます。

ファイル構成

• index.html : UI本体
• main.js : アプリケーションロジック（Wasm SQLite制御、暗号化、vCard/CSV出力）
• i18n.js, lang/ : 国際化対応モジュール
• styles.css : Tailwind CSSによって生成されたスタイル
• sw.js : PWA用の Service Worker（完全オフライン化、キャッシュ管理）
• manifest.json : PWAマニフェスト

開発の背景

名刺管理ソフトやコミュニティ管理アプリは、自社アプリ内にユーザーを囲い込もうとして多機能化し、結果として「このアプリを開かないとあの人の連絡先がわからない」というデータの分断（サイロ化）を引き起こしがちです。 Peopleはそれを否定し、「整理・統合して、OSの住所録にサッとパスする」ことに特化しています。この「土管」や「ハブ」としての役割は、ポータビリティを重んじるローカルファーストなアーキテクチャと完璧に合致します。

免責事項 (Disclaimer)

本ソフトウェアは「ローカルファースト」のアーキテクチャを採用しており、データはすべてお使いのPC（またはブラウザのIndexedDB）内に保存されます。 外部サーバーへの自動バックアップは行われないため、PCの故障、ブラウザのキャッシュクリア、予期せぬエラーなどによりデータが消失するリスクがあります。

本ソフトウェアを使用したことによるデータの消失や、それによって生じた損害について、作者は一切の責任を負いません。

日々の入力が完了した際は、こまめに保存（Cmd+S / Ctrl+S）を行い、出力された .people ファイルをGoogle DriveやDropboxなどの外部ストレージにバックアップ（退避）することを強く推奨します。

ライセンス

MIT License