el.xwx.moe/README.md

48 lines
2.5 KiB
Markdown
Raw Normal View History

2022-06-08 13:28:44 -05:00
<div align="center">
<h1>
LinkWarden
2022-06-09 14:31:36 -05:00
2022-06-08 13:28:44 -05:00
<sub>A place for your useful links.</sub>
2022-06-09 15:17:00 -05:00
<img src="assets/LinkWarden.png" alt="LinkWarden.png" width="500px"/>
2022-06-08 13:28:44 -05:00
2022-06-10 01:59:27 -05:00
![GitHub](https://img.shields.io/github/license/daniel31x13/link-warden?style=flat-square) ![GitHub top language](https://img.shields.io/github/languages/top/daniel31x13/link-warden?style=flat-square) ![GitHub commit activity](https://img.shields.io/github/commit-activity/m/daniel31x13/link-warden?style=flat-square) ![GitHub last commit](https://img.shields.io/github/last-commit/daniel31x13/link-warden?style=flat-square) ![Netlify](https://img.shields.io/netlify/31890116-669c-4b1c-844e-fa427503d8bf?style=flat-square)
2022-06-08 13:28:44 -05:00
</h1>
2022-05-10 10:47:14 -05:00
2022-06-09 14:31:36 -05:00
[Demo](https://linkwarden.netlify.app/) | [Intro & Motivation](https://github.com/Daniel31x13/link-warden#intro--motivation) | [Features](https://github.com/Daniel31x13/link-warden#features) | [Setup](https://github.com/Daniel31x13/link-warden#setup) | [Development](https://github.com/Daniel31x13/link-warden#linkwarden-development)
2022-06-08 13:28:44 -05:00
</div>
## Intro & Motivation
**LinkWarden is a self-hosted, open-source bookmark + archive manager to collect, and save websites for offline use.**
The objective is to have a self-hosted place to keep useful links in one place, and since useful links can go away (see the inevitability of [Link Rot](https://www.howtogeek.com/786227/what-is-link-rot-and-how-does-it-threaten-the-web/)), LinkWarden also saves a copy of the link as screenshot and PDF.
## Features
- [x] Sleek, minimalist design.
- [x] Save a copy of each link as screenshot and PDF.
- [x] Dark/Light mode support.
- [x] Responsive design.
- [x] Search, filter and sorting functionality.
- [x] Lazy loading support (for better performance).
- [x] Set multiple tags to each link.
2022-06-11 00:35:10 -05:00
**Also take a look at our planned features in the [project roadmap section](https://github.com/Daniel31x13/link-warden/wiki#project-roadmap).**
2022-06-08 13:28:44 -05:00
2022-05-11 05:49:39 -05:00
## Setup
2022-06-08 13:28:44 -05:00
### Linux/MacOS
2022-06-09 01:09:55 -05:00
1. Make sure your MongoDB database and collection is up and running.
2022-05-11 05:49:39 -05:00
2022-06-10 00:15:03 -05:00
2. Edit [/src/config.js](src/config.js) accordingly.
2022-05-11 05:49:39 -05:00
2022-06-10 00:38:45 -05:00
3. Head to the main folder using terminal and run: `(cd api && npm install) && npm install --legacy-peer-deps` for the dependencies.
2022-05-11 05:49:39 -05:00
2022-06-08 13:28:44 -05:00
4. Run `npm start` to start the application.
2022-06-09 01:09:55 -05:00
## LinkWarden Development
All contributions are welcomed! Please take a look at [how to contribute](.github/CONTRIBUTING.md).
2022-06-09 15:17:00 -05:00
> **For questions/help, feature requests and bug reports please create an [issue](https://github.com/Daniel31x13/link-warden/issues) (please use the right lable).**