hartle-tech/neartrace
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
📡 NearTrace — Professional BLE & Wi-Fi scanner. Multi-platform monorepo (Android, iOS, macOS, Windows, Linux, web). Free tier, open source. https://neartrace.app
1 commit 1 branch 0 tags 40 KiB
Find a file
Exact
Claude Opus 4.7 (1M context) ed4dadf57e
 chore: initial monorepo skeleton 
Empty platform + package placeholders for the public free-tier
NearTrace monorepo. Each platform under apps/ and each shared
package under packages/ has a .keep file — content arrives when
the platform/module is implemented.

Per the 2026-05-12 architecture discussion: this is the open-source
free-tier home. Closed-source Pro and NSFAS modules live in their
own private repos (neartrace-pro, neartrace-nsfas) and are linked at
build time via build flags (PRO_BUILD=1, NSFAS_BUILD=1).

The Android app currently still lives at neartrace-android-mvp and
will migrate to apps/android/ here once the tier-mix design (#397)
is locked.

License: AGPL-3.0.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-12 23:58:38 +01:00
apps chore: initial monorepo skeleton 2026-05-12 23:58:38 +01:00
packages chore: initial monorepo skeleton 2026-05-12 23:58:38 +01:00
.gitignore chore: initial monorepo skeleton 2026-05-12 23:58:38 +01:00
LICENSE chore: initial monorepo skeleton 2026-05-12 23:58:38 +01:00
README.md chore: initial monorepo skeleton 2026-05-12 23:58:38 +01:00

README.md

📡 NearTrace

Professional BLE & Wi-Fi scanner. See every radio around you.

NearTrace is a privacy-respecting network discovery tool — scan, identify, and track nearby BLE and Wi-Fi devices. This is the free, open-source tier — what ships on every app store and what anyone can build from source.

For paid tiers see:

  • 📡 NearTrace Pro — advanced filters, AR locate, attack-surface scoring, history export. Closed-source modules consumed by these apps at build time.
  • 🦇 NearTrace NSFAS — monitor mode, packet injection, pcap export, deauth detection. License-gated sideload distribution. Read more about the lane at docs.neartrace.app/nosferato.
  • 🦇 NosferatOS — the Pi Zero 2 W companion rig that runs the wireless layer phone OSes can't reach. Source: https://github.com/code-hartle-tech/nosferatos

This repo

A monorepo for the Play-safe NearTrace builds across every platform.

.
├── apps/
│   ├── android/          # Play Store / Galaxy Store / Amazon
│   ├── ios/              # App Store
│   ├── macos/            # Mac App Store + notarized direct
│   ├── windows/          # Microsoft Store + Winget
│   ├── linux/            # Snap, Flatpak, distro repos, AppImage
│   └── web/              # PWA at neartrace.app
└── packages/
    ├── proto/            # Wire format (shared across platforms)
    ├── fingerprints/     # OUI database, device taxonomy
    ├── threat-rules/     # Stalker patterns, attack-surface heuristics
    └── design-tokens/    # Brand colors, typography, spacing

CI uses path filters — each apps/*/ runs its own build matrix. Per-platform release cadences via tag prefixes (e.g. android-v1.2.3, ios-v1.0.0).

Current state — May 2026

The Android app currently lives at code-hartle-tech/neartrace-android-mvp. Migration to apps/android/ in this repo is queued behind the monetization decisions on the NearTrace Quest Board.

Other platforms (ios, macos, windows, linux, web) are forward-compat placeholders. .keep files mark them as planned but unbuilt.

Etymology

Near + Trace — see what's near, leave a trace of what you find.

The brand:

  • 🟢 NearTrace (Play-safe) — cyan/teal cyberpunk-clean
  • 🦇 Nosferato (NSFAS) — vampire-rat-NOS-racing motif (different identity entirely)

See packages/design-tokens/ once populated.

License

AGPL-3.0. Forks and derivatives must remain open. Pro / NSFAS features in the closed modules are not affected.

Project

Quest board: https://github.com/orgs/code-hartle-tech/projects/1 Brand parent: https://hartle.tech