Roadmap
Roadmap
SvelteKit Auto OpenAPI is currently in v0 - experimental status. This page outlines the roadmap for reaching v1.0.0 and beyond.
Current Status: v0 (Experimental)
This library is in early development and not recommended for production use. APIs may change, and there may be undiscovered bugs. Use at your own risk.
Roadmap for Version 0
The following goals must be achieved before publishing v1.0.0:
1. Explore Edge Cases and Find Errors
- Test with complex TypeScript types
- Test with nested route structures
- Test with various SvelteKit configurations
- Identify and fix edge cases in AST parsing
- Validate schema generation accuracy
2. Optimize Vite Plugin
- Improve build performance
- Reduce memory usage during development
- Optimize virtual module generation
- Implement smarter caching strategies
- Reduce hot reload latency
3. Expand Documentation and Create Documentation Website
- Create comprehensive documentation website
- Document all configuration options
- Provide usage examples
- Create example repositories
- Add video tutorials
- Write migration guides
4. Add Proper Tests
- Unit tests for AST parsing
- Integration tests for schema generation
- End-to-end tests for validation hook
- Test coverage > 80%
- Automated testing in CI/CD
5. Publish V1
- Stable API (no breaking changes)
- Production-ready performance
- Complete documentation
- Migration guide from v0
- Official release announcement
Future Enhancements (Post-v1)
Ideas for future versions:
- OpenAPI 3.1 Support - Upgrade to the latest OpenAPI specification
- Additional Schema Libraries - Support for more StandardSchema implementations
- Custom Validation Messages - User-defined error messages
- Request/Response Transformers - Transform data before validation
- Auto-generated Client SDKs - Generate TypeScript/JavaScript clients
- GraphQL Support - Extend to GraphQL schema generation
- Enhanced Type Inference - Support for more complex TypeScript patterns
- Performance Monitoring - Built-in metrics for validation overhead
Contributing
We welcome contributions! Here's how you can help:
Report Issues
Found a bug or edge case? Open an issue with:
- A clear description of the problem
- Steps to reproduce
- Expected vs actual behavior
- Your environment (Node/Bun version, SvelteKit version, etc.)
Submit Pull Requests
Want to contribute code?
- Fork the repository
- Create a feature branch
- Make your changes with tests
- Submit a pull request
Improve Documentation
Help improve the docs:
- Fix typos or unclear explanations
- Add more examples
- Create tutorial content
- Translate documentation
Share Feedback
- Star the repo if you find it useful
- Share your use cases and experiences
- Suggest new features
- Provide feedback on the API design
Communication
- GitHub Issues - Bug reports and feature requests
- GitHub Discussions - Questions and community discussions
- Pull Requests - Code contributions
License
SvelteKit Auto OpenAPI is MIT licensed .
Acknowledgments
This project builds on top of:
- SvelteKit - The web framework
- Scalar - API documentation UI
- ts-morph - TypeScript AST manipulation
- @cfworker/json-schema - JSON Schema validation
Thank you to all contributors and the open-source community!
On this page
RoadmapCurrent Status: v0 (Experimental)Roadmap for Version 01. Explore Edge Cases and Find Errors2. Optimize Vite Plugin3. Expand Documentation and Create Documentation Website4. Add Proper Tests5. Publish V1Future Enhancements (Post-v1)ContributingReport IssuesSubmit Pull RequestsImprove DocumentationShare FeedbackCommunicationLicenseAcknowledgments