🔐 TapIn

TapIn is an open-source keyless living platform that replaces physical keychains with secure digital wallet passes.
Add your building access to Apple Wallet or Google Wallet and unlock doors with a simple tap.
Built for tenants, property managers, and co-ops who want simplicity, security, and ownership, not vendor lock-in.

---

Table of Contents

• 🌟 Features
• 🎯 Vision
• 🗺️ Roadmap
• 🛠️ Development Status
• 📸 Screenshots
• 🏢 Real-World Pilots
• 🚀 Quick Start
• 📂 Project Structure
• ⚙️ Tech Stack
• 🚀 Get Involved
• ⚖️ License
• ✨ Credits

🌟 Features

• 📲 Wallet-based access (Apple Wallet and Google Wallet)
• 🔑 Secure digital keys with real-time revocation
• 🏘️ Multi-property and unit management
• 👥 Role-based access control for tenants, managers, and admins
• 🌐 Offline fallback access (QR or time-based)
• 💻 Admin dashboard for issuing and managing passes
• 🔐 Privacy-first and fully self-hostable
• 🔧 Optional plug-and-play NFC hardware integration

---

🎯 Vision

A world where access is effortless, secure, and equitable.
No keys. No barriers. No nonsense.

Read the full Vision, Mission & Manifesto

---

🗺️ Roadmap

TapIn is currently in MVP development and preparing for real-world pilot testing.
The roadmap includes:

• Tenant and property manager flows
• Wallet pass generation
• Offline QR fallback support
• Open-source launch with optional SaaS tier

View the full Product Roadmap

---

🛠️ Development Status

🚧 Phase 2: MVP Build - Core infrastructure complete

See CHANGELOG.md for detailed progress.

---

📸 Screenshots

Click to expand screenshots

Landing Page

Tenant Dashboard

Tenant Access History

Guest Pass Management

Manager Dashboard

Manager Tenants View

Manager Access Logs

---

🏢 Real-World Pilots

TapIn is launching pilots with small buildings, co-ops, and co-working spaces.
If you’re interested in testing TapIn at your property, get in touch.

Read the Pilot Plan

---

🚀 Quick Start

Prerequisites

• Conda (Anaconda/Miniconda)
• Docker Desktop
• Node.js 18+

📦 Setup

1. Verify your environment:

   scripts\verify.bat

2. Start with Docker (recommended):

   scripts\setup-docker.bat

3. Create admin user:

   docker-compose exec backend python manage.py createsuperuser

4. Access the application:

   • Backend: http://localhost:8000
   • Admin: http://localhost:8000/admin

Run Tests

scripts\test-backend.bat
scripts\test-frontend.bat

See SETUP.md for detailed instructions.

---

📂 Project Structure

TapIn/
├── backend/            # Django REST Framework API
│   ├── core/            # Core app (models, views, API)
│   ├── tapin/           # Project settings
│   └── tests/           # Test suite (unit, property, integration)
├── frontend/           # Next.js web application
│   ├── app/             # Pages and layouts
│   └── __tests__/       # Frontend tests
├── docs/               # Documentation
├── scripts/            # Helper scripts (setup, test, verify)
├── README.md           # This file
└── docker-compose.yml  # Docker orchestration

---

⚙️ Tech Stack

Backend: Django 5.0, PostgreSQL, pytest, Hypothesis
Frontend: Next.js 15, React 19, TypeScript, TailwindCSS
Infrastructure: Docker, Docker Compose
Wallet Passes: Apple Wallet, Google Wallet
Security: OAuth2, JWT, end-to-end encryption

---

🚀 Get Involved

TapIn is open-source and community-driven.
We welcome contributors, testers, designers, and builders.

• 💬 Join the discussion
• 🐛 Report an issue
• 🌟 Star the repo to show your support

See CONTRIBUTING.md for ways to contribute.

---

⚖️ License

TapIn is released under the MIT License
You own your keys. You own your data.

---

✨ Credits

Built with 💖 for people who want to move lighter and live smarter.