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 @ jedi@gitshowcase.com
- Ruby
2.4.0
recommended - Postgres 9.2+
- NodeJS (for compiling javascript resources)
- Fork the project
- Run bundle to install gems
bundle install
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.
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
- Create the databases:
rails db:create
- Run migrations to create tables:
rails db:migrate
- Seeding:
rails db:seed
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
To run the tests, use:
bundle exec rspec
Start Rails, Redis and Sidekiq.
rails s
redis-server
bundle exec sidekiq
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.
Pedro Moreira (Developer) - https://www.gitshowcase.com/pedsmoreira
Victor Hunter (UI/UX) - https://www.gitshowcase.com/victorgaard
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.
TODO - Add code styling (Rubocop) to Travis CI
The Pull Request must not present issues on Code Climate.
Commit messages should be verb based, such as:
- Fixing ...
- Adding ...
- Updating ...
- Removing ...
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 :)