Amaan is an all-in-one community safety and awareness platform designed for masjid communities. It enables real-time threat reporting, secure communication from community administrators, and verified identity management, while prioritizing privacy, trust, and security.

Amaan helps masjid communities stay secure, informed, and connected through three core features:

• Community Threat Map
  Users can report nearby suspicious activity or potential threats on a live map. Reports can be confirmed by other users, similar to a Waze-style system, and are summarized using AI to provide clear situational awareness.

• Secure Community Forum
  Verified masjid administrators can post official alerts, safety notices, and announcements that are visible only to approved community members.

• Identity and Access Management
  A verification system ensures only trusted users join the community and serves as the foundation for digital key-fob–style access to masjid facilities.

• Next.js
• React
• TypeScript
• SQLite
• Google Maps API
• OpenAI API

Amaan is designed with security and privacy as first-class concerns:

• Encrypted communication using HTTPS and TLS
• Role-based access control for administrators and regular users
• Secure authentication and identity verification flows
• Encrypted handling of sensitive user and location data
• Minimal data exposure to reduce attack surface and misuse

Ensure the following are installed:

• Node.js (version 18 or later recommended)
• npm or yarn
• Google Maps API key
• OpenAI API key

git clone https://github.com/your-username/amaan.git
cd amaan

npm install

Create a .env file in the root directory and add the following:

DATABASE_URL="file:./dev.db"

NEXT_PUBLIC_GOOGLE_MAPS_API_KEY=your_google_maps_api_key
OPENAI_API_KEY=your_openai_api_key

If using Prisma with SQLite:

npx prisma migrate dev

This will create the local SQLite database and apply the required migrations.

npm run dev