scruter

Scruter is a local classifieds and community site designed to bring people together for buying, selling, and exchanging goods and services.

GPL-3.0 License

Stars
22

πŸ“¦ Scruter πŸ›’

Join our Discord Server

This project is now OFFICIALLY accepted forβœ”

Overview πŸ“Œ

Live Demo πŸŽ₯

Scruter is built using the following technologies:

Prerequisites πŸ‘ˆπŸ»

Before setting up the project, ensure you have the following installed:

Installation πŸ› οΈ

Follow these steps to set up Scruter locally:

  1. Clone the repository
git clone https://github.com/swarooppatilx/scruter.git
cd scruter
  1. Install dependencies

Run the following command to install the necessary packages:

npm install
  1. Create a .env file

In the project root, create a .env file and add the following environment variables

DB_URL=your_mongo_db_url
SESSION_SECRET=your_session_secret
CLOUDINARY_CLOUD_NAME=your_cloudinary_cloud_name
CLOUDINARY_API_KEY=your_cloudinary_api_key
CLOUDINARY_API_SECRET=your_cloudinary_api_secret
  1. Running the Application

To start the application, use one of the following commands:

Start the server

npm start

Start the server with Nodemon

Nodemon automatically restarts the server upon detecting file changes:

npm test

Contributing 🌟

Contributions are welcome! Follow these steps to contribute:

  • Fork the repository Click the "Fork" button at the top-right corner of the repository page to create a personal copy.

  • Clone your forked repository

    git clone https://github.com/your-username/scruter.git
    cd scruter
    
  • Create a new branch

    git checkout -b feature-branch-name
    
  • Add your changes

    git add .
    
  • Make your changes and commit them

    git commit -m 'Add some feature'
    
  • Push to the branch

    git push origin feature-branch-name
    
  • Submit a pull request Go to the original repository and click on the "Pull Request" button to submit your changes.

For detailed guidelines on how to contribute to this project, please refer to the Contributing.md file.


License πŸ“œ

This project is licensed under the GPL-3.0 License.

Additional Tips πŸ”

Here are a few tips to ensure a smooth contribution process:

  1. Stay Updated Keep your forked repository up-to-date by syncing it with the original repository:

    git fetch upstream
    git checkout main
    git merge upstream/main
    
  2. Test Thoroughly Make sure to test your changes thoroughly before submitting them. You can do this by running the project locally:

    npm start
    

    If you're making significant changes, consider writing tests or ensuring existing tests pass by running:

    npm test
    
  3. Follow the Code Style Guidelines Adhering to the project's code style guidelines is crucial. If available, use the provided linting tools to ensure consistent code style:

    npm run lint
    
  4. Write Clear Commit Messages Always use clear and concise commit messages. A good format could be:

    [feature] Add feature to enhance user dashboard
    
  5. Engage in Discussions If you're unsure about a feature or want to suggest improvements, engage with the maintainers via the Discussions section.

Big thanks to all the contributors who have helped make Scruter a better platform! πŸŽ‰