subinoybiswas / clippy

Clippy is an online clipboard tool, to solve the age-old problem of coping and pasting a breeze, it also comes with features like file sharing.
https://clippy.subinoy.me
MIT License
7 stars 30 forks source link

Welcome to Clippy, It is an online clipboard tool, to solve the age-old problem of coping and pasting a breeze, it also comes with features like file sharing. Clippy is made with Nextjs and uses MongoDB for storage.

🏆 Featured in:

Event Logo Event Name Event Description
GSSoC 24 GirlScript Summer of Code 2024 GirlScript Summer of Code is a three-month-long Open Source Program conducted every summer by GirlScript Foundation. It is an initiative to bring more beginners to Open-Source Software Development.

Table of Contents

Usage

Clippy is publically available and hosted on Vercel, you can access Clippy here

Screenshots

Homepage Homepage

Making a Clippy Making a Clippy

Features

Setup Instructions

To get started with this project, follow these steps:

Installation

  1. Clone this repository:
git clone <link>
  1. Navigate to the Project Directory:
cd <filename>

Install Dependencies:

Install the dependencies using your preferred package manager. For example, if you're using npm:

npm install

Set Up Environment Variables:

This project requires environment variables for MongoDB connection. Create a .env file in the root directory of the project and add the following variables:

MONGODB_URI=<your_mongodb_uri>
MONGO_DB_NAME=<your_db_name>
MONGO_COLLECTION_NAME=<your_collection_name>

Run the Development Server:

Once you have installed the dependencies and set up the environment variables, you can start the development server by running:

npm run dev

Dockerfile:

Make sure you have docker & docker compose installed on the server / system. Both are installed by most docker utilities, including Docker Desktop and Rancher Desktop.

Note: docker compose without the hyphen is now the primary method of using docker-compose, per the Docker documentation. we have a demo dockerfile make sure u have a .dockerignore file in the root directory of the project. add following lines into it

node_modules

now run the image with injecting the env variables into the docker itself

docker build -t clippy .
docker run -p 3000:3000 -e MONGODB_URI=<your_mongodb_uri> -e MONGO_DB_NAME=<your_db_name> -e MONGO_COLLECTION_NAME=<your_collection_name> clippy

Contributing

If you'd like to contribute to this project, feel free to open an issue or submit a pull request. Contributions are welcome! , please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Make changes and commit them.
  4. Push your changes to your fork.
  5. Create a pull request.

Contibuting Guidelines

We believe in the power of collaboration. If you have ideas to improve College.ai, feel free to contribute! Check out our Contribution Guidelines to get started.

📄 Documentation

Explore our comprehensive documentation in the LEARN.md file, which serves as a detailed guide to understanding and contributing to Clippy. This document covers various aspects of the project, including setup instructions, architecture overview, and contribution guidelines. We recommend referring to this documentation to gain a deeper insight into UniCollab and make meaningful contributions to its development.

🌟 Join Us

Ready to embark on a journey of collaborative learning? Join Clippy now and be a part of a community that believes in the power of collaboration! Thank you for contributing to our open-source project! We appreciate your support 🚀 Don't forget to leave a star ⭐ Happy Coding!!❤️


Our Contributors

Thank you for contributing to our repository

![Contributors](https://contrib.rocks/image?repo=subinoybiswas/clippy) ### Show some ❤️ by starring this awesome repository! ![GitHub stars](https://img.shields.io/github/stars/subinoybiswas/clippy?color=brightgreen) ![GitHub forks](https://img.shields.io/github/forks/subinoybiswas/clippy?color=brightgreen) ![GitHub issues](https://img.shields.io/github/issues/subinoybiswas/clippy?color=brightgreen) ![GitHub closed issues](https://img.shields.io/github/issues-closed/subinoybiswas/clippy?color=brightgreen) ![GitHub pull requests](https://img.shields.io/github/issues-pr/subinoybiswas/clippy?color=brightgreen) ![GitHub release (latest by date)](https://img.shields.io/github/v/release/subinoybiswas/clippy?color=brightgreen)

{Back to top}