v5.0.0-preview1 is finally here!

It's been over a year since I started working on v5. It was hard finding time to dedicate to the project but here we are, at last!

Disclaimer

Stability

This pre-release if a preview version of the v5. There is still a lot of work to do before it is ready: expect breaking changes and API instability. The goal of this pre-release is to start experimenting with the framework reborn, solve possible blocking points, smooth out the experience, fix potential bugs, etc. This is the perfect time to play with it and provide feedback, which is always greatly appreciated. I don't recommend starting building production applications with this preview version.

The current code is entirely tested but this doesn't mean every possible bug or use-case has been tested. I did my best to make the tests as complete as possible.

Here is a non-exhaustive list of topics that are going to be worked on next:

• Error handling and better support for error reporting services
• Support for io.FS for everything file-related.
• Support for embeds for config, language files, etc
• The default database engine will be changed from MySQL to PostgreSQL as it better represents the type of application that Goyave targets
• Native handlers compatiblity layer
• Websocket support
• Logging improvements and flexibility
• DTO to Model mapping
• First party libraries (such as goyave.dev/filter) support for v5

Documentation

The technical documentation is available on go.pkg.dev and only misses a few more advanced topics. However, there is currently no extra documentation like what you can find on goyave.dev for v4. I am sorry that I am not able to provide a complete documentation with in-depth concept explanation and examples as of now.

The changes are so massive that writing a changelog will take time too. An upgrade guide will be available at a later date as well. You can still check them here if you want: v4.4.11...v5.0.0-preview1

As many aspects are still subject to change, maintaining a documentation would require too much work. A complete documentation will come later when we move past the preview stage. If you want help working with it, I will answer your questions over on Discord.

Getting started

The template project has a v5 branch that you can take example on to get started.