Skip to content

Commit 93be221

Browse files
authored
Merge pull request #300 from IgniteUI/suggest-overview-topic-update
New Master-detail topic and Overview topic update
2 parents 38c8c56 + eaaf1eb commit 93be221

File tree

4 files changed

+117
-32
lines changed

4 files changed

+117
-32
lines changed

en/app-builder-overview.md

Lines changed: 50 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -6,41 +6,60 @@ _keywords: App builder, Indigo Design, Infragistics
66

77
# App Builder - Overview
88

9-
App Builder is a design to code solution, enabling design and development teams to quickly and easily design and build real web applications, using professionally-built components to generate production-ready code for Angular, Blazor, Web Components and React.
10-
11-
Through the [App Builder]({environment:appbuilderBaseUrl}/platform) you are able to build pixel-perfect apps incredibly fast, saving huge amounts of design time and getting apps looking exactly like your design. That is a new generation design tool, where designers use the design system approach and a component library, everything designed is running live, dev ready, with high-quality app code. Speaking of production ready code, everything you design results in production ready Angular repository with all it's components, styles, build setup, etc. So, you do the design and check the instant real-time preview, we'll do the code. Since the App Builder is 100% web based, there is no need to download anything, not heavy IDE's, and no 3rd party dependencies. Everything is on the web, accessible by your whole team on any platform.
12-
13-
Starting your app building experience is fast and easy with one of our pre-built app templates or use one of our preset layout options to build your app in no time. Just tweak our app design, swap a theme and your done! Use pre-configured themes and typography, or customize them to match your own app theme and corporate branding on a per-control, per-screen or per-app basis. Start you new app in the App Builder, build it faster than ever, iterate with new features and get the production-ready code!
14-
15-
## Prerequisites
16-
17-
1. Install NodeJS.
18-
2. Install Visual Studio Code.
19-
20-
<div>
21-
<div style="display:inline-block;width:45%;text-align:center;">
22-
<img src="./images/general/nodejs.svg"
23-
style="display:flex;max-height:100px;margin:auto auto 20px auto;" />
24-
<a target="_blank" href="https://nodejs.org/en/download/" class="no-external-icon"
25-
style="color:white;background-color:#09f;text-decoration:none;font-weight:700;font-size:16px;padding: 5px 15px 5px 15px;">
26-
DOWNLOAD NODE
27-
</a>
28-
</div>
29-
<div style="display:inline-block;width:45%;text-align:center;">
30-
<img src="./images/general/vs-code.svg"
31-
style="display:flex;max-height:100px;margin:auto auto 20px auto;" />
32-
<a target="_blank" href="https://code.visualstudio.com/download" class="no-external-icon"
33-
style="color:white;background-color:#09f;text-decoration:none;font-weight:700;font-size:16px;padding: 5px 15px 5px 15px;">
34-
DOWNLOAD VS CODE
35-
</a>
36-
</div>
37-
</div>
38-
<div class="divider--half"></div>
9+
10+
App Builder is a web-based [design-to-code platform]({environment:appbuilderBaseUrl}/platform) that empowers design and development teams to rapidly build real, production-ready web applications using professionally built components for Angular, Blazor, React, and Web Components. With built-in support for design systems, pixel-perfect layouts, and instant real-time previews, teams can skip redundant handoffs and generate high-quality, dev-ready code directly from their designs - no installations, heavy IDEs, or third-party dependencies needed.
11+
12+
You can kick off your app with pre-built templates or layout presets, then quickly customize the design, theme, and branding to fit your needs. Whether you're designing screens from scratch or modifying existing templates, App Builder streamlines the process—helping you go from concept to live code in minutes, ready to deploy or extend in your favorite development environment.
3913

4014
> [!NOTE]
4115
> Supported browsers are Chrome, Edge (Chromium), Firefox, Safari MacOS and Mobile Safari. IE11 is not supported.
4216
17+
## The App Builder Lifecycle at a Glance
18+
19+
| **Stage** | **What Happens** |
20+
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
21+
| **1. Design Foundation** | Start from a Design System (e.g., Indigo.Design). Use Figma UI Kits and Adapters to bridge design to dev. |
22+
| **2. Visual App Building** | Drag-and-drop components in App Builder. Create layouts, bind REST APIs, use Reveal dashboards, or plug in Slingshot Tasks. |
23+
| **3. Unified Common App Model** | All inputs (designs, logic, data bindings) are transformed into a central Common App Model. |
24+
| **4. Framework-Specific Code Generation** | The model powers Codegen for Angular, React, Web Components, and Blazor. |
25+
| **5. One-Click Deployment** | Export the code to GitHub or deploy it instantly to Azure. |
26+
27+
## Why It Matters?
28+
29+
- **Design-to-Code Continuity**: No more manual translation from Figma to dev. Maintain design fidelity and reduce rework.
30+
- **Low-Code Speed, Full-Code Control**: Get production-quality code you can extend, audit, or fully own.
31+
- **Reusable Architecture**: Build once with a Common App Model and generate for multiple frameworks.
32+
- **Enterprise-Ready**: Connect to real data, integrate dashboards, and manage workflows with extensibility in mind.
33+
34+
## Who Should Use It?
35+
- Developers looking to speed up prototyping or production development.
36+
- Designers who want to hand off production-ready UI definitions.
37+
- Team Leads & CTOs needing scalable, consistent frontend architectures.
38+
- Cross-functional teams building internal tools, dashboards, or customer-facing apps.
39+
## Key Benefits and Impact
40+
41+
| Benefit | Impact |
42+
| ----------------------------------- | ----------------------------------------------------------------------- |
43+
| Unified workflow from Figma to Code | Save 30–50% dev time on frontends |
44+
| One Common App Model | Maintain consistency across teams & tools |
45+
| Live integrations & data support | Deliver real-world, functional apps |
46+
| Flexible output formats | Future-proof your stack with Angular, React, Web Components, and Blazor |
47+
| One-click deployment options | Reduce DevOps complexity & time-to-market |
48+
49+
## Use Cases
50+
51+
- Internal dashboards & admin tools
52+
- Client portals with dynamic data
53+
- MVPs & prototypes with real functionality
54+
- Design system-driven applications
55+
56+
## Try It Yourself
57+
Start from a [Figma file](ui-kits/figma.md), connect to your REST API, and [generate a fully working](https://my.appbuilder.dev/) Angular or React app in less than 10 minutes.
58+
4359
## Additional Resources
4460
<div class="divider--half"></div>
4561

46-
* [Getting Started](getting-started.md)
62+
* [Getting Started](getting-started.md)
63+
* [App Builder Interface Overview](interface-overview.md)
64+
* [Design to Code Story](design-to-code-story.md)
65+
* [App Builder SDK](sdk/sdk.md)

en/change-log.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,14 @@ _keywords: App Builder, Web App Builder, Design Systems, Design Systems UX, UI k
66
# App Builder - Change Log
77

88
> [!NOTE]
9-
> Latest update was made on 27th of May, 2025. [LEARN MORE in the AppBuilder blog](https://www.appbuilder.dev/blog)
9+
> Latest update was made on 25th of June, 2025. [LEARN MORE in the AppBuilder blog](https://www.appbuilder.dev/blog)
10+
11+
## June 2025 Release
12+
### Features
13+
- Added **Spanish language support**.
14+
- Introduced additional variants for **Icon button** — contained, outlined, and flat.
15+
- Enabled **Conditional Actions** for Data Actions, allowing forms and grids to perform different logic based on action outcomes.
16+
- Introduced **Grid Master-Detail** Template.
1017

1118
## May 2025 Release
1219
### Features

en/sidebar-toc/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,8 @@
5151
href: ../using-data-in-your-app/grid-remote-paging.md
5252
- name: Grid CRUD
5353
href: ../using-data-in-your-app/crud-operations.md
54+
- name: Master-Detail Template
55+
href: ../toolbox/grid/master-detail-template.md
5456
- name: Form Builder
5557
href: ../using-data-in-your-app/form-builder.md
5658
- name: Query Builder
Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Master-Detail Template in the Grid
2+
3+
## What Is Master-Detail Template?
4+
5+
Master-detail template allow you to enrich your data grids by expanding rows to display additional information about a record. This feature helps you build interactive views where users can click to reveal related summaries, or any other components tied to that specific row context data.
6+
7+
For example, you can show an **employee's performance info**, a **vehicle's trip history**, or a **customer’s recent orders** directly within the row, making your applications more informative and engaging.
8+
9+
## What Can You Do with It?
10+
11+
With **App Builder’s Master-Detail template support**, you can:
12+
13+
* Use **expandable rows** that reveal additional row data.
14+
* Leverage Component binding support - Add **cards, text blocks or other components** that can use row-specific data.
15+
16+
## How It Works in App Builder
17+
18+
* App Builder offers a **design-time experience** for inserting components inside the row detail area.
19+
* Components inside this area can be bound to:
20+
* The current **row’s data context**.
21+
* You can easily preview how these template will appear directly inside the App Builder Canvas and App Preview.
22+
23+
## Try It Out
24+
25+
To start using Master-Detail template:
26+
27+
1. Add a **Grid** to your canvas.
28+
2. Under the Grid Properties Panel -> Custom template, click on **Grid-details** switch.
29+
3. Drag and drop components you would want to use, inside the details area.
30+
4. Bind them to fields from the grid row context.
31+
5. Preview your app and export your code to extend the functionality even further.
32+
33+
## Known Limitations
34+
### Contextual binding, Row ID Parameters Not Supported
35+
36+
When using a component within a Master-Detail template, **contextual binding using the current row’s ID as a parameter is not supported**. If the component’s data source requires parameters, these must not be bound to the master-detail (row) context. Instead, use manual values or predefined variables. This restriction helps avoid unsupported code generation scenarios involving per-row parameter binding.
37+
38+
> [!NOTE]
39+
> This limitation applies only to data source parameters and iterated element data bindings. Other parameter picker components—such as those in the Set Data action sections for component interactions—are not affected and remain fully supported.
40+
41+
This restriction helps avoid:
42+
- Ambiguity around dynamic subscriptions.
43+
- Performance bottlenecks due to lack of caching.
44+
45+
### Iterating over data collection from the contextual binding is not implemented in CodeGen
46+
47+
Iterating over data collection from the contextual binding is not implemented in CodeGen. Such scenario fails to codegenerate.
48+
49+
### Overlay Components (e.g., Dialog, Banner)
50+
51+
Overlay elements like **Dialogs** or **Banners**, placed inside master-detail template, currently do not work correctly when code generated .
52+
53+
While these components may appear functional in the App Builder preview, they **do not retain the row data context** in the generated application. For example, a dialog meant to show details like `EmployeeId` will not have access to that value at local runtime.
54+
55+
## Resources
56+
57+
* [Fleet Management Sample (GitHub)](https://www.infragistics.com/products/ignite-ui-angular/grid-samples)

0 commit comments

Comments
 (0)