Screens: App

Home

The home screen (ScreenHome) is the first screen you see when you open the app. You create projects, data dictionaries and template packs here, and open them by clicking their cards. From any other screen, click the NeoSQL logo at the left of the header to come back. The empty home screen of a first run and the steps to create your first project are in First run.

Where you can use itWebDesktopWithout signing inSigned inLocal projectsAccount projects

What's on the screen

No.NameDescription
1Shortcut cardsThe Create New Database Project card opens the new project window (New project). The Create Data Dictionary card and the Create New Template Pack card open a menu with the Get from Store item and the Create from scratch item (the Create from scratch item on the template pack card).
2Type tabsThe All, Project, Data Dictionary and Template Pack tabs filter the list. The data dictionary tab shows domain packs and dictionaries together.
3Sort buttonChoose Name, Created Date or Last Accessed under Sort By, and the order under Order. By default the most recently used items come first.
4View buttonsSwitch between the card view and the list view. The list view shows the name, type, status, last used date and creation date in a table.
5Project cardShows the project name, whether it has a connection and a template pack (the DB Access and Code Gen lights), the DBMS and number of connections, the number of ERDs and SQL documents, and when you last used it.
6Data dictionary cardA domain pack shows its number of domains, a dictionary its number of words.
7Template pack cardShows the number of templates and the languages they generate.

A project card can carry more marks, depending on the situation.

MarkMeaning
LocalA local project. Hover to see Stored only on this device. It appears only when you are signed in. Without signing in, every project in the list is local, so the mark is left out. Data dictionary cards follow the same rule.
A role such as OwnerYour role in an account project. Projects someone invited you to show roles such as Manager, Member or DBA.
Secret Key LockA project with zero-knowledge encryption turned on (Zero-knowledge encryption).
Workspace markA project that belongs to a workspace plan. When you have such projects, an Affiliation filter appears next to the sort button (Workspaces).
Disabled, Cleanup neededA project that was disabled or needs cleanup after a plan change. A disabled project does not open and tells you why (Manage Subscription).
  • On the desktop app without signing in, you see only the local projects and assets on this device. After you sign in, account projects and account assets appear too. Use account projects in the web app (Sign-in and project types).
  • When you are signed in and an ERD is being imported from the gallery, an Pending Imports card appears below the shortcut cards (Gallery and embedding).

Opening an item

  1. Use the type tabs (2) and the sort button (3) to bring the item you want to the top.
  2. Click the card. The card is marked while it opens, and further clicks are ignored until it does.
  3. A project opens the project screen, a data dictionary asset opens the Data dictionary manager screen, and a template pack opens the Template packs screen, with that item selected.

On the desktop app, the projects and management screens you open become work tabs in the header. Coming back to the home screen does not close them; they stay hidden and keep working (Work tabs). On the web app, going to the home screen leaves the screen you were on.

Renaming and deleting

  1. Right-click the card.
  2. To rename it, click the Rename Project item (1) and enter the new name.
  3. To delete it, click the Delete Project item (2) and confirm.

The menu items depend on the type of card and your permissions.

CardRenameBottom item
Local projectAvailableDelete Project
Account project you ownAvailableDelete Project. If it has ERDs published to the gallery, the confirmation tells you they are deleted too
Account project you were invited toGreyed out. Only the owner can rename itLeave Project
Data dictionary asset, template packOnly for assets you can editDelete Data Dictionary and Delete Template Pack for your own assets, Leave Data Dictionary and Leave Template Pack for assets you were invited to edit, and Remove favorite for template packs you added to your favorites

A project of yours that was disabled after a plan change also gets an Enable item.

  • Deleting a project deletes what NeoSQL stores for it (ERDs, SQL documents, connection settings). It does nothing to the tables and data in the real database you connected to.
  • Deleting a local project also deletes the database passwords and local AI chat history saved for it on this device.
  • When the owner deletes an account project, it is deleted from the server and its members can no longer open it. When a member leaves, only that member is removed.
  • On desktop, deleting or leaving a project that is open in a tab also closes its tab. Unsaved changes are discarded without asking.

The database project management screen

The App menuDatabase Project Management item opens a screen that lists your projects in one table (ScreenDatabase Project Management). Use it to delete several projects at once. On the desktop app you can also open it from the menu of the Open project button at the end of the work tab bar.

  1. In the app menu at the far left of the header, open the App menuDatabase Project item and click the App menuDatabase Project Management item.
  2. Select the check boxes (2) of the projects to delete.
  3. Click the Delete Selected button (1) and confirm.
  • The play button at the end of a row (3) opens that project, and the trash button deletes that one project.
  • The Create New Database Project button at the top opens the new project window.
  • This screen is not a work tab. Moving to another screen leaves it.

Things to keep in mind

  • If you delete an account project you were invited to from the database project management screen, the confirmation asks about deleting, but you only leave the project. The card menu on the home screen shows the same action as the Leave Project item.
  • A deleted local project cannot be restored, because the NeoSQL server has no copy of it.
  • If the app cannot reach the server, the Get from Store items in the shortcut card menus are greyed out. The Create from scratch items still work.
  • Signing in or out reloads the home list. After you sign out, account projects and account assets leave the list.