> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nuwacom.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Apps
## **Overview**
The **Interactive App Builder** enables the creation of fully functional apps, dashboards, and internal tools directly through conversational input. The system generates real, working apps within the workspace based on plain-text descriptions, allowing for iterative, chat-based refinement. The system supports the integration of custom styling and brand assets from the start of the creation process.
## **Key Benefits**
* **No technical skills required**: Apps are generated directly from text descriptions.
* **Data integration**: Apps connect to workspace data and business tools such as CRM, calendar, Slack, or email.
* **Built-in AI capabilities**: The system supports text generation, summarization, structured data extraction, and image analysis.
* **Interactive preview**: Generated apps run immediately in an interactive preview environment.
* **Iterative refinement**: Modifications are applied directly to the existing app without rebuilding it from scratch.
* **Secure execution**: Apps run in isolated sandboxes with controlled data access.
## **When to Use**
* **Dynamic or interactive outputs**: Best suited for dashboards, exploratory views, walkthroughs, and lightweight tools.
* **Self-contained workspace tools**: Ideal for tools that live in the workspace and are shared with team members.
* **Data and AI integration**: Best for combining workspace data with AI capabilities in a tailored interface.
* **Custom-branded experiences**: Ideal when apps require specific brand styling, logos, or visual assets.
## **What Can Be Built**
| Category | Examples |
| ----------------------------- | --------------------------------------------------------- |
| **Dashboards & reports** | KPI overviews, revenue/signups/conversion, order tracking |
| **Tools & calculators** | Configurators, pricing calculators, internal helpers |
| **Forms & intake** | Support intake, settings panels, filters, file uploads |
| **Boards & maps** | Strategy, process, customer, or journey views |
| **Infographics & explainers** | Architecture/system overviews, landing-style pages |
| **Charts** | Focused single-dataset visualizations |
| **Knowledge explorers** | Searchable interfaces over your knowledge base |
## **Branding and Styling**
The system allows the integration of custom design standards and visual assets during the creation process. This supports several key use cases:
* **Landing pages**: Creating custom pages with tailored visuals and consistent brand styling.
* **Campaign pages**: Generating pages from a design brief with product screenshots and approved images.
* **Sales tools**: Developing proposal configurators and company-branded microsites.
* **Interactive dashboards**: Turning presentations, concept documents, or image sets into interactive dashboards.
* **Internal tools**: Creating tools with correct logos, illustrations, and visual style from the start.
* **Event and launch pages**: Building event pages, product launch pages, or executive demos with a strong design standard.
## **How It Works**
* **Step 1: Describe** Enter a description of the app, such as "Build a dashboard with our project numbers". Styling instructions or brand assets can be provided directly in the chat, or a Design Skill can be attached.
* **Step 2: Watch** The system generates the app and displays it live in the preview panel.
* **Step 3: Refine** Adjust the content, layout, colors, and features through conversational instructions. Post-build refinement of styling and layout is fully supported.
## **The App Workspace**
| **View** | **What it shows** |
| ---------------- | ----------------------------------------------------------------- |
| **Preview** | The live, interactive app: click through it like a real app |
| **Code** | The generated source files in a read-only editor with a file tree |
| **Sources** | Files and content connected to the app as data |
| **Integrations** | Actions from connected business tools (e.g. Outlook, Slack) |
### **Preview**
The app runs live and is fully interactive (forms, buttons, navigation). Internal links navigate within the app; external links open in a new browser tab. The app can be expanded to fullscreen. The preview refreshes automatically when data sources or versions change.
### **Code**
A read-only view of the app's source, with a browsable file tree and syntax highlighting. From here, you can perform the following actions:
* **Copy** Copy a file's contents directly to the clipboard.
* **Download file** Download a single file from the codebase.
* **Download codebase** Download the entire codebase as a ZIP archive.
* **Reference in chat** Reference a specific file in chat to guide the AI when requesting targeted changes.
## **Connecting Your Data**
Apps can be connected to live data, managed visually in the canvas:
* **Sources**: Attach files or content from the knowledge base as runtime data. An optional "smart apply" step allows describing how the data should be used.
* **Integrations**: Connect specific actions from business tools (CRM, calendar, email, chat). Actions are configured, parameters set, and connections tested before saving.
Credentials are never entered directly within an app. The platform securely brokers all access. **In shared apps, each user connects and uses their own accounts; connections are never shared between users.**
## **AI Capabilities**
Apps can utilize AI directly, including:
* **Text generation & summarization**
* **Structured data extraction**
* **Image generation, editing, and analysis (vision)**
## **Live and External Data**
Apps can pull in current web information (weather, news, prices, look-ups) through the platform's built-in web search. All external data is routed securely through nuwacom; apps cannot call arbitrary external services directly.
## **Usage Limits (Fair Use)**
To maintain platform stability and performance, each app is subject to built-in fair-use request limits. These limits prevent individual apps from overloading the system (for example, due to infinite loops) and are identical across all subscription plans and trials.
* **Short-burst limit** — Apps can send a rapid burst of up to **20 requests** simultaneously, after which they continue at a steady rate of approximately **10 requests per second**. This is sufficient for standard navigation but may be briefly exceeded by data-heavy screens (e.g., a dashboard loading dozens of metrics at once), resulting in a temporary "rate limit exceeded" message.
* **AI limit** — AI-driven actions (such as text generation, summarization, or image analysis) are capped at **30 requests per minute** to prevent runaway loops and unexpected costs.
| Limit | Value |
| --------------------------- | ---------------------------- |
| Short burst | up to 20 requests at once |
| Steady rate after the burst | about 10 requests per second |
| AI actions | 30 per minute |
## **Handling Rate Limit Messages**
* **Reload the app** The limit clears within a second or two, so a reload usually resolves the issue.
* **Reduce initial load** If the message persists, the app may be loading too much data at once. Instruct the AI in chat to load data in smaller steps, show fewer items initially, or load details only upon clicking.
## **Iterating and Editing**
Editing is conversational. The AI makes precise, targeted edits rather than rebuilding the entire app. Users can choose between two build quality tiers:
* **Standard** Faster and more cost-efficient.
* **High** Higher quality for complex work.
## **Versions and History**
Every change accumulates as a version snapshot. From the canvas, you can manage versions using these features:
* **Open version history** Access the version history navigator from the canvas.
* **Navigate versions** Step back and forward through previous version snapshots.
* **Restore versions** Restore an earlier version as the active, live app.
Historical versions are read-only snapshots; live data connections are inactive during preview.
## **Saved State**
Apps can remember lightweight UI state (such as a selected tab, a draft, or a preference) so it survives a reload. This is per-app convenience state, not a shared database, and it does not sync across devices.
## **Sharing and Permissions**
The app and the chat are shared separately, each via its own Share button. Sharing one does not share the other.
Apps are shared from the Share dialog, where you can perform these actions:
* **Add individual users or groups** Grant access to specific team members or departments.
* **Grant Read or Edit access** Configure permissions (new users default to Read access).
* **Share with all workspace users** Make the app accessible to the entire workspace (subject to role permissions).
* **Copy a link** Generate a 7-day invite link for logged-in workspace members.
Sharing an app shares the finished app, not the building conversation. If the chat is shared, recipients can read the full message history in a read-only format.
### **Privacy Warning for Connected Accounts**
Shared apps never share credentials or connections. When an app uses private connected accounts, each recipient uses their **own** connected account.
The first time a viewer opens a shared app requiring an unlinked connection, a prompt appears to connect an account. If they do not connect, the affected part of the app remains unresolved.
### **Who Can Build vs. View**
| **Capability** | **Editor** | **Read-only viewer** |
| ---------------------------------------------- | ---------- | -------------------- |
| Run the app (Preview) | Yes | Yes |
| Preview / Code / Sources / Integrations toggle | Yes | Preview only |
| Edit via AI chat | Yes | No |
| Add/remove data sources and integrations | Yes | Preview only |
| Download codebase | Yes | No |
| Share | Yes | Hidden |
| Delete | Yes | Hidden |
## **Accessing and Running Apps**
* **Apps list** Find, search, open, rename, share, move, and delete apps from the Apps area in the sidebar.
* **Dedicated app page** Each app has its own full-page view combining the live app and an editing chat sidebar.
* **In chat** Apps appear as preview tiles; click to open the full canvas.
Apps run inside nuwacom in a secure, sandboxed environment via a short-lived authenticated session. Access always requires a logged-in workspace member.
## **Export and Download**
* **Download codebase** ZIP of all source files, available from the Code view.
* **Download as PDF** Available from the app's "more" menu.
## **Security and Sandboxing**
Apps are built to be safe even though they run real, interactive code:
* **Isolated execution** Each app runs in a sandboxed frame on its own isolated address, separated from the main platform and other apps.
* **No uncontrolled data egress** Apps cannot make direct calls to arbitrary external services, and other data-leak channels are locked down.
* **Controlled, secure data access** Apps access workspace data, AI, and connected tools only through a controlled platform bridge.
* **No credential exposure** Apps never see authentication tokens or credentials; the platform brokers every connection.
* **Per-user connected accounts** Shared apps use each viewer's own connections.
## **Good to Know / Current Limitations**
* **No element-level visual editing** Changes are made through chat rather than drag-and-drop or click-to-style controls.
* **No manual preview reload button** The preview refreshes automatically when changes are applied.
* **No public or anonymous URLs** Access always requires a logged-in workspace member.
* **Title rename location** Renaming is performed from the Apps list, not the canvas header.
* **Automatic version snapshots** Snapshots are created automatically from edits; there is no manual save button.
* **Client-side execution** Apps run client-side only and cannot call external services directly.
* **Fair-use request limits** Apps are subject to built-in request limits to maintain platform stability.
## **Example Prompts**
* Create a KPI dashboard with revenue, new customers, and conversion.
* Build a support intake form with file upload.
* Show our projects as a board grouped by status.
* Make an infographic of our system architecture.
* Add a dark-mode toggle in the header.
## **FAQ**
It depends on **what** you share, because the app and the chat are shared separately:
* **If you share the app** (Share button on the app): recipients get only the finished, running app. They do **not** see the chat you used to build it, and read-only viewers can't open the editing chat at all.
* **If you share the chat** (Share button on the conversation): recipients can open the conversation and read the **full message history**. It is read-only for them (they can't send messages), but they do see what was written. Only share the chat when you actually want to show how the app was built.
Yes. Editing continues through chat, and people with access see the updated app.
No. For security, apps cannot make direct external calls. Live or external data is provided through the platform (built-in web search) or through connected integrations.
No. The platform securely brokers all data and tool access; apps never handle credentials.
No. Read-only users can run and interact with the app, but editing, data-source changes, downloading the code, sharing, and deleting are restricted to editors.
Each person uses their own. When an app relies on an integration, recipients are prompted to connect or select their own account.
It is a built-in fair-use limit on the number of requests an app can send in a short burst. It usually appears when a data-heavy app loads a lot of data at once. Reloading the app or instructing the AI to load data in smaller steps resolves the issue.