Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/soulsam480/furikaeru

A small app to discuss retrospective while being Anonymous. Create public/private boards with a simple kanban board interface and realtime changes. Flexible, simple and free.
https://github.com/soulsam480/furikaeru

expressjs postgres retro typescript vue vuejs websockets

Last synced: 3 months ago
JSON representation

A small app to discuss retrospective while being Anonymous. Create public/private boards with a simple kanban board interface and realtime changes. Flexible, simple and free.

Awesome Lists containing this project

README

        


Furi logo


Furikaeru

> A look back

A small app for discussing retro while being `Anonymous`. Create public/private boards with a simple `kanban` baord interface and `realtime` changes. Built with a smooth and approachable UI, Furi is is more than an app for discussing retro. See releases [here](https://github.com/soulsam480/furikaeru/releases)

![GitHub package.json version](https://img.shields.io/github/package-json/v/soulsam480/furikaeru)

### Status

- Hosted -> https://furikaeru.sambitsahoo.com
- Development -> v0.0.1 (Might be the last release of Furikaeru)
- Roadmap board -> [Don't spam please!](https://furikaeru.sambitsahoo.com/Furi_feature_board--c32276c9-d259-409a-9663-b5fdbbbcf997)

> __Visit__ [Furi component lib readme](./lib/README.md)

> __npm__ https://www.npmjs.com/package/furikaeru

#### Features
Current:
- Create/delete Boards
- Add/Edit/remove Cards
- Vote on cards
- Comment on cards
- Column color customization
- Private boards
- Board archive/restore
- Focus mode
- Keyboard shortcuts

Projected:
- Add comment edit
- Add more in the public [feature board](https://furikaeru.sambitsahoo.com/Furi_feature_board--c32276c9-d259-409a-9663-b5fdbbbcf997)

#### Furi component library
At the heart of `Furikaeru`, there is a standalone `vue 3` component library. There are only a few components, which are being used repeatedly throughout the app. It was designed on the basis of the project needs but has room for customisations. To view or use the components have a look [here](./lib).

#### Stack

API:
- Postgres
- TypeORM
- Expressjs
- SocketIo
- Passport (Google OAuth2)
- TypeScript

APP:
- Vue 3
- Vite
- Vue router
- Pinia
- SocketIo client
- Iconify
- Purge icons
- TypeScript

#### Run it lcally
> You need to have yarn installed as this repo is a `Yarn Workspace`.

- Clone/fork repo
```bash
yarn # install deps
```
- Add `env` variables.
```bash
# APP
VITE_WSS # Socket endpoint -> ws://localhost:3000
VITE_API # REST endpoint -> http://localhost:3000/furikaeru

#API
REFRESH_TOKEN_SECRET
ACCESS_TOKEN_SECRET
GCLIENT_ID
GCLIENT_SECRET
GAUTH_REDIRECT
# create a postgres db and add it here
# the DB port is hardcoded to 5432 and an extra env variable can be added to change it
PGRES_USER
PGRES_PASS
PGRES_HOST
PGRES_DB
```
- Run
```bash
yarn dev # devserver
yarn build # build
```
Any contributions are welcome. reach me on [[email protected]](mailto:[email protected])