You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+6-3Lines changed: 6 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ A modern, type-safe Kotlin client for the Notion API with comprehensive DSL supp
13
13
14
14
## Why This Client?
15
15
16
-
-**🆕 Latest API Support** - Built for Notion API version **2025-09-03** with full support for data sources, search, and all current features
16
+
-**🆕 Latest API Support** - Built for Notion API version **2025-09-03** with full support for data sources, search, and all current features (currently the only Kotlin client supporting this API version)
17
17
-**🛡️ Type-Safe DSLs** - Intuitive builder patterns for pages, databases, blocks, and queries with compile-time safety
18
18
-**⚡ Kotlin-First** - Leverages coroutines for non-blocking I/O, null-safety, and functional programming patterns
19
19
-**✅ Extensively Tested** - Validated against official Notion API sample responses with comprehensive test coverage
@@ -136,7 +136,8 @@ See [docs/databases.md](docs/databases.md) and [docs/data-sources.md](docs/data-
136
136
-**Advanced query DSL** with complex filters, sorting, and pagination
137
137
-**Rich text DSL** for formatted content with mentions, equations, and links
138
138
-**30+ block types** including tables, callouts, code blocks, and embeds
-**Property types** - Full support for the most important data source property types, with more coming up
140
+
-**Kotlin datetime types** - Native support for `kotlinx-datetime` types (`LocalDate`, `LocalDateTime`, `Instant`) with explicit timezone handling
140
141
-**File operations** - Upload and manage files/images
141
142
-**Comprehensive error handling** with detailed error types
142
143
@@ -207,10 +208,11 @@ This library covers virtually all aspects of the Notion API (2025-09-03 version)
207
208
- Review the test coverage for your specific use cases
208
209
- Test thoroughly with your Notion workspace
209
210
- Be aware that the API version support is fixed to 2025-09-03
211
+
-**Date/time properties with timezones**: While the library provides comprehensive support for `kotlinx-datetime` types with explicit timezone handling (including timezone-aware conversions via `toLocalDateTime(timeZone)`), this area may benefit from additional real-world validation, particularly around timezone edge cases and complex datetime scenarios
210
212
211
213
## Contributing
212
214
213
-
Contributions are welcome! This project is in pre-release, so now is a great time to help shape its direction.
215
+
Contributions are welcome!
214
216
215
217
**Areas where contributions are especially valued:**
216
218
- Real-world usage feedback and bug reports
@@ -228,6 +230,7 @@ This project is licensed under the MIT License.
228
230
-**Anthropic** for Claude and Claude Code
229
231
-**JetBrains** for Kotlin and the fantastic language ecosystem
230
232
- The **Kotlin community** for patterns and best practices
233
+
-**Previous Kotlin implementations** ([klibnotion](https://github.com/BoD/klibnotion) and [notion-sdk-kotlin](https://github.com/notionsdk/notion-sdk-kotlin)) for pioneering Kotlin-based Notion API clients and serving as valuable references during development
0 commit comments