Nov 27th, 2024
by Julian Mills
Today marks the release of Surrealist 3.1, the latest feature-packed update for our graphical management interface Surrealist. Since the previous 3.0 release we have been hard at work on all aspects of the app to further streamline the experience of interacting with your SurrealDB database.
In this blog post I will guide you through the highlights of this release and showcase the most exciting new features. Strap in tight as this is our largest release to date!
While it was previously possible to open queries stored on your file system, it was not trivial to save modifications back to disk. In this release we have completely overhauled this behaviour to allow for loading, editing, and saving query files much like the text editors you are familiar with.
Queries opened this way are identified by a file icon, and display their file system path after their name. Changes you make to the query are automatically saved back to disk, making them as seamless to edit as any other query. In addition to opening files from your file explorer, we introduced a new Open query file
command (Ctrl/Cmd + o) to further ease the process of opening query files. Last but not least, the context menu for file system queries contains the option to reveal a file in your file explorer, making it easy to locate opened queries on your file system.
File system queries provide an exciting range of new possibilities when it comes to storing, organising, and sharing queries, and we can’t wait hear how you use them to enhance your workflow.
One of the most requested features to date has been the ability to customise keybindings, and I’m delighted to announce this functionality is now available in Surrealist 3.1.
Located in the settings screen, the new Keybindings page allows you to register keybindings to commands, includes changing and unregistering any default keybindings. You can even register keybindings to dynamic commands, such as for opening specific connections.
At the moment keybindings can only be attached to commands, however in the future this will also allow customising editor shortcuts.
In order to further streamline the user interface, we added the ability to collapse the query list and table list in the Query and Explorer views, similar to what was already possible in the Designer view. This allows you to hide distractions and reserve more space for the content that matters the most.
Using the new Search SurrealDB Documentation
command (Ctrl/Cmd + J) you can now search through the SurrealDB documentation without leaving Surrealist. This new convenient way to interact with the docs allows you to find answers faster and effortlessly expand your SurrealDB knowledge.
The settings screen has received a much needed upgrade, reorganising existing pages and introducing new ones. The most noticeable change is that the “Behavior” and “Appearance” pages have been merged into a single searchable preferences page. In addition to the aforementioned “Keybindings” page, we also introduced a new “Backup & Restore” page where you can create backups of your Surrealist configuration file, or import previously created backups. Finally, we introduced a new “About” page containing version and debug information.
In Surrealist 3.1 we also gave some love to the powerful Designer view. This release significantly improves the visualisation capabilities of the table graph, including new algorithms for laying out tables, improved relation rendering, performance enhancements for large schemas, and an overhauled settings dropdown.
All table graph settings can now also be controlled from the preferences page, and overridden individually per connection. This allows you to tailor the table graph to each individual database schema.
Additionally, the editing of fields, indexes, and events has been improved within the table designer drawer, making it easier than ever to compose your schemas visually.
For our final highlight of this release, we must mention the new inline preference editing capabilities. You can now use the search dialog to find and modify preferences without opening the settings dialog. This makes it easier than ever to customise your Surrealist experience.
We made sure to make this experience fully accessible and keyboard navigable, providing a frictionless way to update your preferences while you are writing your queries.
Ctrl/Cmd + T
to open a new query tab (Desktop only)Ctrl/Cmd + W
to close the current query tab (Desktop only)Ctrl/Cmd + N
to create a new table (Desktop only)Ctrl/Cmd + E