{"id":20906460,"url":"https://github.com/jifalops/app-starter","last_synced_at":"2025-06-23T19:03:40.225Z","repository":{"id":149231270,"uuid":"81002976","full_name":"jifalops/app-starter","owner":"jifalops","description":"A starting point for using Polymer, Firebase, Geofire, and username/provider logins.","archived":false,"fork":false,"pushed_at":"2017-05-15T18:51:57.000Z","size":356,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-06-10T03:43:02.100Z","etag":null,"topics":["firebase","geofire","polymer"],"latest_commit_sha":null,"homepage":"https://app-starter-8f1a5.firebaseapp.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jifalops.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2017-02-05T15:50:19.000Z","updated_at":"2024-03-02T04:14:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"994d1439-f911-4627-956c-094fd0a63aa2","html_url":"https://github.com/jifalops/app-starter","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/jifalops/app-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jifalops%2Fapp-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jifalops%2Fapp-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jifalops%2Fapp-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jifalops%2Fapp-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jifalops","download_url":"https://codeload.github.com/jifalops/app-starter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jifalops%2Fapp-starter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259732783,"owners_count":22903089,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["firebase","geofire","polymer"],"created_at":"2024-11-18T13:33:36.461Z","updated_at":"2025-06-23T19:03:40.178Z","avatar_url":"https://github.com/jifalops.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# App Starter\nA starting point for using Polymer, Firebase, Geofire, and username/provider logins.\n\nTry it at https://app-starter-8f1a5.firebaseapp.com\n\n## Key features\n* Fully operational user-to-user messaging system that includes cloud messaging.\n* Integrated permissions system based on user roles.\n* List and Map view of \"posts\". There are two types of posts in the demo.\n* Sort posts by their distance to you or another location you specify.\n* Use Firebase with usernames instead of cryptic IDs.\n* Site-wide theming\n* Lighthouse score: 95/100\n\n## Usage\n\n### Initial setup\nThe purpose of this repo is to be used as a starting point for a new app.\nA typical way to accomplish that is\n\n1. Clone this repo into your own `my-project` directory.\n\n  ```\n  git clone https://github.com/jifalops/app-starter.git my-project\n  ```\n\n2. Setup the git remotes to be able to pull from this project and pull/push to your project.\n\n  ```\n  cd my-project\n  git remote rename origin app-starter\n  git remote set-url --push app-starter no-pushing    # Set push url to dead end\n  git remote add origin [YOUR-REPO-URL]\n  ```\n\n3. Replace some strings.\n  * Replace the necessary information inside `src/app-firebase.html` to use your own Firebase info and replace the existing messaging sender ID in `firebase-messaging-sw.js`. Also set your default deploy location in `.firebaserc`.\n  * Search the entire project and change `App Starter` to `My Project` and `app-starter` to `my-project` using your preferred editor or some other method. Also update the description of your project, which occurs in `index.html`, `bower.json`, `package.json`, `manifest.json`, and `README.md`.\n\n4. Commit and push your changes.\n\n  ```\n  git add --all\n  git commit -m 'Initial changes'\n  git push -u origin master\n  ```\n\n5. Install dependencies.\n\n    ```\n    bower install --save\n    npm install polymer-cli@next\n    ```\n\n6. Test locally, requires deploying rules first.\n\n    ```\n    firebase use dev\n    ./internal/make-rules.sh\n    firebase deploy --only database\n    polymer serve\n    ```\n\n7. Deploy when ready.\n\n    ```\n    # Optional -- setup cloud functions to handle push notifications.\n    firebase init functions\n\n    polymer build\n    firebase deploy\n    ```\n\n### Pulling in new changes\nTo update your existing project to use the newest version of app-starter,\nmerge in new changes or rebase your project on top of app-starter.\n\n```\n# If others are working from origin/master.\ngit merge app-starter master\ngit push origin master\n```\n\n```\n# Only do this if nobody else is using origin/master\ngit pull --rebase app-starter master\ngit push -f origin master\n```\n\n## Contributing\n\n1. Fork it on Github.\n2. Create your feature branch: `git checkout -b my-new-feature`\n3. Commit your changes: `git commit -am 'Add some feature'`\n4. Push to the branch: `git push origin my-new-feature`\n5. Submit a pull request\n\n## License\n\n[Apache](https://opensource.org/licenses/Apache)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjifalops%2Fapp-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjifalops%2Fapp-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjifalops%2Fapp-starter/lists"}