Skip to content
master
Switch branches/tags
Code

Latest commit

 

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Parabol - We're hiring!

Slack Status CircleCI StackShare

Overview

Parabol is an open-source SaaS application for running team retrospectives and operating a distributed organization. We publish our company's history and business metrics, too.

Dashboard Discuss

Stack Information

Concern Solution
Server Node
Server Framework uWebSockts.js
Database (Legacy) RethinkDB
Database PostgreSQL
PubSub & Cache Redis
Data Transport GraphQL
Real-time Connectivity trebuchet
Client Cache Relay
UI Framework React
Styling Emotion

Setup

Prerequisites

Installation

$ git clone https://github.com/ParabolInc/parabol.git
$ cd parabol
$ cp .env.example .env # Add your own vars here
$ yarn
$ yarn db:start
$ yarn dev

By default, the app will run at: http://localhost:3000/

If yarn db:start failed and localhost:5050 isn't working, a docker container, volume or image may be corrupted and need to be pruned.

Build for production and start application:

$ yarn && yarn build && yarn start

RethinkDB

  • Migrations are stored in packages/server/database/migrations
  • RethinkDB Dashboard is at http://localhost:8080

PostgreSQL

  • pgadmin is at http://localhost:5050

  • Connect using the values of PGADMIN_DEFAULT_EMAIL and PGADMIN_DEFAULT_PASSWORD from your .env

  • Click "Add New Server" and fill out the forms with your .env values

    • General.name = POSTGRES_DB
    • Connection.host = 'postgres' (hardcoded from docker-compose dev.yml, not from .env!)
    • Connection.username = POSTGRES_USER
    • Connection.password = POSTGRES_PASSWORD
    • Connection.maintenanceDatabase = POSTGRES_DB
    • Connection.port = POSTGRES_PORT
  • Fill out the form with values from your .env. Set the host to postgres

Getting Involved

Parabol offers equity for qualified contributions.

See CONTRIBUTING.md for more information on how to get involved and how to get compensated.

Have feedback, ideas or feature requests?

Please review our Discussions to see if there's already a similar suggestion, and if not please feel free to start a new one.

Helpful VSCode extensions

We use GraphQL for IntelliSense and syntax highlighting.

Releases

For details on all releases, refer to CHANGELOG.md.

Parabol Core Team

License

Copyright (c) 2016-present, Parabol, Inc.

This codebase is dual-licensed under the GNU AFFERO GENERAL PUBLIC LICENSE, Version 3.0 while holding, at Parabol's sole discretion, the right to create new licenses. For details please read LICENSE.