Creating an App

An app is the top-level container in WP-Nexus. It groups together database tables, UI components, and actions into a single logical unit.

The Create App Form

Navigate to WP-Nexus in the admin sidebar and click Create App. You will see four fields:

Name

The display name of your app. This appears in the admin sidebar, on the dashboard, and in the UI builder header. Examples: "Task Manager", "Event Calendar", "Job Board".

Slug

A unique machine-readable identifier. The slug is auto-generated from the name using these rules:

• Converted to lowercase
• Spaces replaced with underscores
• Non-alphanumeric characters (except underscores) are stripped
• Must start with a lowercase letter (if the name starts with a digit, an underscore is prepended)
• Only lowercase letters (a-z), digits (0-9), and underscores (_) are allowed

The slug cannot be changed after creation. It is used in shortcodes, REST API endpoints, and internal references.

Examples:

Name	Generated Slug
Task Manager	task_manager
My App 2.0	my_app_20
123 Numbers	_123_numbers

Description

An optional text field describing the purpose of the app. Shown on the dashboard card below the app name.

Icon

Click the icon field to open the Lucide icon picker. Browse or search the Lucide icon library to select an icon for your app. The icon appears on the dashboard card and in the admin sidebar submenu.

After Creation

Once created, the app:

1. Appears on the dashboard as a card showing the name, description, icon, and creation date.
2. Gets its own submenu under the WP-Nexus admin menu item. Clicking the submenu navigates directly into the app.
3. Is ready for building -- you can immediately add database tables, UI components, and actions.

App Navigation

Inside an app, you navigate between three sections via tabs:

• Tables -- manage database tables and their schemas
• Components -- build UI components with the visual builder
• Actions -- create and manage server-side workflows

Editing an App

Click the edit button on an app card to update the name, description, or icon. The slug remains immutable.

Deleting an App

Deleting an app removes all associated database tables, UI components, and actions. A confirmation dialog is shown before deletion. This action cannot be undone.

Exporting and Importing

Apps can be exported as JSON files for backup, distribution, or migration:

• Export -- downloads a .json file containing the complete app definition (tables, components, actions, and their configurations).
• Import -- upload a previously exported .json file to recreate the app on another site.

This makes it easy to share app templates or move apps between development, staging, and production environments.