Audience: Admin
Each project has its own settings: which pages act as home / login / error screens, Auth secret and Client key for the mobile client, SMTP, Ionic theme colors, collaboration, and optional global CSS/JS.
This is different from workspace Settings (debug mode, Store URL, and admin runtime config).
Client sign-in for installed apps such as Fashion Store or Crypto One is provided by the Password Auth plugin (and related datasets) — not by a client-auth-mode dropdown on this form.
| Role | Purpose |
|---|---|
| Project lead | Branding, home page, theme |
| Admin / implementer | Auth secret, Client key, SMTP, global CSS/JS |
| Content author | Know which pages are wired as system roles |
Toolbar also offers export (project backup archive).
Projects → Add Project supports create by name or import from an archive.
📷 Project settings
Image Path:
images/project-settings.png
Alt Text:
Project edit form with General, Authentication, Email Server, and Theme sections
Caption:
Project settings accordion.
| Field | Purpose |
|---|---|
| Name | Project display name |
| Public slug | Public URL slug for the project |
| SEO site name | Site name used in SEO metadata |
| Default browser title (when a page has no SEO title) | Fallback browser title when a page has no SEO title |
| Favicon / Default OG image | Branding assets |
| AI assistant rules | Extra guidance for the AI assistant on this project (brand, voice, do/don’t) |
| Allow sample rows in the AI assistant | When on, the assistant may include a few dataset rows in prompts. Turn off for projects with sensitive data |
| Home page | Default page for the experience |
| Login page / Auth failure page / Not found page | System page roles (or use global default) |
Global defaults for those system pages are maintained under Settings → Pages. See Pages.
Controls secrets used by the Ionic client app for this project — not LokAkrt workspace editors.
| Field | Purpose |
|---|---|
| Auth secret | Signs client-app JWT tokens for this project. Tokens from one project cannot be used on another. Read-only field with Generate to rotate. |
| Client key | Stored hashed on the server. Generate to set or rotate a key (shown once until you save). Use Copy when the key is visible. Download Client App rotates the key and embeds the new value. |
Note
End-user register / forgot / reset for storefront or crypto apps is configured on the Password Auth plugin (Users dataset name, email/password fields, and related settings). Project Authentication here only holds Auth secret and Client key.
Invite LokAkrt workspace users to edit this project. Members can open the project; only the owner or an admin can manage the list.
| Control | Purpose |
|---|---|
| Colleague email address (placeholder Colleague email address) | |
| Add | Invite that workspace user as a project member |
| Member list | Shows email and role; Remove member (tooltip) when you can manage the project |
Empty state: No shared members yet. Loading: Loading members…
Expected result: Invited users can open the project in the project selector; they do not become workspace Admins unless granted under Users.
SMTP settings used when this project sends mail (with Email Templates and Jobs):
| Field | Purpose |
|---|---|
| SMTP host / Port / Connection | Server endpoint |
| Username / Password | Credentials |
| From email / From name | Envelope defaults |
Per-project Ionic color palette with live preview. Use reset / random helpers if available, then save.
Individual pages can still override theme colors in page properties.
Optional editors for project-wide CSS and JavaScript. Prefer theme and builder styles for routine branding; use these for advanced needs.
Expected result: The client experience opens that page as home.
Expected result: New tokens / client builds use the rotated values. Old client JWTs signed with a previous Auth secret stop verifying.