Frevia - Hyperlocal Free Giveaway Sharing Platform

Frevia is a turn-key, commercial-grade hyperlocal giveaway platform that connects neighbors to give away pre-loved items, declutter sustainably, earn virtual karma points, communicate in real time, and schedule contactless collections. Demo Download APK here:- Download APK Admin demo:- https://adminfreevia.dilhan.dev/ Frontend demo:- https://frontendfreevia.dilhan.dev/

Features

Mobile App (iOS & Android)

• Hyperlocal Geolocation Engine: Calculates exact distance (e.g. `0.8 km away`) with neighborhood radius filters.
• 100% Free Giveaway Posting: Rich multi-image photo uploads, category tagging, condition indicators, and pickup instructions.
• In-App Messaging & Pickup Coordinates: Real-time chats, unread badges, item preview tags, and 1-tap porch pickup GPS sharing.
• Karma Points & Gamification: Welcome bonus credits, giveaway rewards, claim limits, and leaderboard badges.
• Email Verification & Account Security: 6-digit OTP email verification, email switching, and password reset center.
• 5-Star Neighbor Reviews & Compliments: Trust-building rating system with badges ("Super Friendly", "Punctual", "Great Item").
• Community Wanted Board: Publish requests for hard-to-find items or specific neighborhood needs.

Web Administration Dashboard (React + Vite)

• Live Real-time Analytics: Realtime counts for Total Users, Active Giveaways, Completed Collections, Points Issued, and category breakdown charts.
• Member Management & Moderation: User CRUD, Karma credit manual adjustment, instant ban switches, bulk actions (Bulk Verify, Bulk Ban, Bulk Delete), and sortable columns.
• Listing Control Hub: Add listings directly, moderate posts, feature top listings, and execute bulk status updates.
• Administrative Staff & Role Provisioning: Add Super Admins, Community Moderators, and Support Agents with dedicated permission levels.
• Safety Reports Queue: Review flagged items and commercial selling violations with resolution logs.
• Immutable Security Audit Trail: Every sensitive admin operation is recorded with timestamps, action details, and IP addresses.

Requirements

Latest Android Studio Java 25 Expo CLI NodeJS 22+ Composer PHP 8.3+ MySQL 8+ / MariaDB 10.3+

Instructions

Documentation is included with the file.