Skip to content

frappe/gameplan

Repository files navigation

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 which is a batteries-included python web-framework. These are some of the tools it's built on:

Frontend

The frontend of Gameplan is a VueJS SPA which uses a component library called Frappe UI. These are some of the tools used on frontend:

Local Setup

Docker

You need Docker, docker-compose and git setup on your machine. Refer Docker documentation. 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:

Frappe Bench

Currently, this app depends on the develop branch of frappe.

  1. Setup frappe-bench by following this guide
  2. In the frappe-bench directory, run bench start and keep it running. Open a new terminal session and cd into frappe-bench directory.
  3. Run the following commands:
    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
  4. Now, open a new terminal session and cd into frappe-bench/apps/gameplan, and run the following commands:
    yarn
    yarn dev
    
  5. 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.

Self hosting

If you want to self-host, you can follow official 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.

Reporting Bugs

If you find any bugs, feel free to report them here on GitHub Issues. Make sure you share enough information (app screenshots, browser console screenshots, stack traces, etc) for project maintainers to replicate your bug.

License

AGPLv3