Welcome to BitLinks, a free and open-source URL shortener. BitLinks allows you to quickly generate short URLs from long ones without needing to sign up or log in. Just paste your full URL, specify your preferred short URL text, and generate!
- Free: Completely free to use.
- No Sign-Up Required: Start shortening URLs instantly without the hassle of creating an account.
- Custom Short URLs: Choose your own preferred short URL text.
- Frontend: Next.js, React.js
- Styling: Tailwind CSS
- Notifications: react-hot-toast
- Ensure you have Node.js (version 16 or higher) and npm or yarn installed on your machine.
-
Fork This Repository:
- Click the "Fork" button at the top right corner of this repository to create a copy under your GitHub account.
-
Clone the Repository:
git clone https://github.com/namankoolwal/BitLinks-url-Shortner.git
Replace
your-username
with your GitHub username. -
Navigate to the Project Directory:
cd BitLinks-url-Shortner
-
Install Dependencies: Using npm:
npm install
or using yarn:
yarn install
-
Set Up Environment Variables:
- Create a
.env.local
file in the root directory. - Add your environment variables:
- NEXT_PUBLIC_BASE_URL= http://localhost:3000 - MONGODB_URI= <YOUR MONGODB URI>
- Create a
-
Run the Development Server: Using npm:
npm run dev
or using yarn:
yarn dev
-
Open your browser and visit:
http://localhost:3000
- Fork the project.
- Clone your forked repository:
git clone https://github.com/namankoolwal/BitLinks-url-Shortner.git
- Create a Branch for your feature or bug fix:
git checkout -b feature-name
- Make Your Changes and commit:
git add . git commit -m "Description of your changes"
- Push to Your Branch:
git push origin feature-name
- Submit a Pull Request: Open a pull request to the
main
branch of this repository and describe your changes.
If you find this project helpful or inspiring, please give it a ⭐ on GitHub. Your support is much appreciated!
Feedback and collaboration are always welcome! If you have suggestions for improvements or want to contribute, feel free to open an issue or submit a pull request. Let's make BitLinks even better together!
This project is licensed under the MIT License. See the LICENSE
file for more information.
Thank you for checking out BitLinks! Happy shortening!