Scam Alert is an open-source platform where users can share and alert others about new types of scams. The goal is to create a community-driven space to identify and report various scam attempts, helping to protect people from fraud.
- Users can post information about new scams
- Ability to categorize scams (phishing, investment fraud, tech support, etc.)
- Community upvote and comment system for scam alerts
- Search and filter functionality to find specific scams
- Admin dashboard for moderating posts.
-
Clone the repo:
git clone https://github.com/Lets-code-with-us/scam-alert.git
-
Navigate to the project directory:
cd scam-alert -
Install dependencies:
npm install
-
Run the development server
npm run dev
-
For the database, use MongoDB Atlas or a Docker Image :
docker pull mongodb
We welcome contributions to the project! Here are the steps to get started with contributing to the project :
-
Fork the repository: Click the "Fork" button at the top right of this page to create a copy of the repository in your GitHub account.
-
Clone the repository: Clone your forked repository to your local machine using the following command:
git clone https://github.com/your-username/scam-alert.git
-
Create a new branch: Create a new branch for your feature or bugfix:
git checkout -b feature-name
-
Install dependencies: Navigate to the project directory and install the dependencies:
cd scam-alert npm install -
Make your changes: Implement your feature or bugfix.
-
Run tests: Ensure all tests pass before committing your changes. You can run tests using:
npm test -
Commit your changes: Commit your changes with a descriptive commit message:
git commit -m "Description of your changes" -
Push to your fork: Push your changes to your forked repository:
git push origin feature-name
-
Create a Pull Request: Open a Pull Request to the main repository. Provide a clear description of your changes and any related issue numbers.
-
Review and address feedback: A maintainer will review your Pull Request and suggest any changes. Be sure to address any feedback before your Pull Request can be merged.
