logo

Grids Layout System

The Custom Component allows users to build advanced, personalized interfaces using modular elements. A key part of this system is the Grids layout, which defines how components are structured visually within a screen.
The Grids system introduces flexible row-based layouts where each element has a predefined width unit. These widths determine how many components can fit in a single row.
For instance, some components are designed to take one-third of a row, allowing three elements per row, while others span the full width, meaning only one element can be placed per row.
This approach gives you total control over the visual flow of your app, ensuring a clean, responsive layout across different devices. Whether you're designing a compact toolset or showcasing a large visual module, the Grids system adapts to your needs while maintaining a consistent design structure.

🧮 Layout & Width Logic

The layout system uses a 60-unit row model, where each cell's width defines how much of that row it consumes. This allows for flexible compositions of elements in various proportions.

📐 Width

  • Each row can hold up to 60 units total.
  • A width: 60 means the element takes the full row.
  • Smaller widths, such as 20, allow up to 3 elements per row (20 + 20 + 20 = 60).
  • You can combine widths — for example:
    • width: 20 + width: 40 = full row
    • width: 30 + width: 30 = full row
⚠️ Important: All cells in a row must share the same type (e.g., all buttons or all inputs).

🔁 Equalization & Expansion

  • The allow_expansion flag allows cells to expand proportionally and fill unused space.
  • Example:
    • If you place two cells with width: 20 each and enable allow_expansion, the remaining 20 units will be evenly distributed or filled using filler cells if needed.

🎯 Centering Elements

To center an element horizontally in a row, use filler cells:
  • For a width: 20 element:
    • Place a filler, then the cell, then another filler
    • Or place two fillers first, then the cell
  • Example:
    • filler (20) + cell (20) + filler (20) → centered in row
    • filler (40) + cell (20) → right-aligned
This approach allows for precise layout control without breaking the 60-unit constraint.

Three Elements Per Row

Click the (+) icon and drag & drop one or more elements to the row.
Image without caption

Use Empty Filler for Separation and Arrangement

To create a specific interface, you can use an empty cell (Filler) to separate between elements in a row.
Image without caption

Moving Rows and Columns

You can arrange your rows and elements in the row by holding the row itself and moving it up and down or moving the elements left and right in the row by holding the elements themselves.
Image without caption

Delete Rows and Columns

You can delete a certain element in the row or delete the row itself.
Image without caption

One Element Per Row

The row can only have one of these elements: wide cards, carousels, some types of choice elements (such as radio buttons, checkboxes, and toggle buttons), and some types of buttons and chips.
Image without caption
Image without caption

❓ FAQs

Q: How can I arrange buttons and fields in rows and columns without coding?

A: With nandbox’s Grid Layout System, you can visually design your app screens by arranging elements in rows and columns. It’s as simple as dragging elements into place—you choose how wide each item should be and control spacing with just a few clicks.
✅ No coding required. ✅ Full control over layout.

Q: How does the grid system work?

A:
  • The grid uses a 60-unit row system:
    • 60 units = full-width.
    • 30 units = half-width (2 per row).
    • 20 units = one-third width (3 per row).
  • You can mix and match elements in a row as long as their widths add up to 60.
Think of it like snapping blocks together—they’ll automatically line up and adjust.

Q: How do I arrange buttons and fields in a grid?

A:
  1. Drag & drop elements like buttons, text fields, or images into a row.
  1. Set each item’s width:
      • 20 units = three items per row.
      • 30 units = two items per row.
      • 60 units = full-width.
  1. For spacing:
      • Use allow expansion to stretch items evenly.
      • Or add filler cells to create gaps or center elements visually.

Q: How can I center or align items?

A:
  • To center a button or field:
    • Add filler cells on both sides.
    • Example: filler(20) + button(20) + filler(20) → centers the button in a row.
  • To right-align:
    • Example: filler(40) + button(20) → moves the button to the right edge.
👉
Tip: You can visually preview the alignment live in the builder.

Q: How do I handle multiple rows or delete items?

A:
  • Add multiple rows and drag elements between them to organize your screen.
  • Move rows up or down to rearrange their order.
  • To remove something:
    • Click on the item or row and hit Delete directly in the builder.