Skip to content

Repository files navigation

Neara

Offline-First Peer-to-Peer Mesh Communication Platform
Pure local Wi-Fi, Hotspot & LAN • End-to-End Encrypted • No Internet Required

Kotlin Platform Compose Encryption License


📌 Overview

Neara is an internet-independent, peer-to-peer communication application engineered in Kotlin. It enables nearby devices to discover one another automatically, exchange end-to-end encrypted messages, make voice & video calls, record voice messages, and transfer files over local Wi-Fi, Hotspots, or Wi-Fi Direct—completely independent of cellular data, cloud servers, or external infrastructure.


✨ Key Features

  • 💬 Direct & Group Messaging — Chat 1-on-1 or create public & private channels with instant delivery receipts (Sent, Delivered, Read), message reactions, and swipeable conversation controls.
  • 📞 Voice & Video Calling — Crystal-clear peer-to-peer audio and video calls over local Wi-Fi/LAN with interactive call history cards and full-screen call management.
  • 🎙️ Voice Notes — Push-to-record voice audio clips featuring symmetrical waveform playback visualization.
  • 📷 High-Speed Media Sharing — Share photos and files directly device-to-device at full Wi-Fi speeds using chunked transfer.
  • 📡 Instant Nearby Radar Discovery — Zero-configuration UDP multicast discovery on local subnets without cumbersome pairing.
  • 🛡️ Military-Grade Cryptography — Every packet is authenticated and encrypted:
    • Ed25519 digital signatures for identity verification
    • X25519 ephemeral ECDH key agreement
    • ChaCha20-Poly1305 AEAD symmetric encryption
    • HKDF session key derivation
  • 🔄 Mesh Routing Engine — Multi-hop packet forwarding with duplicate suppression, TTL hop limits, and loop protection to bridge devices out of direct range.
  • 📬 Offline Queue — Automatic local SQLite queueing when a recipient is away, auto-drained when they reconnect.

🚀 Building & Running

Prerequisites

  • JDK 21 or higher
  • Android SDK (for Android build)

Build Android APK

./gradlew :neara-android:assembleDebug

The generated APK will be available at: neara-android/build/outputs/apk/debug/neara-android-debug.apk

Run Desktop Application

./gradlew :neara-desktop:run

Run Tests

./gradlew test

👨‍💻 Author


📄 License & Terms

Neara is distributed under the Neara Source-Available Non-Commercial & Attribution License.

  • ❌ No Selling / No Commercial Use: Strictly prohibited from selling, renting, licensing, or commercializing this software or its binaries.
  • ❌ No Rebranding: You may not remove or alter original author credits or claim this project as your own creation.
  • ⚖️ Mandatory Attribution: All forks or derived works must visibly credit original authorship and link back to this repository.
  • 🔄 ShareAlike: Modified versions must carry the identical license terms.

See the complete terms in the LICENSE file.

About

Offline-First Peer-to-Peer Mesh Communication Platform

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages