Karrio preview 2025.5rc1

[danh91]

Karrio 2025.5rc1 (Yayra Edition)

Changes

Feat

• feat: Introduce a unified website for all karrio sites

• feat: introduce a poorman plugin system for karrio SDK

  # Enable/disable plugins via environment variables
  export UPS_ENABLED=true
  export FEDEX_ENABLED=true
  export DHL_EXPRESS_ENABLED=false
  
  # Or enable all plugins by default
  export ENABLE_ALL_PLUGINS_BY_DEFAULT=true

• feat: enrich CLI with plugins management and carriers details fetching

  # Manage plugins
  kcli plugins list
  kcli plugins show ups
  kcli plugins enable ups
  kcli plugins disable dhl_express
  
  # Get carrier details
  kcli carriers list
  kcli carriers retrieve ups
  
  # Manage carrier connections
  kcli connections list
  
  # View logs and events
  kcli logs list --limit 10
  kcli events list --type shipment_created

• feat: refactor dashboard autocomplete to work with Google API key in env var

# Address Autocomplete
NEXT_PUBLIC_ADDRESS_AUTO_COMPLETE_SERVICE=google # values: canadapost, google
NEXT_PUBLIC_ADDRESS_AUTO_COMPLETE_SERVICE_KEY=xxxxxxxxxxx
NEXT_PUBLIC_ADDRESS_AUTO_COMPLETE_SERVICE_KEY=xxxxxxxxxxx

• feat: remove deprecated carrier-specific models

• feat: introduce karrio community repository (added as a submodule of karrio)

• feat: add tracer handle to settings so that Proxy and Mappers can access tracing context from settings.
  PS: You can also access the cache handler through settings

• feat: add support for default value for optionEnum fields

• feat: add support for path when creating extension using kcli

  # Generate carrier extensions
  kcli sdk add-extension --path ./my-plugins-dir
  
  # Add features to an existing carrier
  kcli sdk add-features carrier_name "Carrier Name" --path ./plugins-dir

• feat: make kcli installable

  # Install CLI tools
  pip install kcli
  
  # Get help and see all available commands
  kcli --help

Fix

• fix: dashboard page definitions with breaking changes, async signature on client components
• fix: migrations backward compatibility issue
• fix: non-failsafe address autocomplete plugin info loading
• fix: race condition issue with carrier models loading
• fix: nextjs upgrade breaking change for dynamic page metadata
• fix: minor web section layouts

Chore

• chore: update supported Python version to >=3.11
• chore: replace deprecated extensions used in API tests
• chore: reorganize carrier extension plugins, separating actively maintained and mature integrations from community in-development ones
• chore: fix compatibility with Python 3.12 and migrate from setup.py to pyproject.toml
• chore: add changelog page and web page CI
• chore: remove headless/ui dependency in favour of shadcn-powered components
• chore: theme corrections and standardized
• chore: fix app dependencies
• chore: unify packages to React 18.x
• chore: upgrade django constance and unmigrated status update

Devx

• devx: enrich carrier integration, boilerplate generation, and examples
• devx: setup cursor rules for better and AI-driven development

Docs

• docs(WIP): document self-hosting
• docs(WIP): improve integration and development docs
• docs(WIP): introduce new carrier integration guide

Team Announcement

We're excited to announce that @shadyb has joined the Karrio team as a core maintainer! 🎉

He is a motivated new grad, excited to learn and apply his data science and AI-driven software engineering skills to help us accelerate Karrio's growth and enhance the developer experience.

Major Updates

Karrio Community Repository

We've launched the Karrio Community Repository 🚀 - a public collection of community-contributed plugins that extend Karrio's functionality. Think of it as the foundation for a "plugin marketplace" where developers can share and discover useful shipping integrations and tools.

Separated Integrations

We've reorganized our carrier extensions into:

Actively Maintained & built-in Integrations (remain in the main karrio repository and added to the default build)
Community Integrations (available via Karrio Community to be installed on custom builds)
Deprecated Extensions (no longer maintained, have been removed)

---

Thank you for being part of the Karrio community! We're excited to continue building the future of shipping together. 🚀

---

_PS: If you are curious, Yayra is the name of my newly born child, and I am dedicating this release to her... 😄 _

---

This discussion was created from the release Karrio preview 2025.5rc1.