Skip to content

Repo polish: MIT license, CI, and a README that shows the product#2

Merged
Alvaro5 merged 8 commits into
mainfrom
docs/readme-and-oss-setup
Jul 20, 2026
Merged

Repo polish: MIT license, CI, and a README that shows the product#2
Alvaro5 merged 8 commits into
mainfrom
docs/readme-and-oss-setup

Conversation

@Alvaro5

@Alvaro5 Alvaro5 commented Jul 19, 2026

Copy link
Copy Markdown
Owner

Rounds out the repo's public-facing surface. No app/engine code changes; all docs, config, and assets.

What's in here

  • MIT license — the app footer and README call the project open source; this makes that true.
  • CI (.github/workflows/ci.yml) — runs lint, the 86-test Vitest suite, and the production build on every push and PR, with a status badge in the README. All green locally.
  • README rewrite — tagline, badges (CI / license / live demo), a hero image, and a screenshot gallery of the real app (elevation profile, projected-finish range, course map, nutrition plan, splits). Keeps the technical detail (Minetti engine, self-calibration, honest range) but leads with what the product does.
  • Screenshots — five captures from the live app in docs/screenshots/, optimized to ~590 KB total.
  • Community healthCONTRIBUTING.md, issue forms (bug / feature), a PR template, and FUNDING.yml.

Notes

  • The CI badge shows "no status" until this branch's workflow runs; it goes green after the first CI run.
  • Repo description, homepage, and topics have been set separately.
  • Still to do manually: upload public/og.png as the repo's social preview (Settings → General → Social preview).

Copilot AI review requested due to automatic review settings July 19, 2026 19:03
@vercel

vercel Bot commented Jul 19, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
gradepace Ready Ready Preview, Comment Jul 20, 2026 7:44pm

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR polishes the repository’s public-facing surface by adding licensing, CI, contribution/issue hygiene, and a more product-oriented README, without changing application or engine code.

Changes:

  • Adds MIT licensing and updates README to reflect the project’s positioning and features with screenshots.
  • Introduces a GitHub Actions CI workflow that runs lint, tests, and a production build on pushes/PRs to main.
  • Adds community health files: contributing guide, issue forms, PR template, and funding config.

Reviewed changes

Copilot reviewed 9 out of 14 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
README.md Rewritten README with badges, hero/screenshot gallery, clearer product narrative, and updated project/tech sections.
LICENSE Adds MIT license text for open-source distribution.
CONTRIBUTING.md Adds contribution guidelines emphasizing engine purity, reality-verified changes, and green tests.
.github/workflows/ci.yml Adds CI workflow to lint, test (Vitest), and build on push/PR to main.
.github/pull_request_template.md Adds a PR template checklist aligned with project expectations.
.github/ISSUE_TEMPLATE/feature_request.yml Adds a structured feature request form aligned with the project’s “honest prediction” philosophy.
.github/ISSUE_TEMPLATE/config.yml Enables blank issues and adds a “Try GradePace” contact link.
.github/ISSUE_TEMPLATE/bug_report.yml Adds a structured bug report form with reproducibility prompts.
.github/FUNDING.yml Adds funding configuration to enable a Sponsor button on the repository.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md
Comment on lines +106 to +107
node scripts/calibrate-scan.ts efforts/*.gpx # fit terrain factors across recorded runs
node scripts/prior-scan.ts efforts/*.gpx # course-signal vs factor analysis (negative result)
- New pure lib logistics.ts: dwell kept out of the engine (calibration models moving time; range scales moving time only, dwell added after the band)
- Stop time default 3 min/station: arrivals, finish, range, splits, nutrition legs, share image and PDF all dwell-aware
- Optional start time turns every ETA into a wall-clock time (chips, hero, table, PDF), wrapping past midnight
- Per-station cutoffs with honest warnings: rose when the plan misses a barrier, amber when only the slow end of the range does
- Shared links carry dw/st/co
@Alvaro5
Alvaro5 merged commit 5c95600 into main Jul 20, 2026
1 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants