Skip to content

The concept represents a paradigm shift in addressing homelessness through technology-driven charitable giving. By integrating blockchain transparency, AI-powered financial guidance, and location-based QR services, we hope that shelter will create a direct bridge between donors and individuals experiencing homelessness.

Notifications You must be signed in to change notification settings

mrj0nesmtl/sheltr-v2

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SHELTR Version Stage License SHELTR App Listen on Spotify Arcana Ventures LinkedIn Substack

SHELTR

Hacking Homelessness Through Direct-Impact Technology

Project Initialization: December 2024 - Beta Launch (V1.0.0) February 2025 Current Version: 0.6.7

🌟 Overview

At SHELTR, we're not just building another donation platform – we're reimagining how technology can empower both givers and receivers in the fight against homelessness. By leveraging blockchain transparency, QR-powered direct giving, and AI-driven insights, we create a future where every dollar makes a measurable impact, and every participant gains tools for lasting change.

Our commitment to #BuildInPublic ensures every decision and milestone is shared openly, fostering a spirit of collaboration and radical transparency. Join us in hacking homelessnessβ€”one verifiable transaction and one empowered individual at a time.

SHELTR is revolutionizing charitable giving through cutting-edge technology integration. Our platform seamlessly combines QR code donations, blockchain verification, and AI-driven insights to create a transparent, efficient, and impactful giving ecosystem.

🎯 Core Features

  • Instant QR Donations: Secure scan-and-give technology
  • Blockchain Verification: 100% transparent tracking
  • Smart Fund Allocation: 80/15/5 distribution model
  • AI-Powered Insights: Data-driven impact optimization
  • Gamified Engagement: Donor reward system
  • Location Services: Map-based shelter discovery
  • Mobile Optimization: Cross-device accessibility
  • Offline Support: Continuous service availability

🌟 Theory of Change

SHELTR's approach to "hacking homelessness" combines:

  1. Direct Impact: Immediate assistance through QR donations
  2. Sustainable Growth: Smart contract-governed housing fund
  3. Data-Driven: AI-powered resource optimization
  4. Community Engagement: Gamified donor participation

Our core values are:

Empowerment: Providing tools for individuals to take control of their futures. Automation: Streamlining processes for maximum efficiency. Sustainability: Ensuring long-term impact through scalable solutions.

graph LR
    A[Donor] -->|QR Scan| B[Direct Donation]
    B -->|Smart Contract| C[Fund Tracking & Verification]
    C -->|80%| D[Direct Support]
    C -->|15%| E[Housing Fund]
    C -->|5%| F[Operations]
Loading

πŸ“Š Implementation Status

Component Status Progress
Core System βœ… STABLE 100%
Auth System βœ… STABLE 100%
QR System βœ… STABLE 100%
Super Admin βœ… STABLE 100%
Shelter Admin βœ… STABLE 100%
Map Integration βœ… STABLE 100%
Mobile System 🟑 IN PROGRESS 65%
Blockchain 🟑 IN PROGRESS 75%
Analytics 🟑 IN PROGRESS 60%
AI Integration 🟑 IN PROGRESS 40%

πŸ› οΈ Technology Stack

graph TD
    SHELTR[SHELTR Platform]
    
    SHELTR --> Frontend
    SHELTR --> Backend
    SHELTR --> Deploy[Deployment]
    
    Frontend --> React[React 18]
    Frontend --> TS[TypeScript 5.0]
    Frontend --> State[Zustand]
    Frontend --> Style[Tailwind CSS]
    Frontend --> Motion[Framer Motion]
    Frontend --> Monitor1[Real-time Analytics]
    Frontend --> Map[Google Maps API]
    Frontend --> Mobile[Mobile Optimization]
    Frontend --> Offline[Offline Support]
    
    Backend --> DB[Supabase]
    Backend --> API[REST + WebSocket]
    Backend --> BC[Polygon Blockchain]
    Backend --> Analytics[Custom + Recharts]
    Backend --> AI[TensorFlow.js]
    
    Deploy --> Host[Vercel]
    Deploy --> CICD[Github Actions]
    Deploy --> Monitor2[Sentry]

    classDef default fill:#13151a,stroke:#3b82f6,stroke-width:2px,color:#fff;
    classDef platform fill:#1e40af,stroke:#3b82f6,stroke-width:4px,color:#fff;
    class SHELTR platform;
Loading

πŸ”’ Security & Compliance

  • πŸ” Blockchain Verification: Every transaction
  • πŸ›‘οΈ Data Protection: GDPR & CCPA compliant
  • πŸ”‘ Secure QR: Dynamic & encrypted
  • πŸ“œ Smart Contracts: Audited & verified

πŸ“Š Success Metrics

Fund Allocation Model

Category Percentage
Direct Support 80%
Housing Fund 15%
Operations 5%

πŸ“ˆ Impact Metrics

Metric Target (2025) Current
Active Users 100,000 25
Monthly Donations $5M $0.1K
Housing Fund $10M $0.05M
Success Rate 75% 2%

πŸ—ΊοΈ Roadmap

Development Timeline

Phase Status Timeline
Alpha
Core Development βœ… Done 2024-10-01 to 2024-12-31
QR System βœ… Done 2024-11-15 to 2024-12-31
Auth System βœ… Done 2024-12-01 to 2024-12-31
Beta
Shelter Admin βœ… Done 2025-01-01 to 2025-01-15
Map Integration βœ… Done 2025-01-15 to 2025-01-31
Mobile System 🟑 Active 2025-01-15 to 2025-02-15
Smart Contracts 🟑 Active 2025-01-01 to 2025-01-31
Blockchain Integration 🟑 Active 2025-01-15 to 2025-02-15
Testing & Audits ⏳ Planned 2025-02-01 to 2025-02-28
AI Analytics 🟑 Active 2025-01-25 to 2025-02-28
Launch
Public Beta 🎯 Milestone 2025-02-01
V1 Release 🎯 Milestone 2025-03-31

🀝 Contributing + Documentation πŸ“š

We welcome contributions! Here's how you get up to speed with the project:

πŸ“š Documentation Index

πŸ“‹ Project Status

🎯 Core

πŸ› οΈ Technical Implementation

πŸ“‹ Development Guides

πŸ“Š Analytics & Components

Quick Links

Category Documentation
Getting Started Whitepaper β€’ Architecture
Development Best Practices β€’ Implementation
Technical API β€’ Security
Status Project Status β€’ Changelog

πŸ“¬ Contact & Support


"BUILD WITHOUT TAKE"

Arcana Concepts Website β€’ Wiki β€’ Community

About

The concept represents a paradigm shift in addressing homelessness through technology-driven charitable giving. By integrating blockchain transparency, AI-powered financial guidance, and location-based QR services, we hope that shelter will create a direct bridge between donors and individuals experiencing homelessness.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published