> For the complete documentation index, see [llms.txt](https://docs.dotpassport.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dotpassport.io/resources/changelog.md).

# Changelog

All notable changes to the DotPassport SDK.

## \[0.1.1] - 2025-01-12

### Added

* Initial public release
* `DotPassportClient` for API interactions
* Widget system with `createWidget()` function
* Support for reputation, badge, profile, and category widgets
* React, Vue, Svelte, and Angular integration examples
* TypeScript support with full type definitions
* Light, dark, and auto theme support
* CSS variable theming system

### Widget Types

* **Reputation Widget**: Display overall reputation score with category breakdown
* **Badge Widget**: Show earned achievement badges
* **Profile Widget**: Display user profile information
* **Category Widget**: Show individual reputation categories

### API Methods

* `getScores(address)`: Fetch reputation scores
* `getCategoryScore(address, categoryKey)`: Fetch specific category score
* `getBadges(address)`: Fetch badges data
* `getBadge(address, badgeKey)`: Fetch specific badge
* `getProfile(address)`: Fetch user profile
* `getBadgeDefinitions()`: Fetch all badge definitions
* `getCategoryDefinitions()`: Fetch all category definitions

***

## \[Unreleased]

### Planned Features

* Server-side rendering support
* Preact adapter
* Web Component wrapper
* Batch API requests
* Offline support with IndexedDB caching

***

## Version History

| Version | Date       | Highlights             |
| ------- | ---------- | ---------------------- |
| 0.1.1   | 2025-01-12 | Initial public release |

***

## Migration Guides

### From Beta to 0.1.x

If you were using a pre-release version:

1. Update package:

   ```bash
   npm install @dotpassport/sdk@latest
   ```
2. Update imports (if changed):

   ```typescript
   // Old
   import { DotPassport } from '@dotpassport/sdk';

   // New
   import { DotPassportClient, createWidget } from '@dotpassport/sdk';
   ```
3. Update widget creation:

   ```typescript
   // Old
   const widget = new DotPassport.Widget(config);

   // New
   const widget = createWidget(config);
   ```

***

## Deprecations

No deprecations in current version.

***

## Breaking Changes

### 0.1.0 to 0.1.1

No breaking changes.

***

## Related

* [Contributing](/resources/contributing.md)
* [Support](/resources/support.md)
* [Getting Started](/getting-started/quick-start.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dotpassport.io/resources/changelog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.