{"id":45083468,"url":"https://github.com/pebble-dev/developer.rebble.io","last_synced_at":"2026-02-19T15:07:25.540Z","repository":{"id":293955656,"uuid":"941304142","full_name":"pebble-dev/developer.rebble.io","owner":"pebble-dev","description":"Rebble's developer resources site","archived":false,"fork":false,"pushed_at":"2026-01-17T09:37:59.000Z","size":78213,"stargazers_count":7,"open_issues_count":25,"forks_count":22,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-01-17T14:36:51.873Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pebble-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-02T00:56:53.000Z","updated_at":"2026-01-17T09:38:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"1b44e700-210d-4529-95e0-b7b2287ca3e7","html_url":"https://github.com/pebble-dev/developer.rebble.io","commit_stats":null,"previous_names":["pebble-dev/developer.rebble.io"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pebble-dev/developer.rebble.io","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pebble-dev%2Fdeveloper.rebble.io","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pebble-dev%2Fdeveloper.rebble.io/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pebble-dev%2Fdeveloper.rebble.io/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pebble-dev%2Fdeveloper.rebble.io/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pebble-dev","download_url":"https://codeload.github.com/pebble-dev/developer.rebble.io/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pebble-dev%2Fdeveloper.rebble.io/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29619287,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T13:04:20.082Z","status":"ssl_error","status_checked_at":"2026-02-19T13:03:33.775Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-19T15:07:24.743Z","updated_at":"2026-02-19T15:07:25.529Z","avatar_url":"https://github.com/pebble-dev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [developer.rebble.io][site]\n\n[![Build static site](https://github.com/pebble-dev/developer.rebble.io/actions/workflows/build.yml/badge.svg)](https://github.com/pebble-dev/developer.rebble.io/actions/workflows/build.yml)\n\nThis is the repository for the [Pebble Developer website][site].\n\nThe website is built using [Jekyll](http://jekyllrb.com) with some plugins that\nprovide custom functionality.\n\nFor anyone who wants to contribute to the content of the site, you should find\nthe information in one of the sections below.\n\n* [Blog Posts](#blog-posts)\n* [Markdown](#markdown)\n* [Landing Page Features](#landing-page-features)\n* [Colors](#colors)\n\n## Getting Started\n\n### Option 1:  Install with Docker\n\nClone repo to your local machine. From the repo root, enter: \n\n```\ndocker build -t rebble-dev .\n\ndocker run --rm -it -p 4000:4000 -v \"$PWD\":/site -w /site rebble-dev \\\n  bundle exec jekyll serve --host 0.0.0.0 --port 4000\n```\nThen open http://localhost:4000\n\n### Option 2:  Install natively (without Docker)\n\nOnce you have cloned the project you will need to run `bundle install` to\ninstall the Ruby dependencies. If you do not have [bundler](http://bundler.io/)\ninstalled you will need to run `[sudo] gem install bundler` first.\n\nYou should also do `cp .env.sample .env` and edit the newly created `.env` file\nwith the appropriate values. Take a look at the\n[Environment Variables documentation](/docs/environment.md) for more details.\n\nTo start the Jekyll web server, run `bundle exec jekyll serve`.\n\n## JS Documentation\n\nThe PebbleKit JS and Rocky documentation is generated with the\n[documentation.js](documentation.js.org) framework. The documentation tool can\ncreate a JSON file from the JSDocs contained in the [js-docs](/js-docs)\nfolder.\n\nTo install documentation.js, run `npm install -g documentation`\n\nTo regenerate the `/source/_data/rocky-js.json` file, run `./scripts/generate-rocky-docs.sh`\n\n\u003e **NOTE**: This is intended to be a temporary hack. Ideally the rocky-js.json\n\u003e file is generated as part of the release generator (and built using the actual\n\u003e Rocky.js source, or stubs in the Tintin repository.\n\n## Blog Posts\n\n### Setting up a new author\nAdd your name to the `source/_data/authors.yml` so the blog knows who you are!\n\n```\nblogUsername:\n  name: First Last\n  photo: https://example.com/you.png\n```\n\n### Creating a new blog post\nAdd a Markdown file in `source/_posts/` with a filename in following the\nformat: `YYYY-MM-DD-Title-of-the-blog-most.md`.\n\nStart the file with a block of YAML metadata:\n\n```\n---\ntitle: Parlez-vous Pebble? Sprechen sie Pebble? ¿Hablas Pebble?\nauthor: blogUsername\ntags:\n- Freshly Baked\n---\n```\n\nYou should pick one tag from this list:\n\n* Freshly Baked - Posts announcing or talking about new features\n* Beautiful Code - Posts about writing better code\n* \"#makeawesomehappen\" - Hackathons/events/etc\n* At the Pub - Guest Blog Posts (presumably written at a pub)\n* Down the Rabbit Hole - How Pebble works 'on the inside'\n* CloudPebble - Posts about CloudPebble\n* Timeline - Posts about Timeline\n\n### Setting the post's preview text\n\nThe blog's homepage will automatically generate a 'preview' of your blog post. It does this by finding the first set of 3 consecutive blank lines, and using everything before those lines as the preview.\n\nYou should aim to have your preview be 1-2 paragraphs, and end with a hook that causes the reader to want to click the 'Read More' link.\n\n## Markdown\n\nThere is a [Markdown styleguide and additional syntax cheatsheat][markdown]\nyou should use if you are writing any Markdown for the site. That includes all\nblog posts and guides.\n\n## Landing Page Features\n\nThe landing page of the website contains a slideshow (powered by [slick][slick]).\nThe contents of the slideshow, or 'features' as we call them, are generated\nfrom the features data file found at `source/_data/features.yaml`.\n\nThere are two main types of features, images and videos.\n\n### Image Feature\n\n```yaml\n- title: Want to make your apps more internationally friendly?\n  url: /guides/publishing-tools/i18n-guide/\n  background_image: /images/landing-page/i18n-guide.png\n  button_text: Read our brand new guide to find out how\n  button_fg: black\n  button_bg: yellow\n  duration: 5000\n```\n\nIt should be relatively clear what each of the fields is for. For the\n`button_fg` and `button_bg` options, check out the [colors](#colors) section\nfor the available choices.\n\nThe `background_image` can either be a local asset file or an image on an\nexternal web server.\n\n**Please Remember:** The landing page will see a lot of traffic so you\nshould strive to keep image sizes small, while still maintaing relatively large\ndimensions. Run the images through minifying tools, such as\n[TinyPNG][tinypng] or [TinyJPG][tinyjpg], before commiting them to the site.\n\n### Video Feature\n\n```yaml\n- title: Send a Smile with Android Actionable Notifications\n  url: /blog/2014/12/19/Leverage-Android-Actionable-Notifications/\n  background_image: /images/landing-page/actionable-notifications.png\n  video:\n    url: https://s3.amazonaws.com/developer.getpebble.com/videos/actionable-notifications.mp4\n  button_text: Learn how to supercharge Your Android Apps\n  button_fg: white\n  button_bg: green\n  duration: 5000\n```\n\nTo prevent massively bloating the size of this repository, we are hosting all\nvideos externally on S3. If you do not have permission to upload videos to our\nS3 bucket, you will need to ask someone who does!\n\nIn order to enable to videos to play across all of the browsers + platforms,\nyou will need to provided the video in MP4, OGV and WEBM formats.\nThere is a script provided in the scripts folder to do the automatic conversion\nfrom MP4, and to export the first frame of the video as a PNG used as a\nplaceholder while the video loads.\n\n```sh\n./scripts/video-encode.sh PATH_TO_MP4\n```\n\nIf you run the script as above, it will create an OGV, WEBM and PNG file in the same folder as the MP4. The PNG file should go in the `/assets/images/landing-page/` folder, and the three video files should be uploaded to S3.\n\n## Colors\n\nButtons and Alerts come are available in several different color options, with\nboth foreground and background modifier classes to give you maximum control.\n\nThe available colors:\n\n* white\n* green\n* blue\n* red\n* purple\n* yellow\n* orange\n* lightblue\n* dark-red\n\nTo set the background, use `--bg-\u003cCOLOR\u003e` modifier. To set the foreground (i.e)\nthe text color, use `--fg-\u003cCOLOR\u003e`.\n\n## Troubleshooting\n\nTrouble building the developer site? Read the [Troubleshooting](/docs/troubleshooting.md) page for some possible solutions.\n\n[site]: https://developer.rebble.io\n[markdown]: ./docs/markdown.md\n[slick]: http://kenwheeler.github.io/slick/\n[tinypng]: https://tinypng.com/\n[tinyjpg]: https://tinyjpg.com/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpebble-dev%2Fdeveloper.rebble.io","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpebble-dev%2Fdeveloper.rebble.io","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpebble-dev%2Fdeveloper.rebble.io/lists"}