PackageTrack
Sign in Get early access

fresh_dio

An http interceptor for token refresh. Fresh is built on top of package:dio and manages authentication tokens transparently.

0.6.0 16K downloads/mo #2415 most downloaded on pub.dev felangel/fresh

What this package is like to depend on

Last release 5 months ago

26 Feb 2026

Ships fairly regularly

a new release about every 7 months

Nearly every release is documented

notes for 17 of 17 stable releases

Nothing withdrawn

no release was ever pulled

6 years old

18 releases · first in 2020

5 releases in the last 12 months

see the full history below

Release timeline

18 releases · May 2020 to Feb 2026
2021 2022 2023 2024 2025 2026
Release Pre-release

Releases

latest 18
  1. 0.6.0 26 Feb 2026
    Release notes
    • BREAKING feat: adjust the default shouldRefreshBeforeRequest to automatically refresh if the token expires within 30s
    Open source →
    Release notes
    • BREAKING feat: adjust the default shouldRefreshBeforeRequest to automatically refresh if the token expires within 30s
    Open source →
  2. 0.5.1 20 Feb 2026
    Release notes

    chore: bump package versions (#137)

    Open source →
    Release notes
    • feat: single-flight token refresh - concurrent 401 responses trigger only one refreshToken call (#126, #130)
    Open source →
  3. 0.5.0 19 Feb 2026
    Release notes
    • feat: ShouldRefreshBeforeRequest allows conditional token refresh based on request details (path, headers, etc.) and token expiration
    • feat: automatic token refresh based on expiration before requests
    • feat: enhanced token validation with Token.expiresAt getter
    • feat: support for custom token validation logic with RequestOptions context
    Open source →
  4. 0.4.5 08 Jan 2026
    Release notes
    • feat: add isTokenRequired to prevent adding auth headers (#125)
    Open source →
  5. 0.4.4 19 Oct 2025
    Release notes
    • fix: hang on uncaught refresh token exception (#120)
    Open source →
  6. 0.4.3 02 Mar 2025
    Release notes
    • fix: clone FormData on retry
    • feat: support subclasses of OAuth2Token in Fresh.oAuth2
    • chore: upgrade to mocktail ^1.0.0
    Open source →
  7. 0.4.2 20 Jul 2024
    Release notes
    • feat: add assert to prevent infinite refresh loop
    • fix: tighten package:dio version constraint
    • chore: update copyright year
    • chore: add funding to pubspec.yaml
    • ci: revamp ci setup
    Open source →
  8. 0.4.1 25 Jul 2023
    Release notes
    • fix: replace Interceptor with QueuedInterceptor
    • refactor: use DioException instead of deprecated DioError
    • docs: minor updates to LICENSE and README
    • chore: adjust dart sdk constraint to ">=2.15.0 <4.0.0"
    • chore: use more strict analysis options
    • chore: various updates to example app
    Open source →
  9. 0.4.0 29 Mar 2023
    Release notes
    • feat: upgrade to dio ^0.5.0
    • feat: upgrade dart to sdk: ">=2.15.0 <3.0.0"
    Open source →
  10. 0.3.2 04 Apr 2022
    Release notes
    • feat: add httpClient parameter to Fresh.oAuth2 (#60)
    • chore: upgrade dev dependencies
      • mocktail: ^0.3.0
      • very_good_analysis: ^2.4.0
    Open source →
  11. 0.3.1 26 Apr 2021
    Release notes
    • fix: remove httpClient lock and add token header to refresh
    Open source →
  12. 0.3.0 10 Apr 2021
    Release notes
    • BREAKING: update to dio: ^4.0.0
    • fix: queue concurrent requests during refresh
    Open source →
  13. 0.3.0-nullsafety.0 11 Mar 2021 pre-release
    Release notes
    • BREAKING: update to dart 2.12 with null safety
    • BREAKING: update to fresh: ^0.4.0
    • BREAKING: update to dio: ^4.0.0-beta7
    Open source →
  14. 0.2.0 11 Aug 2020
    Release notes
    • BREAKING: update to fresh: ^0.3.0
    • fix: throw DioError on RevokeTokenException (#26)
    Open source →
  15. 0.1.3 24 Jun 2020
    Release notes
    • fix: handle null response in onResponse (#24).
    Open source →
  16. 0.1.2 08 Jun 2020
    Release notes
    • fix: add generic <T> parameter to TokenHeaderBuilder (#22).
    Open source →
  17. 0.1.1 22 May 2020
    Release notes
    • Update to fresh v0.2.1
    Open source →
  18. 0.1.0 20 May 2020
    Release notes

    Initial Release of the library (copy of package:fresh v0.2.0)

    • Includes Fresh interceptor with built-in token refresh.
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive