Skip to content

Instantly share code, notes, and snippets.

@lincolnaleixo
Created September 29, 2025 09:58
Show Gist options
  • Save lincolnaleixo/a5264ba69e80f00e40b6c2f1e91c6094 to your computer and use it in GitHub Desktop.
Save lincolnaleixo/a5264ba69e80f00e40b6c2f1e91c6094 to your computer and use it in GitHub Desktop.
nice CHANGELOG.md example

Changelog

All notable changes to this project are documented here. Format follows Keep a Changelog. Versioning follows SemVer

[1.2.0] - 2025-09-26

Added

  • Team workspaces with roles Viewer, Analyst, Admin.
  • Scheduled scraping jobs with cron-style editor.
  • Bulk import of ASINs via CSV and Google Sheets.
  • CLI utility ars for headless runs in CI.
  • Audit log with filter by actor, action, and resource.

Changed

  • Notifications unified into a single Preferences page.
  • Credit usage breakdown grouped by project and job.

Fixed

  • Race condition when canceling a running job.
  • Intermittent timeout when rotating proxies mid-run.

Deprecated

  • Legacy email-only invites in favor of share links.

Removed

  • Old v1 job endpoints replaced by /api/jobs/*.

[1.1.0] - 2025-09-25

Added

  • Multi-marketplace support US, UK, DE with currency awareness.
  • Advanced filters Verified Purchase, With Media, Helpful Votes.
  • Results grid with sticky headers and inline preview drawer.
  • Stripe customer portal for self-serve invoices and receipts.
  • Email verification step with magic links.

Changed

  • Navigation restructured: Reviews, Jobs, Credits, Settings.
  • Landing dashboard shows recent jobs and credit burn rate.
  • Error messages rewritten with actionable next steps.

Fixed

  • Incorrect empty state when a product had zero reviews.
  • Button states not resetting after failed runs.
  • Duplicate nav elements on small screens.

Security

  • Session rotation on password change.
  • IP allowlist for admin access.

[1.0.0] - 2025-01-27

Added

  • Core Amazon Reviews scraping for a single ASIN.
  • CSV export and basic metrics total reviews, average rating.
  • Proxy pool with automatic retries and backoff.
  • CAPTCHA solving integration with fallback manual prompt.
  • Simple dashboard with job history and credit balance.

Technical Details

  • TypeScript and Node.js.
  • Frontend React with Vite.
  • Backend Express with tRPC.
  • Database PostgreSQL with Drizzle ORM.
  • Scraping Playwright.
  • Proxy SOCKS support.
  • Auth session-based.
  • File export CSV.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment