HTML JavaScript Other
Clone or download
Latest commit fc4dd16 Aug 6, 2018
Permalink
Failed to load latest commit information.
appengine Notifications (#312) Sep 10, 2017
config Update configs Jul 12, 2018
data Update documentation (#466) Jul 10, 2018
docs Update README.md Jul 25, 2018
functions Fix Windows deploy Jul 24, 2018
gulp-tasks Full size header (#404) Feb 19, 2018
images Replace images. Use markdown for posts brief Jul 7, 2018
internals Add firestore tooling Jul 8, 2018
scripts Fix sessions to speakers binding Jul 3, 2018
src change galleryBlock.callToAction.url to galleryBlock.callToAction.link Aug 6, 2018
.babelrc Add firestore tooling Jul 8, 2018
.editorconfig Update project structure. Update Gulp task. Update router. Feb 29, 2016
.eslintrc.json Previous speakers (#434) Apr 23, 2018
.gitignore chore(git): prevent commit of service account file Jul 14, 2018
.travis.yml Update configs Jul 12, 2018
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Jul 12, 2018
CONTRIBUTING.md Release v.1.0.0 (#100) Aug 18, 2016
Dockerfile chore(dep): remove global dependencies for dev dependencies Feb 26, 2017
LICENSE.md Prepare to release Mar 13, 2016
README.md Update README.md Jul 21, 2018
bower.json Migration from Realtime Database to Firestore (#440) Jun 28, 2018
database.rules.json Migration from Realtime Database to Firestore (#440) Jun 28, 2018
firebase-messaging-sw.js Refresh toast sw (#409) Feb 23, 2018
firebase.json Fix Windows deploy Jul 24, 2018
firestore.indexes.json Migration from Realtime Database to Firestore (#440) Jun 28, 2018
firestore.rules Migration from Realtime Database to Firestore (#440) Jun 28, 2018
gulpfile.js Fix the deploy task (#407) Feb 21, 2018
index.html Update documentation (#466) Jul 10, 2018
manifest.json Notifications (#312) Sep 10, 2017
npm-debug.log Improve after CR Jun 26, 2017
package-lock.json Fix the deploy task (#407) Feb 21, 2018
package.json Fix Windows deploy Jul 24, 2018
polymer.json Add cod page to the build. Fix #477 Jul 24, 2018
service-worker.js Release v.1.0.0 (#100) Aug 18, 2016
sw-precache-config.js Migration from Realtime Database to Firestore (#440) Jun 28, 2018
yarn.lock Update lockfile Jul 8, 2018

README.md

⚡️ Live demo  |   🚀 Get Started

Build Status FOSSA Status

Overview

Project Hoverboard is the conference website template that helps you to set up mobile first conference website with blog, speakers and schedule management in a few minutes.

The template is created based on 7 years of GDG Lviv team experience of running conferences and feedback from more than 500 event organizers from all around the world who were using previous Hoverboard versions.

Our goal is to allow event organizers to set up professional conference website with minimum resources. To get started you need only basic knowledge of web technologies and a free Firebase account.

Features

Feature Description
Fast and optimized 91/100 PWA on Lighthouse
Works offline shitty WiFi on the venue is not a problem anymore
Mobile first layouts optimized for small screens, Hoverboard can be installed as a native app on your phone
Push notifications remind about sessions in My schedule, session feedback or target users with a custom message
SEO optimized index all content and get to the top in search results
Speakers and schedule management keep and update all information in the Firebase
My schedule let attendees save sessions they want to visit
Customizable theme change colors to match your style
Blog post announcements, updates and useful information

Getting Started

  1. Fork repository and clone it locally
  2. Setup Environment
  3. Install project dependencies: npm install or yarn
  4. Create Firebase account and login into Firebase CLI: firebase login
  5. Update Hoverboard config and Resources
  6. Import initial data to the Firebase Database
  7. Run locally
    • npm run serve or yarn serve
  8. Build and deploy
    • npm run deploy or yarn deploy

NOTE: By default command using configurations from /configs/development.json. To serve locally or deploy the production app use yarn serve:prod and yarn deploy:prod respectively.

📖 Read the Full Setup Guide.

Docker-based development environment

If you don't want to bother with the dependencies, you can use the docker container for development.

📖 Read more in docker docs.

Updating

Here is a git workflow for updating your fork (or downloaded copy) to the latest version:

git remote add upstream https://github.com/gdg-x/hoverboard.git
git fetch upstream
git merge upstream/hoverboard
# resolve the merge conflicts in your editor
git add . -u
git commit -m 'Updated to the latest version'

Documentation

The Getting Started guide is probably a good first point of call!
📖 Full documentation.

Compatibility

Compatible with latest two version of Chrome, Chrome for Android, Firefox, Opera, Safari, Edge.
IE and Opera Mini aren't supported.

Technology Stack

  • Polymer 2
  • Redux
  • Firebase
  • Service Worker
  • CSS Grid

Contributing

Awesome! Contributions of all kinds are greatly appreciated. To help smoothen the process we have a few non-exhaustive guidelines to follow which should get you going in no time.

Good First Issue

Issues labeled good first issue are a great way to ease into development on this project.

Help Wanted Label

Any other issue labeled help wanted is ready for a PR.

Using GitHub Issues

  • Feel free to use GitHub issues for questions, bug reports, and feature requests
  • Use the search feature to check for an existing issue
  • Include as much information as possible and provide any relevant resources (Eg. screenshots)
  • For bug reports ensure you have a reproducible test case
    • A pull request with a breaking test would be super preferable here but isn't required

Submitting a Pull Request

  • Squash commits
  • Lint your code with eslint (config provided)
  • Include relevant test updates/additions

Code of Conduct

Read the full version Code of Conduct.

Contributors

Maintainer: Oleh Zasadnyy and Sophie Huts.

This project exists thanks to all the people who contribute. [Contribute].

Sponsoring

Most of the core team members, hoverboard contributors and contributors in the ecosystem do this open source work in their free time. If you like this project and it makes your life easier, please donate.

License

FOSSA Status

Project is published under the MIT license.
Feel free to clone and modify repo as you want, but don't forget to add reference to authors :)

GDG[x] are not endorsed and/or supported by Google, the corporation.