GitShowcase

GitShowcase exists to help developers to present their awesomeness, showing their skills, projects and social networks in a way that is easy to understand.

Contact us @ [email protected]

Table of Contents

• Install
• Road map
• Maintainers
• Contribute
• License

Install

System Requirements

• Ruby 2.4.0 recommended
• Postgres 9.2+
• NodeJS (for compiling javascript resources)

Fork and bundle

• Fork the project
• Run bundle to install gems

bundle install

Create your GitHub application

Unless you only want to edit the homepage, you'll need your own GitHub credentials for development.

Go to your settings, than OAuth applications and register a new application.

For Authorization callback URL field, use: http://localhost:3000/users/auth/github/callback. The other fields (name, description) may be filled at your will.

Configure your environment

Copy the file .env.example to .env and fill the fields

DB_USERNAME=
DB_PASSWORD=

APP_DOMAIN=localhost

GITHUB_KEY=
GITHUB_SECRET=

If you're using Linux or OSX, you probably don't need to fill the DB_ fields

Database setup

Download and Install Postgres

• Create the databases:

rails db:create

• Run migrations to create tables:

rails db:migrate

• Seeding:

rails db:seed

Redis setup

Redis is used for managing queues inside the application.

For more information about how to install Redis, please refer to https://redis.io/topics/quickstart

Running Tests

To run the tests, use:

bundle exec rspec

Running Server

Start Rails, Redis and Sidekiq.

rails s
redis-server
bundle exec sidekiq

Road map

We have a road map of what we are going to implement next. It is available at our projects page

https://github.com/gitshowcase/gitshowcase/projects

If you wish to add features that are not on the road map, you're very welcome to do so. We encourage you to create an Issue before coding, so we can all discuss the relevance to the community.

Please keep in mind that the focus is to create a great product, so we might not implement/accept all the suggested features.

Maintainers

Pedro Moreira (Developer) - https://www.gitshowcase.com/pedsmoreira

Victor Hunter (UI/UX) - https://www.gitshowcase.com/victorgaard

Contribute

All contributions must be written in English, so everyone can communicate :)

Feel free to Open an issue or submit PRs. If you choose to open a PR, please do so on the development branch.

GitShowcase follows the Contributor Covenant Code of Conduct.

Code Style

TODO - Add code styling (Rubocop) to Travis CI

Code Quality

The Pull Request must not present issues on Code Climate.

Commit Messages

Commit messages should be verb based, such as:

• Fixing ...
• Adding ...
• Updating ...
• Removing ...

Tests

Please update the tests to reflect your changes.

Travis CI will run on your PR and it has to pass for the PR to be accepted :)

License

gitshowcase.com/license