NorthStar

Connecting the most vulnerable to the most essential: A bridge between users in crisis and the social services that can help them.

Comment

Inspiration

In a moment of crisis whether it’s a sudden need for a meal, a safe place to sleep, or urgent medical care the last thing a person needs is a cluttered search engine. Standard map apps often prioritize commercial businesses, making it difficult to find non-profit clinics or community food banks. We built NorthStar to act as a digital guide, stripping away the noise to provide an instant connection to essential services nearest to a user’s location.

What it does

NorthStar is a high-speed locator for critical community resources. By simply enabling location access, users are instantly presented with categorized support options through an intuitive, compass-inspired interface:

Health: Public hospitals, emergency rooms, and mental health clinics.

Shelter: Homeless and domestic violence emergency housing.

Sustenance: Community food banks, soup kitchens, and clothing banks.

Support: Legal aid, immigration services, and employment resource centers.

How we built it

We utilized a robust Full-Stack architecture to ensure speed, security, and data integrity:

Frontend: Built with React.js, providing a sleek, high-contrast dark-mode UI optimized for accessibility. We utilize the Browser Location API to capture device coordinates securely.

Backend: A Python/FastAPI engine acts as the intelligent "Middle Man." It receives coordinates and handles complex communication with external providers.

The Brain: We integrated Google Maps & Places APIs. Our backend uses a custom Semantic Mapping System to translate simple UI categories into precise, filtered queries (e.g., mapping "Shelters" to "Homeless Shelter emergency housing") to ensure the most relevant results.

Intelligent Filtering: Results are normalized in the backend into a universal format, allowing the frontend to offer smart sorting by Distance or Service Quality.

Challenges we ran into

Securing our infrastructure was a primary hurdle. We had to resolve specific IAM permissioning issues and implement strict API key restrictions within the Google Cloud Console to prevent unauthorized usage and ensure the platform remains sustainable. We also carefully managed our API Quotas to stay within a "free-tier" friendly limit while maintaining comprehensive service coverage.

Accomplishments that we're proud of

We successfully built a seamless end-to-end flow where a user’s physical location is converted into a list of life-saving resources in under two seconds. Seeing the system correctly map a "Community Mental Health Clinic" from a single icon click bypassing commercial noise was a major victory for our mission of accessibility.

What we learned

Building NorthStar was as much a lesson in cloud infrastructure and security as it was in full-stack development. Here are the key takeaways from our journey:

Security is Not Optional: We learned that even in a development phase, leaving API keys unrestricted is a massive liability. We gained hands-on experience navigating Identity and Access Management (IAM) to fix "permission denied" errors and learned how to properly apply HTTP referrer and API restrictions to protect our project from unauthorized use.

What's next for NorthStar

Share this project:

Updates