
Tracks deliveries, packages, and parcels in Raycast. Remembers your deliveries, so you can keep watch as they make their way to you.
This extension does not use a third-party tracking service as a proxy. It directly integrates with each supported carrier, which allows you to be in charge of your privacy.
A carrier can either support online updating of the tracking over the Internet or not. You are able to specify a manual delivery date for a delivery from a carrier that does not support online updating or a carrier that's missing credentials.
In the settings, you'll need two things to access the UPS API.
Navigate to the UPS Developer Portal and walk through the getting started steps.
The name of the app can be anything and is only for you. You do not need a callback URL. Pick the option that you want to integrate UPS in your business because you are not representing other users for why you need API credentials. Make sure to add the Tracking API product. You'll need a shipper account tied to your normal UPS account; UPS will walk you through this process if you don't have one yet.
In the settings, you'll need two things to access the FedEx API.
Navigate to the FedEx Developer Portal and walk through the getting started steps.
Select the track API when creating the API project. The name of the project can be anything and is only for you. After creating the project, you'll need to subsequently create the production key and use that in this extension. Do not use the test key, or you'll get incorrect tracking information. The name of the production key name can be anything.
While the USPS does support online updating of the tracking over the Internet, they only seem to allow large enterprise companies or companies that will also be actively sending packages. Therefore, I have not been able to verify code that works, so the USPS carrier only supports setting manual delivery dates for now.
Feel free to file an issue or fork and PR through the main extension repository workflow.
If you are adding support for a new carrier, you can take inspiration from the existing carriers.
Please update the documentation here on how one signs-up for the carrier and gets any API keys. When adding a new carrier, please include a 40x40px PNG icon in the assets/ directory named [carrier-name].png (e.g., dhl.png). The icon should be the carrier's logo or favicon on a transparent background.
View the deliveries you're tracking.
Starts tracking a new delivery.
View delivery status in the menu bar.
View deliveries you've archived.
deliveryService for CRUD operations, trackingService for refresh logic, sortingService for grouping)useDeliveries and usePackages hooks for cleaner state management and reusabilitycarrierDetection.ts for automatic carrier detection from tracking number patternssrc/types/ directory for better organization and maintainabilitystrict, noImplicitAny, strictNullChecks) for improved code qualitytoSortedCmd+Shift+A for archive, Cmd+D for manual delivery toggle, and morearchived?: boolean field to track archived deliveriesarchivedAt?: Date field to record when delivery was archivednotes?: string field for user-provided delivery notesDeliveries that are not remotely tracked can now be manually marked as delivered. They will no longer be automatically marked as delivered the day after the manual delivery date. Added the ability to delete all the delivered deliveries.
Offline tracking of FedEx and UPS deliveries are now allowed. Dependencies have been updated.
Duplicate deliveries are no longer allowed to be added.
Fixed a bug for the delivery date from FedEx. People living in timezones with a negative UTC offset incorrectly saw delivery dates a day earlier for FedEx. This has been fixed. FedEx and UPS carrier parsing was improved to support additional packages per tracking number.
Tracks deliveries, packages, and parcels. Has two commands to start: one to add a new delivery and one to view all the deliveries you're tracking. Has initial support for the following carriers...