GitXplorerGitXplorer
s

surrealist

public
1127 stars
86 forks
58 issues

Commits

List of commits on branch main.
Verified
2d75ba36e24c11247e329eb18251c4079447f52b

Minor dark theme improvements (#647)

mmacjuul committed 3 days ago
Verified
69f2638ce2a9e784600ce829c1f84a9fa9d5ed1c

Redesign dark theme (#646)

mmacjuul committed 3 days ago
Verified
57d5fb2ed01c66ba32e50e210b0f12facc549bfb

Fix table creator incorrectly allowing saving (#643)

mmacjuul committed 11 days ago
Verified
526fac516fc5d5df5d521186e5b83ba9293bd3d4

Fix missing explorer reveal button (#641)

mmacjuul committed 11 days ago
Verified
154a4f122cccfe8a0cd69455c7dd96992a2b50f6

Fix missing environment information on desktop platforms (#642)

mmacjuul committed 12 days ago
Verified
e9b55c3f09cb3d52ca4faff13a500a97a3661a67

fix: issue #634 (#636)

IItsMateo committed 12 days ago

README

The README file for this repository.



Discord   X   Dev   LinkedIn   YouTube

Blog   Github   LinkedIn   X   YouTube   Dev   Discord   Stack Overflow

Surrealist is the ultimate way to visually manage your SurrealDB database. Effortlessly connect to any SurrealDB database and execute queries, explore your tables and records, design your preferred schema, and much more. Surrealist is designed to suit a broad range of workflows, so whether you are pushing SurrealDB to its limits, or just getting started, Surrealist is the perfect tool to use.

Surrealist Documentation

You can read our documentation for information on how to install and get started using Surrealist.

Learn SurrealDB

Using the Web App

The quickest way to jump into Surrealist is using the web app at https://surrealist.app/

The Surrealist web app provides a fully functional database management experience with support for multiple connections and an integrated sandbox environment.

While the web app provides a full database management experience, it is recommended to download and install the desktop app for the complete Surrealist experience and gain features such as one-click database serving.

Using the Desktop App

You can download the latest version of Surrealist Desktop from our Releases page. This version is the recommended way to interact with SurrealDB, as it supports additional features over the web app.

Features

Query view

Use the Query View to execute queries against your database. You can define variables in the Variables panel and use them in your queries, and browse the results in the Results panel.

Additionally, queries can be saved and organized in your Saved queries, while you can view a list of recent queries in the History drawer.

Explorer view

The Explorer View is used to browse your database and inspect individual records. When you select a table in the left panel, the table contents will be displayed in the Record Explorer. You can click on a record id to open the record inspector, in which you can edit the record contents and traverse graph relationships.

GraphQL view

The GraphQL View allows you to interact with your database using GraphQL queries. Using the integrated GraphQL editor, you can write queries and mutations, and view results directly in the interface.

Designer view

The Designer View is a powerful tool you can use to define and manage your database schemas. You can create tables & edges, modify the database schema, and visualize the database tables in a graph view.

Authentication view

Use the Authentication View to manage access to the database by creating namespace logins, database logins, or scopes.

Functions view

Create and manage your schema level functions using the Functions view. Easily write your functions using the builtin SurrealQL editor, define their input parameters, and configure access permissions.

Models view

Use the Models View to upload SurML files to the database and list out available machine learning models.

API Docs view

The API Docs help you develop against your SurrealDB database faster by providing personalized API documentation in many available languages.

Local database serving

Using the desktop app you can effortlessly start a local SurrealDB database directly from the interface, while following logging output from the console drawer.

You can choose whether the local database is stored in memory or stored on disk on the Settings screen.

Sandbox

The Sandbox provides an easy to use playground to test, experiment, and learn SurrealDB. You can use the sandbox without having to start a database up, and data will be reset after you close Surrealist. Additionally, you can use the buttons in the toolbar to manually reset the sandbox or load an official dataset.

Command Palette

For advanced usage Surrealist provides a command palette accessible using cmd/ctrl + K which allows you to easily navigate to any part of the interface and trigger any action.

And much more

Explore the full list of features in the docs.

Contributing

We welcome any issues and PRs submitted to Surrealist. Before you open an issue or PR please read our Contributor Guide.

Disclaimer

  • Surrealist aims to stay up-to-date with the latest stable release of SurrealDB. We cannot guarantee support for latest nightly builds.
  • Connections to remote servers may require a HTTPS connection. You can easily configure SSL for your server using tools like Letsencrypt and nginx.

License

Source code for Surrealist is licensed under the MIT license.

Copyright © 2024 SurrealDB Ltd