Developer Experience (DX) Improvements – V1

[DevOlabode]

Description

This issue focuses on improving the overall developer experience when integrating Voult.dev. The goal is to make the SDK, documentation, and API interaction more intuitive, predictable, and production-ready.

Objectives

• Reduce friction during integration
• Improve clarity of authentication flows (especially OAuth)
• Provide better tooling and examples for faster adoption
• Standardize and future-proof API documentation

Tasks

• Add refresh token helper methods to SDK
• Add OAuth helper utilities in SDK (e.g., login redirects, callbacks)
• Provide more SDK usage examples:
  • Next.js integration
  • Express integration
• Create clear OAuth flow diagrams (visual + step-by-step)
• Improve Swagger UI design and usability
• Implement versioned API routes and docs (/v1, /v2)
• Expand and refine documentation (structure, clarity, completeness)

Notes

• Prioritize simplicity and clarity over flexibility
• Assume developers are integrating quickly under time pressure
• Keep examples copy-paste friendly
• Ensure consistency between SDK behavior and documentation
• Design docs to scale with future features (RBAC, teams, etc.)