Skip to content

Ashwanth-Raj/CyberAware-Bharat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 

Repository files navigation

CyberAware Bharat 🛡️🇮🇳

A simple website to help people in India learn about cyber scams and stay safe online. 💻🔒


What is this? 🤔

CyberAware Bharat is a website where people can:

  • 🕵️‍♂️ Learn how recent scams work
  • 📝 Share their scam experiences to help others
  • 📢 Read about new scam tricks happening every day
  • 🛡️ Protect themselves from online fraud

Every day, thousands of people in India lose money to online scams. This website helps everyone learn from real scam stories so they don't fall into the same traps. ⚠️


Main Features ✨

  • Easy to Use: Works in both English and Hindi
  • 📖 Real Scam Stories: Read how scams actually happen
  • 🗣️ Report Scams: Share your experience to help others
  • 🔔 Stay Updated: Learn about new scam tricks
  • 🔐 Safe Login: Secure account system
  • 📱 Works Everywhere: Use on phone, tablet, or computer

How it Works 🔄

  1. 📚 Read Stories: See how real scams happened to real people
  2. 💡 Learn Tricks: Understand common scam methods
  3. 🗨️ Share Experience: Tell others about scams you've seen
  4. 🚨 Stay Alert: Know what to watch out for

Requirements 📋

For Users:

  • 🌐 Computer, tablet, or smartphone with internet
  • 🖥️ Web browser (Chrome, Firefox, Safari, Edge, etc.)

For Developers:

  • ⚡ Node.js (version 16.0 or higher)
  • 🍃 MongoDB (local installation or MongoDB Atlas account)
  • 📦 Git
  • 💻 Code editor (VS Code recommended)

How to Set Up (For Developers) ⚙️

Step 1: Download the Code ⬇️

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

Step 2: Install Required Files 📦

Backend Setup:

cd server
npm install

Frontend Setup:

cd ../client
npm install

Step 3: Set Up Database 🗄️

Create a .env file in the server and client directory:

PORT
MONGO_URI
JWT_SECRET
CLOUDINARY_CLOUD_NAME
CLOUDINARY_API_KEY
CLOUDINARY_API_SECRET
CLOUDINARY_UPLOAD_PRESET

Step 4: Start the Application ▶️

Terminal 1 - Start Backend:

cd server
npm start
# Server runs on http://localhost:5000

Terminal 2 - Start Frontend:

cd client
npm start
# Website opens on http://localhost:3000

Step 5: Access the Website 🌍

Open your web browser and go to: http://localhost:3000


How to Use the Website 🧑‍💻

  1. 🌐 Choose Language: Pick English or Hindi from the top menu
  2. 🆕 Create Account: Sign up to share and read scam stories
  3. 📖 Read Stories: Learn how different scams work
  4. 📝 Share Your Story: Help others by telling them about scams you've seen
  5. 🔐 Stay Safe: Use what you learn to protect yourself

Why This Helps ❤️

  • 📂 Real Examples: Learn from actual scam cases
  • 🧩 Easy to Understand: Simple language, no technical words
  • 🤝 Community Help: Everyone helps everyone stay safe
  • 🔄 Always Updated: New scam stories added regularly
  • 🎉 Free to Use: No cost to learn and stay protected

Technology Stack 🛠️

Frontend:

  • ⚛️ React.js - User interface
  • 🛣️ React Router - Page navigation
  • 🌐 i18next - English/Hindi language support
  • 🎨 CSS3 - Styling and responsive design

Backend:

  • 🟩 Node.js - Server runtime
  • 🚀 Express.js - Web framework
  • 🍃 MongoDB - Database for storing data
  • 🔑 JWT - Secure user authentication

Features:

  • 📱 Responsive design (works on all devices)
  • ♿ Accessibility support (screen readers, high contrast)
  • 🗣️ Bilingual interface (English & Hindi)

Help Make It Better 🤗

If you want to help improve this website:

  1. 💡 Share your ideas
  2. 🐞 Report problems
  3. 🌍 Help translate to more languages
  4. 📣 Tell others about this website

Contributing 🤝

  1. 🍴 Fork the repository
  2. 🌟 Create a feature branch
  3. Commit your changes
  4. 📤 Push to the branch
  5. 🔄 Open a Pull Request

Let's work together to keep India safe from cyber scams! 🇮🇳

Knowledge is the best protection against fraud. 📚🛡️

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors