cryptgeon/README.md

80 lines
2.5 KiB
Markdown
Raw Normal View History

2021-05-02 14:40:06 +02:00
<p align="center">
2021-11-23 15:43:57 +01:00
<img src="./design/Github.png" alt="logo">
2021-05-02 14:40:06 +02:00
</p>
2021-05-01 12:40:02 +02:00
2021-11-23 15:43:57 +01:00
<a href="https://discord.gg/nuby6RnxZt">
<img alt="discord" src="https://img.shields.io/discord/252403122348097536?style=for-the-badge" />
<img alt="docker pulls" src="https://img.shields.io/docker/pulls/cupcakearmy/cryptgeon?style=for-the-badge" />
<img alt="Docker image size badge" src="https://img.shields.io/docker/image-size/cupcakearmy/cryptgeon?style=for-the-badge" />
<img alt="Latest version" src="https://img.shields.io/github/v/release/cupcakearmy/cryptgeon?style=for-the-badge" />
</a>
2021-05-02 16:02:57 +02:00
2021-11-23 15:43:57 +01:00
<br/>
2021-06-01 12:23:08 +02:00
<a href="https://www.producthunt.com/posts/cryptgeon?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-cryptgeon" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=295189&theme=light" alt="Cryptgeon - Securely share self-destructing notes | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
2021-11-23 15:43:57 +01:00
<br/>
2021-06-01 12:23:08 +02:00
2021-05-02 14:40:06 +02:00
## About?
2021-05-03 12:38:51 +02:00
_cryptgeon_ is a secure, open source sharing note service inspired by [_PrivNote_](https://privnote.com)
2021-05-02 14:40:06 +02:00
2021-05-02 15:24:19 +02:00
## Demo
Check out the demo and see for yourself https://cryptgeon.nicco.io.
2021-05-02 14:40:06 +02:00
## Features
2021-05-03 12:21:44 +02:00
- server cannot decrypt contents due to client side encryption
2021-05-05 10:52:10 +02:00
- view and time constraints
2021-05-02 14:40:06 +02:00
- in memory, no persistence
2021-05-02 16:57:56 +02:00
- obligatory dark mode support
2021-05-02 14:40:06 +02:00
## How does it work?
each note has a 512bit generated <i>id</i> that is used to retrieve the note. data is stored in memory and never persisted to disk.
2021-05-02 15:12:04 +02:00
## Screenshot
2021-05-02 17:12:12 +02:00
![screenshot](./design/Screens.png)
2021-05-02 15:12:04 +02:00
2021-05-02 14:40:06 +02:00
## Deployment
2021-09-01 11:10:02 +02:00
`https` is required otherwise browsers will not support the cryptographic functions.
2021-05-02 16:02:57 +02:00
Docker is the easiest way. There is the [official image here](https://hub.docker.com/r/cupcakearmy/cryptgeon).
2021-05-02 14:40:06 +02:00
```yaml
# docker-compose.yml
version: '3.7'
services:
memcached:
image: memcached:1-alpine
2021-05-02 14:54:57 +02:00
entrypoint: memcached -m 128 # Limit to 128 MB Ram, customize at free will.
2021-05-02 14:40:06 +02:00
app:
image: cupcakearmy/cryptgeon:latest
2021-05-04 19:30:25 +02:00
depends_on:
2021-09-01 10:19:15 +02:00
- memcached
2021-05-02 14:40:06 +02:00
ports:
- 80:5000
```
2021-05-02 15:52:03 +02:00
## Development
1. Clone
2021-12-16 13:40:50 +01:00
2. run `pnpm i` in the root and and client `client/` folders.
3. Run `pnpm run dev` to start development.
2021-05-02 15:52:03 +02:00
Running `npm run dev` in the root folder will start the following things
- a memcache docker container
- rust backend with hot reload
- client with hot reload
You can see the app under [localhost:3000](http://localhost:3000).
2021-05-02 14:40:06 +02:00
###### Attributions
Icons made by <a href="https://www.freepik.com" title="Freepik">freepik</a> from <a href="https://www.flaticon.com/" title="Flaticon">www.flaticon.com</a>