About this project

Colly is an open-source, web-based URL collection application that lets users create a personalized library of web pages. Its core feature is a tagging system for categorizing and organizing links — articles, blogs, tutorials, or any web content — enabling efficient retrieval and navigation. Collections can be set as public and shared via a public access link. The application consists of a TypeScript/Node.js/Express backend and a React/Vite/Bootstrap frontend. It requires a MongoDB database for data storage and an S3-compatible object store (e.g., RustFS, MinIO, AWS S3) for image metadata such as website icons and banners. Deployment is recommended via Docker Compose; a ready-to-use docker-compose.yml and .env.example are provided. Manual deployment is also documented. Environment variables configure the database, JWT secret, S3 endpoint, logging (including optional Grafana Loki), and HTTPS enforcement. Development tooling includes pnpm scripts for building, testing (Mocha/Chai), linting, formatting, and seeding test data. Colly is licensed under MIT and welcomes contributions from developers of all experience levels.