Flipper NFC Maker Plus

A fork of jaylikesbunda/Flipper-NFC-Maker — a client-side web app for generating Flipper Zero .nfc tag files.

This fork adds: iOS-compatible business card NFC tags, a visual refresh, bug fixes, multi-NTAG type support with correct specifications, and a modernised codebase.

🌐 Try it live: https://pbnz.github.io/Flipper-NFC-Maker-Plus/

License: GNU General Public License v3 — see Licensing below.

---

✨ What's New in This Fork

Feature	Description
Advanced vCard Editor	Full creation wizard for vCard 4.0 with real-time property editing
Intelligent Capacity Tracking	Live visualization of remaining bytes with auto-switch suggestions for Tag Types
Bug fixes	Fixed BCC0 calculation, CC bytes, Mifare version per NTAG type, long-form NDEF records
NTAG213/215/216 support	Correct specifications for all three tag types with live capacity checking
Visual refresh	Modern Segmented Controls, navy + teal colour scheme, dark/light mode with system preference detection
No external dependencies	System fonts, no Google Fonts, no analytics — works fully offline
Restructured codebase	Modular JS files, JSDoc annotations, AI-development-friendly

🚀 Quick Start

1. Clone the repo (or download the ZIP):

   git clone https://github.com/PBNZ/Flipper-NFC-Maker-Plus.git

2. Open src/index.html in any modern browser
3. Done — no build step, no server, no dependencies

📋 Features

Standard NFC Tag Types

• URL — with efficient URI prefix compression
• Phone, Email, SMS — tel:, mailto:, sms: URI schemes
• Wi-Fi Configuration — SSID, password, auth type
• Contact (vCard) — paste raw vCard data
• Geo Location — latitude/longitude coordinates
• Launch Application — Android Application Records
• Custom MIME — arbitrary MIME type + payload
• Social Media Links — optimised URL records
• FaceTime / FaceTime Audio — iOS-specific
• Apple Maps, HomeKit — iOS-specific
• Send to Flipper — WebSerial direct transfer (Chrome desktop)

Contact (vCard) [iOS+Android, Android] ✨

1. Create vCards from scratch using the dynamic UI Editor or Import via URL/Paste.
2. App natively parses and optimizes vCards to save NFC space.
3. Automatically warns if payload exceeds NTAG type capacity, suggesting an upgrade.
4. Generates a standard text/vcard payload OR a dual-record .nfc file (vCard + hosted VCF URL) for optimal iOS + Android compatibility.

🌐 Deployment Options

This app works in all of these scenarios without modification:

Method	Instructions
Local file	Open src/index.html directly (file:// protocol)
Web server	Copy src/ contents to your web root
GitHub Pages	Enable Pages on the main branch, set source to src/
S3 / CloudFront	Upload src/ contents to your bucket
IIS	Copy src/ contents to wwwroot

All paths are relative — no configuration needed.

🗂️ Project Structure

├── src/
│   ├── index.html              # Main application
│   ├── css/styles.css          # Styles (dark/light theme)
│   └── js/
│       ├── app.js              # UI logic, event handlers
│       ├── nfc-generator.js    # NFC/NDEF byte-level generation
│       ├── vcard-parser.js     # vCard parsing + preview
│       ├── background.js       # Particle canvas animation
│       └── serial.js           # WebSerial Flipper communication
├── tests/
│   ├── logic_tests.js            # Core parser and generator unit tests
│   └── generate-test-vcards.js   # Script to generate 150+ vCard 4.0 edge cases
├── .github/workflows/deploy.yml
├── .editorconfig
├── .gitignore
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE                     # GPL v3 (original, unmodified)
└── README.md

🧪 Testing

The project includes an extensive logic test suite that runs without a browser:

node tests/logic_tests.js

There is also a generator script that creates 150 comprehensive mock vCards covering all RFC 6350 properties, datatypes, and encoding edge cases (used to verify parser integrity):

node tests/generate-test-vcards.js

🗺️ Roadmap

Future improvements (tracked as TODO comments in code):

• Manual multi-record tag creation (arbitrary record types)
• VCF hosting service integration
• PHOTO property: display photo from URL or base64-encoded data, convert URL to encoded, save encoded photo as file
• LOGO property: display and edit organization logos (URL and encoded)
• SOUND property: audio playback and editing support
• KEY property: cryptographic key display and management

🤝 Contributing

See CONTRIBUTING.md for repo layout, coding conventions, and how to add new NFC record types.

📜 Licensing

This project is licensed under the GNU General Public License v3.

Original work Copyright (c) jaylikesbunda
Modifications Copyright (c) PBNZ 2026

The full license text is in the LICENSE file. All source files include a GPL header comment. This fork complies with GPL v3 requirements — source code is publicly available and the original license is preserved.

⚠️ Disclaimer

This tool is for educational and personal use only. Ensure you have the right to create and use NFC tags before deploying them. The creators are not responsible for any misuse.