https://github.com/codenkoffee/leads-intercontinental
Leads Intercontinental is a high-performance, sovereign lead generation and intelligence deployment system. It identifies High-Value Targets (HVTs) across diverse sectors using a multi-stage discovery and enrichment pipeline.
https://github.com/codenkoffee/leads-intercontinental
bun bunjs desktop-app electron electron-app electron-vite electronjs leads-generation leadscanner macos macos-app node node-js nodejs pipline-operators react vite windows-app windows-package
Last synced: 21 days ago
JSON representation
Leads Intercontinental is a high-performance, sovereign lead generation and intelligence deployment system. It identifies High-Value Targets (HVTs) across diverse sectors using a multi-stage discovery and enrichment pipeline.
- Host: GitHub
- URL: https://github.com/codenkoffee/leads-intercontinental
- Owner: CodeNKoffee
- License: mit
- Created: 2026-03-15T15:32:58.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-03-16T03:04:07.000Z (2 months ago)
- Last Synced: 2026-03-16T12:58:21.898Z (2 months ago)
- Topics: bun, bunjs, desktop-app, electron, electron-app, electron-vite, electronjs, leads-generation, leadscanner, macos, macos-app, node, node-js, nodejs, pipline-operators, react, vite, windows-app, windows-package
- Language: TypeScript
- Homepage:
- Size: 778 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Leads Intercontinental - Global Intelligence Engine
Leads Intercontinental is a high-performance, sovereign lead generation and intelligence deployment system. It identifies High-Value Targets (HVTs) across diverse sectors using a multi-stage discovery and enrichment pipeline.
## 🛡️ Strategic Capabilities
- **Hybrid Discovery** - Combines OpenStreetMap spatial data with real-time Google Search scraping.
- **Enigma Enrichment Engine** - Powered by Serper.dev to extract verified websites and contact emails.
- **Friction Auditing** - Calculates "Revenue Leak" indices based on niche-specific friction multipliers.
- **Tactical Dispatch** - Generates "Architecture of Ease" audit drafts for immediate review and dispatch.
- **Sovereign Storage** - Uses Dexie.js (IndexedDB) for secure, private, and persistent local data.
## 🖥️ Getting Started
### Native Desktop App (Recommended)
1. **Download**: Obtain the latest release from the `dist-electron/` directory.
2. **Install**: Run the generated `.dmg` (Mac) or `.zip` file.
3. **Configure**: Launch the app and enter your Serper.dev API key in the configuration sidebar.
### Building from Source
#### Prerequisites
- Node.js (v18+)
- Bun (recommended) or NPM
#### Installation
```bash
# Clone the repository
git clone https://github.com/CodeNKoffee/leads-intercontinental.git
cd leads-intercontinental
# Install dependencies
bun install
```
#### Running the Engine
```bash
# Development (Browser)
bun dev
# Native Shell (Desktop)
bun run electron:dev
# Production Build (Packaged App)
bun run electron:build
```
Fuel the Engine
## 🛠️ Tech Stack
- **Frontend** - React, Vite, TypeScript
- **Styling** - Tailwind CSS, Framer Motion, Shadcn/UI
- **Database** - Dexie.js (IndexedDB)
- **Intelligence** - Axios, Serper.dev API, Nominatim (OSM)
- **Desktop Shell** - Electron, Electron Builder
## 📂 Project Structure
```
leads-intercontinental/
├── electron/ # Electron main & preload scripts
├── src/
│ ├── components/ # Modular UI (LocationEngine, LeadTable, etc.)
│ ├── lib/ # Intelligence logic (scraper.ts, db.ts)
│ ├── pages/ # Main application views
│ └── hooks/ # Reactive state logic
├── public/ # Static assets & icons
└── assets/ # Production build artifacts
```
## 🌟 Stargazers
A massive thank you to everyone fueling this mission!
## 📜 License
MIT License - see the [LICENSE](LICENSE) file for details.
---
Developed by Hatem Soliman
Support this mission on Buy Me a Coffee
---
*Time is the only commodity that cannot be exported. We protect it.*