Ecosyste.ms: Awesome

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

https://github.com/frappe/gameplan

Delightful, open-source, work communication tool for remote teams
https://github.com/frappe/gameplan

async collaboration communication delightful discussions forum project-management

Last synced: about 1 month ago
JSON representation

Delightful, open-source, work communication tool for remote teams

Lists

README

        


Gameplan logo

Delightful, open-source, work communication tool for remote teams



cypress


license

Screenshot 2022-09-18 at 9 16 08 PM

Show more screenshots

Screenshot 2022-09-18 at 9 18 17 PM

Screenshot 2022-09-18 at 9 18 47 PM

Screenshot 2022-09-18 at 11 47 06 PM

Gameplan is a work communication tool for teams who mostly work remote and prefer having meaningful discussions in an async format. We built it for ourselves because we were finding it difficult to keep track of so many conversations in our chat tool. Chat forces you to be online all the time and doesn't really have any concept of threaded discussions. Gameplan allows you to categorize your discussions around projects and teams. It also doubles up as your team's knowledge archive. You can surface important information and conclusions from your discussions into the readme's of your projects and teams.

## Features
- Organize discussions into projects which in turn are part of a team ๐Ÿ—„
- Surface important information for your project and team in the Readme ๐Ÿ“
- Simple layout that optimizes readability of discussions ๐Ÿค“
- Customize your Team and Project with emojis ๐Ÿ’…๐Ÿป
- People directory with each person's profile page ๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘งโ€๐Ÿ‘ฆ
- Set cover image, profile photo, short bio and a "About me" section ๐Ÿฆน๐Ÿผโ€โ™€๏ธ
- Powerful search capabilities to find older discussions ๐Ÿ”
- A common discussions feed that shows discussions from across projects and teams ๐Ÿ“š
- Delightful user-experience in overall usage โœจ

## Tech Stack

### Backend
Gameplan is built on [Frappe Framework](https://frappeframework.com) which is a batteries-included python web-framework.
These are some of the tools it's built on:
- [Python](https://www.python.org)
- [Redis](https://redis.io/)
- [MariaDB](https://mariadb.org/)
- [Socket.io](https://socket.io/)

### Frontend
The frontend of Gameplan is a VueJS SPA which uses a component library called [Frappe UI](https://github.com/frappe/frappe-ui).
These are some of the tools used on frontend:
- [VueJS](https://vuejs.org)
- [Frappe UI](https://github.com/frappe/frappe-ui)
- [TailwindCSS](https://tailwindcss.com)
- [HeadlessUI](https://headlessui.com)

## Local Setup
### Docker
You need Docker, docker-compose and git setup on your machine. Refer [Docker documentation](https://docs.docker.com/). After that, run the following commands:
```
git clone https://github.com/frappe/gameplan
cd gameplan/docker
docker-compose up
```

Wait for sometime until the setup script creates a site. After that you can
access `http://localhost:8000` in your browser and Gameplan's login screen
should show up.

Use the following credentials to log in:

- Username: `[email protected]`
- Password: `123`

### Frappe Bench

Currently, this app depends on the `develop` branch of [frappe](https://github.com/frappe/frappe).

1. Setup frappe-bench by following [this guide](https://frappeframework.com/docs/v14/user/en/installation)
1. In the frappe-bench directory, run `bench start` and keep it running. Open a new terminal session and cd into `frappe-bench` directory.
1. Run the following commands:
```sh
bench new-site gameplan.test
bench get-app gameplan
bench --site gameplan.test install-app gameplan
bench --site gameplan.test add-to-hosts
bench --site gameplan.test browse --user Administrator
```
1. Now, open a new terminal session and cd into `frappe-bench/apps/gameplan`, and run the following commands:
```
yarn
yarn dev
```
1. Now, you can access the site on vite dev server at `http://gameplan.test:8080`

## Deployment
Gameplan is an app built on top of Frappe Framework. So, you can follow any deployment guide for hosting a Frappe Framework based site.

### Managed Hosting
Gameplan can be deployed in a few clicks on [Frappe Cloud](https://frappecloud.com/marketplace/apps/gameplan).

### Self hosting
If you want to self-host, you can follow official [Frappe Bench Installation](https://github.com/frappe/bench#installation) instructions.

## Discussions
If you have an idea that you think Gameplan should implement or you just want to hangout with other Gameplan users, you can join [Discussions](https://github.com/frappe/gameplan/discussions).

## Reporting Bugs
If you find any bugs, feel free to report them here on [GitHub Issues](https://github.com/frappe/gameplan/issues). Make sure you share enough information (app screenshots, browser console screenshots, stack traces, etc) for project maintainers to replicate your bug.

## License

AGPLv3