{"id":23666428,"url":"https://github.com/mismith/scotdance","last_synced_at":"2025-09-01T19:32:24.674Z","repository":{"id":14842152,"uuid":"43921878","full_name":"mismith/scotdance","owner":"mismith","description":"Highland dancing event tracker","archived":false,"fork":false,"pushed_at":"2024-09-08T04:59:58.000Z","size":145560,"stargazers_count":5,"open_issues_count":9,"forks_count":0,"subscribers_count":3,"default_branch":"develop","last_synced_at":"2024-09-08T05:41:26.478Z","etag":null,"topics":["capacitorjs","firebase","vue"],"latest_commit_sha":null,"homepage":"https://scotdance.app","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mismith.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"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":"2015-10-08T23:33:21.000Z","updated_at":"2024-09-08T04:54:46.000Z","dependencies_parsed_at":"2024-09-08T05:39:34.284Z","dependency_job_id":"ff0775fb-0ccb-40e0-a718-f87c8bc6f9dc","html_url":"https://github.com/mismith/scotdance","commit_stats":null,"previous_names":[],"tags_count":60,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mismith%2Fscotdance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mismith%2Fscotdance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mismith%2Fscotdance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mismith%2Fscotdance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mismith","download_url":"https://codeload.github.com/mismith/scotdance/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231713105,"owners_count":18415190,"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":["capacitorjs","firebase","vue"],"created_at":"2024-12-29T07:30:05.377Z","updated_at":"2025-09-01T19:32:24.644Z","avatar_url":"https://github.com/mismith.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# [ScotDance.app](https://scotdance.app)\n\n\u003e Highland dancing event tracker\n\nSkip the pen and paper—attend highland dance competitions in style with this app for your mobile device.\n\nModernize your highland dancing experience by interacting with program-of-events information digitally:\n- Search through dancers by their competition number, name, age group, etc. Then mark your favourites for easy tracking.\n- Track your 'favourite' dancers to make it easy to follow you/your children/friends.\n- Use the at-a-glance schedule to check event start times, which platforms to dance at, order of dances, and more.\n- Get real-time results updates—from callbacks through to placings—and review them anytime after a competition, too.\n\n## Dev\n\nCommand | Description\n--- | ---\n`npm i` | install dependencies\n`npm run dev` | serve app with emulated data and hot reloading at https://localhost:3000\n`npm run dev:cy` | shortcut for running `dev` + `cy -- open`\n`npm test` | build app and run cypress tests locally (equivalently to how they will be run in CI)\n`npm run lint` / `npm run lint:fix` | show code formatting tips (and fix them)\n`npm run build` | build for release to production (including apps)\n`npm run report` | open bundle size visualizer (`stats.html`)\n`npm run release` | create version commit and tag in git\n`npm run deploy` | push local build to production and `main` git branch\n\n\n## Admin\n\nLinks to the admin panels needed to manage this project:\n\n* Database, Users/Auth, Hosting, SSL: [Firebase](https://console.firebase.google.com/u/0/project/firebase-scotdance/database/scotdance/data)\n* iOS app: [App Store Connect](https://appstoreconnect.apple.com/apps/1386475626/appstore/ios/version/deliverable)\n* Android app: [Google Play Console](https://play.google.com/console/u/0/developers/6715160108161692003/app/4972780107515202457/app-dashboard)\n* DNS: [Cloudflare](https://dash.cloudflare.com/f9b1ba7aa72b02f28e63a13fd4aa7184/scotdance.app)\n* Domain: [Namecheap](https://ap.www.namecheap.com/domains/domaincontrolpanel/scotdance.app)\n* Email hosting (alias): [GSuite](https://admin.google.com)\n* Email sending/templates: [Postmark](https://account.postmarkapp.com/servers/4370108/overview)\n* Live chat: [Crisp](https://app.crisp.chat/website/160e5d08-deea-4187-a21b-39762a904c26/inbox/)\n* Full-text search: [Typesense (via Render.com)](https://dashboard.render.com/)\n* Native app: [Capacitor](https://capacitorjs.com/), with image asset generation via the VSCode extension\n* Release notes: [Changelog](./CHANGELOG.md)\n\n\n## App (Capacitor)\n\n### Combined Release\n\n1. While waiting between/for any of the following steps, write release notes in `CHANGELOG.md`\n2. Adjust/increment the version in `package.json` (this will be propagated by the `sync-version` script that gets called pre-`build`)\n3. Build and Deploy to app stores:\n    1. Perform steps 1-5 of the Apple App Store instructions\n    2. Perform steps 2-8 of the Google Play Store instructions\n    3. Once iOS build package is processed, perform step 6 of the App Store instructions\n4. Finalize the release via `npm run release`, which consists of:\n    1. Commit version change and release notes using the release version as the commit message (e.g. `1.0.0`)\n    2. Tag the commit using the release version prepended with `v` (e.g. `v1.0.0`)\n5. Deploy to web via `npm run deploy`, which consists of:\n    1. Deploy to web via `firebase deploy`\n    2. Push to `main`\n6. Open the ScotDance admin panel's [versions page](https://scotdance.app/#/admin/info/versions) and update the appropriate version numbers as apps are released/approved\n\n### Apple App Store\n\n* Use Automatic Signing in Xcode, after setting up all certificates and provisioning profiles\n* To upload to App Store:\n\n    1. `npm run build`\n    2. Open project in Xcode (`npx cap open ios`)\n        - Once open, consider running the app in a simulator to ensure everything is working well\n    3. In the menu bar, select \"Product\" \u003e \"Archive\" (if you can't select it, make sure you are targeting \"Any iOS Device\")\n    4. Click \"Distribute App\"\n    5. Follow the wizard (\"Test Flight \u0026 App Store\", etc.)\n    6. In App Store Connect, create a New iOS Version, then complete/fill out all remaining steps/info in form\n        - the new build should be processed and ready to be selected shortly (~15 mins)\n\n### Google Play Store\n\n* To build a signed `.aab`, you'll need the `scotdance.keystore` file (stored in a private iCloud).\n* To upload to Google Play:\n\n    1. `npm run build`\n    2. Open project in Android Studio (`npx cap open android`)\n        - Once open, consider running the app in a simulator to ensure everything is working well\n    3. In the menu bar, select \"Build\" \u003e \"Generate Signed Bundle / APK…\"\n    4. Follow the wizard (AAB, \"release\", etc.)\n    5. Open Google Play Console\n    6. Create a new Production Release\n    7. Select/Drag in `android/app/release/app-release.aab`\n    8. Complete all remaining steps/info in form\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmismith%2Fscotdance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmismith%2Fscotdance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmismith%2Fscotdance/lists"}