Status: 🚧 In development!
This project is not production-ready. Features, structure, and documentation are subject to rapid change.
I started this project because I was frustrated with how messy and inaccurate my contact lists had become. I couldn’t find a simple, secure way to share MY OWN contact info and keep it up to date. So I built a tool that makes exchanging these details safe, automatic, and effortless.
- Your contacts are broken 🤯
- You have 200 contacts. When you change your number, 200 people then might have the wrong one.
- What if YOUR contact card updated itself in everyone's phone?
- That's what we built ✨
- Never text the wrong number again.
- Try → it here
A secure, modular contact management system with:
- End-to-end encrypted storage on Userbase
- Real-time sharing and sync
- Using RFC9553 for storage
- Distribution lists for group sharing
- Cross-device support (web application)
- Create, edit, and organize contacts
- Share contacts with users or groups (distribution lists)
- Archive, delete, and manage received/shared contacts
- Import/export contacts (vCard 3.0
and 4.0) - QR code generation - Scan to easely import contacts
- Real-time updates and cross-device sync
- 🆕 Baical CardDAV Integration - Sync with any CardDAV server
src/ # Core business logic and UI components
lib/ # Third-party SDKs (e.g., userbase.js)
index.html # Main entry point
style.css # Styles
mobile.css
- Contributions and feedback are welcome!
# Install development dependencies (testing framework, dev server)
npm install
# Start development server with live reload
npm run serve
# 🆕 Baical CardDAV integration setup
cd ../contact-carddav-bridge && npm start # Start bridge server (port 3001)
npm run serve # Start contact manager (port 8080)# For development (after CSS/JS changes)
./dev-cache-bust.sh
# For production deployment
./production_zip.sh
# Restore original files
./restore-dev.sh- QR code generation (for easy contact sharing with iOS/Android compatibility)
- Share your profile
- Revoke sharing per recipient (Individual Databases)
- Improve phone menu UI
- Add some missing export functionality
- Improved import duplicate and merge functionality
- Sharing-lists (for better control and bulk sharing)
- Baical CardDAV Integration (sync with any CardDAV server)
- Group list features (Rename, edit, copy, etc)
- Create e-mail distrubution list
- Bulk operations (Delete)
- Multi-language support (i18n)
- Advanced sharing permissions (cross edit contacts)
- Stay logged in feature
- Change password
- Set passwords rules
- Dark mode
- Pictures as avatars
- Complete disaster recovery system via vCards
- A Progressive Web App (PWA)
- An Electron or Tauri App
- [(x)] Better integration on phones, CardDAV support
- Improve decentralization using userbase
┌────────────────────────────────────────────────────┐
│ Shared Userbase Application │
│ AppID: "contact-manager" │
│ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ Instance A │ │ Instance B │ │
│ │ domain-a.com│ │ domain-b.com│ │
│ │ │ │ │ │
│ │ User: alice │◄──────────►│ User: bob │ │
│ │ Contacts DB │ Native │ Contacts DB │ │
│ │ │ Userbase │ │ │
│ └──────────────┘ Sharing └──────────────┘ │
│ │
│ Same AppID = Native Sharing Works! │
└────────────────────────────────────────────────────┘
┌─────────────────────┐ ┌─────────────────────┐
│ Instance A │ │ Instance B │
│ (Userbase App 1) │ │ (Userbase App 2) │
│ │ │ │
│ User: alice@A │ │ User: bob@B │
│ Contact DB │ │ Contact DB │
└──────────┬──────────┘ └──────────┬──────────┘
│ │
│ Encrypted Export │
└───────────┐ ┌─────────────┘
▼ ▼
┌──────────────────┐
│ Bridge Service │
│ (Server) │
│ │
│ • User mapping │
│ • Data relay │
│ • Permissions │
└──────────────────┘
┌─────────────────────┐ ┌─────────────────────┐
│ Browser A │ │ Browser B │
│ (Alice) │◄───────►│ (Bob) │
│ │ WebRTC │ │
│ Userbase: app-a │ P2P │ Userbase: app-b │
│ │ Channel │ │
└─────────────────────┘ └─────────────────────┘
│ │
└───────────┐ ┐─────────────┘
▼ ▼
┌──────────────────┐
│ Signaling │
│ Server │
│ (WebSocket) │
└──────────────────┘
┌─────────────────────┐ ┌─────────────────────┐
│ Instance A │ │ Instance B │
│ AppID: "app-a" │ │ AppID: "app-b" │
│ domain-a.com │◄───────►│ domain-b.com │
│ │WebFinger│ │
│ alice@domain-a.com │ + │ bob@domain-b.com │
│ │ Signed │ │
│ │ vCards │ │
└─────────────────────┘ └─────────────────────┘
Push (Contact Manager → Baïcal)
- User updates contact in web app
- Bridge uploads vCard via CardDAV PUT
- Baïcal stores and serves to other devices
Pull (Baïcal → Contact Manager)
- Other devices update contact via CardDAV
- Bridge polls Baïcal for changes (PROPFIND)
- Contact Manager updates local storage
┌─────────────────────────────────────────────────────────┐
│ User's Contact Manager Account │
│ │
│ ┌───────────────────┐ ┌──────────────────┐ │
│ │ Userbase Storage │ │ User's Bridge │ │
│ │ (E2E Encrypted) │◄──────►│ Component │ │
│ │ │ │ (Per-User) │ │
│ │ - My Contacts │ │ │ │
│ │ - Shared Contacts │ │ User Config: │ │
│ └───────────────────┘ │ • Baïcal URL │ │
│ │ • Username │ │
│ │ • Password │ │
│ │ • Sync Settings │ │
│ └────────┬─────────┘ │
└────────────────────────────────────────┼────────────────┘
│
│ CardDAV Protocol
│ (Bidirectional Sync)
┌──────────────────────┐
│ Baïcal Server │
│ (CardDAV Endpoint) │
│ │
│ /dav.php/ │
│ addressbooks/ │
│ username/contacts/ │
└──────────────────────┘
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Client Apps │ │ Contact Manager │ │ Userbase.com │
│ (iOS, Android, │◄──►│ │◄──►│ (E2E Encrypted│
│ Thunderbird) │ │ │ │ Storage) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │
│ │
└───────────────────────▼
┌─────────────────────────────────────┐
│ Baïcal Server │
│ (CardDAV/CalDAV Server) │
│ │
│ ┌─────────────────────────────┐ │
│ │ Bridge Component │ │
│ │ (Sync Userbase ↔ Baïcal) │ │
│ └─────────────────────────────┘ │
└─────────────────────────────────────┘
┌─────────────────────────────┐
│ Contact Manager │ ← Real-time sharing, E2E encryption
│ (Userbase.com storage) │ ← Advanced features: distribution lists,
│ │ individual sharing, revocation
└─────────────┬───────────────┘
│ Bridge Component
▼
┌─────────────────────────────┐
│ Baïcal Server │ ← Standard CardDAV server
│ (CardDAV endpoint) │ ← Compatible with ALL devices
└─────────────┬───────────────┘
│ Standard CardDAV Protocol
▼
┌─────────────────────────────┐
│ Native Device Apps │
│ • iPhone Contacts │
│ • Android Contacts │
│ • Thunderbird Address Book │
│ • macOS Contacts │
│ • Any CardDAV client │
└─────────────────────────────┘
The contact manager now supports synchronization with any CardDAV server (Baical, Nextcloud, etc.). This enables:
- Universal Device Sync: Access contacts on iPhone, Android, Thunderbird, etc.
- Standard Protocol: Uses industry-standard CardDAV for maximum compatibility
- Bidirectional Sync: Changes sync both ways between contact manager and CardDAV server
- Self-Service Setup: No admin required - users configure their own connections
# Start CardDAV bridge server (separate project)
cd ../contact-carddav-bridge && npm start # Port 3001
# Start contact manager
npm run serve # Port 8080
# Open http://localhost:8080, click "Baical" buttonSee BAICAL_INTEGRATION.md for complete setup and configuration guide.
This project has been developed with assistance from GitHub Copilot.