🌍 Startup Atlas
An interactive full-stack dashboard and mapping tool designed to visualize the global startup ecosystem. Built with React, Leaflet, and Express
🚀 Live Demo (https://startup-atlas-sepia.vercel.app/)
-
✨ Key Features:
-
🗺️ Interactive Global Map: Visualizes startups worldwide using Leaflet with custom tiles for Dark/Light modes.
-
📍 Smart Marker Clustering: Groups high-density startup hubs (like Silicon Valley or London) to maintain map performance and clarity.
-
🌓 Adaptive Theme Engine: Seamlessly switch between Dark and Light UI modes with persistent state.
-
🔍 Intelligence & Filtering: Search by name or filter by industry (FinTech, AI, E-commerce) and investment stage.
-
⚡ Full-Stack Architecture: Powered by a Node/Express backend with a robust frontend fallback system.
📸 Visual Tour:
🌓 Theme Support
The Startup Atlas features a fully responsive design with integrated Dark and Light mode support to ensure readability in any environment.
| Dark Mode (Dashboard) | Light Mode (Dashboard) |
|---|---|
 |
 |
🗺️ Interactive Exploration
The mapping system uses Leaflet and Marker Clustering to visualize the global startup ecosystem.
- Global Overview: View startups distributed across continents.
- Precision Zoom: Deep dive into specific tech hubs with custom industry icons.
| Map View (Light) | Detailed Hub Zoom |
|---|---|
 |
 |
🔍 Intelligence & Data:
The platform provides a streamlined list view for quick filtering and a comprehensive details page for deep-dives into startup leadership and mission.
| List Analytics | Startup Intelligence |
|---|---|
 |
 |
🛠️ Tech Stack:
- Frontend: React.js, React Leaflet (Maps), React Router
- Backend: Node.js / Express (deployed separately)
- Database: Supabase (PostgreSQL)
- Icons: React Icons (Bi-prefix)
- Styling: Custom CSS3 with Dark/Light mode support
🧪 Testing:
The backend is covered by a comprehensive suite of integration tests using Jest and Supertest. These tests ensure API reliability and strict data validation.
Key Test Coverage:
-
Path Parameter Validation: Verifies dynamic routing for industries and prevents invalid field access with 400 Bad Request responses.
-
Complex Query Filtering: Ensures multiple filters (e.g., industry=AI&has_mvp=true) return correct, narrowed-down results.
Boolean Logic Handling: Confirms the API correctly parses string-based query booleans into functional database logic.
- Global Error Handling: Validates custom 404 Not Found responses for non-existent endpoints.
To run the tests:
cd server npm test
🚧 Work in Progress:
I am currently transitioning the data architecture from a static local environment to a live Supabase backend.
- Initial UI/UX and Map Logic
- Database Schema Design
- Final Database Synchronization (Current Focus)
- Real-time data updates
🛠️ Setup:
-
Clone the repo:
git clone [https://github.com/Anuska86/startup-atlas] -
Server Setup: npm install npm start
-
Client Setup: cd client npm install npm run dev
📄 License:
Distributed under the MIT License. See LICENSE for more information.
Developed by Ana Sappia Rey:
