Welcome to SnapURL, a URL shortener application designed to make your links shorter and easier to share. Built with TypeScript, MongoDB, React, Vite, and Express, SnapURL offers a fast and user-friendly way to shorten URLs with just a few clicks.
- URL Shortening: Convert long URLs into short, manageable links.
- Link Management: Easily manage your shortened URLs.
- Analytics: Track how many times your links are clicked.
- User Accounts: Create an account to manage your links and view analytics.
Before you begin, ensure you have met the following requirements:
- Node.js (LTS version)
- MongoDB (Local or Cloud Atlas)
- Yarn or npm installed
To install SnapURL, follow these steps:
- Clone the repository:
git clone https://github.com/holabayor/SnapURL.git
cd SnapURL
- Install backend dependencies:
cd server
npm install
- Install frontend dependencies:
cd ../client
npm install
- Create a .env file in the backend directory with your MongoDB URI and any other environment variables. See the .env.example file:
MONGODB_URI=your_mongodb_uri
PORT=8000
To run SnapURL, you'll need to start both the backend and frontend servers.
- Start the backend server:
cd server
npm run dev
In a new terminal, start the frontend server:
cd client
npm run dev
Navigate to http://localhost:3000 to see the application in action.
Contributions to SnapURL are welcome!
- Fork the project.
- Create a new branch (git checkout -b feature/AmazingFeature).
- Commit your changes (git commit -m 'Add some AmazingFeature').
- Push to the branch (git push origin feature/AmazingFeature).
- Open a pull request.
This project is licensed under the MIT License - see the LICENSE file for details.
SnapURL is an open-source project developed by Aanuoluwapo Liasu. For questions and support, please open an issue in the GitHub repository.