Reference Guide

Detailed explanations of every feature and function in Nutshell

Screen

The basic building block of a Nutshell app, this represents the screen that your end-user will see and interact with. Its size and shape will depend on which device and orientation you’ve chosen to optimise your app for – e.g. smartphone in portrait orientation.

Sreenshot

The device and orientation you choose can have a big impact on what you can fit on-screen

Adding a Screen

Drag and drop the Screen icon from the Essentials tool bar onto your workflow. It will automatically zoom in, so you can begin adding form controls and visual elements, such as text fields and buttons.

Sreenshot

Drag the Screen component from the Tool Bar on to the Canvas

Resizing a Screen

Longer screens can scroll vertically. If your screen isn’t big enough to fit all of your content, it can be enlarged by clicking and dragging on the lower handles. You cannot resize it smaller than its original height.

Sreenshot

Screens can be enlarged vertically by clicking and dragging on the lower handles

The dotted green line tells you roughly where the bottom of your screen might be, so that you can make informed decisions about where to place important elements.

Sreenshot

A dotted green line gives you a rough indication of where the bottom of the screen might be

However, this is only a rough estimation of where the bottom of the screen might be. Because devices are all different sizes and shapes, it’s impossible to know for sure where it will be, so Nutshell takes an informed estimate based on the most common screen-sizes for the type of device you’ve chosen to optimise your app for.

Screen Properties

When a screen is selected on the Canvas, the following settings are available in the Properties panel:

Basic Settings
Label The unique name of your screen. This is visible on your canvas (under the screen), and when referencing the screen by name from elsewhere within your app.
Display Deprecated: This is a leftover from an earlier version of Nutshell, which is no longer required. It will be removed in a future release.
Behaviour
Set as Start Screen Tells Nutshell that this should be the first screen that opens when the app is launched.
Reset form fields across entire app Only available when “Set as Start Screen” is ticked. If ticked, all form fields throughout the entire app will be reset to their default values when this screen is opened. Extremely useful for multi-part forms, which need to be cleared after use.
Set as Final Screen Deprecated: This is a leftover from an earlier version of Nutshell, which is no longer required. It will be removed in a future release.
Hide continue button Deprecated: This is a leftover from an earlier version of Nutshell, which is no longer required. It will be removed in a future release.
Styling
Background Colour The background colour of your screen.
Background Image An optional background image. Recommended sizes are provided below.

Recommended Image Sizes

For the best possible results, you should avoid using small images and enlarging them, as this can make them appear mushy or pixelated.

Sreenshot

A small image (left) will look pixelated and mushy on a retina screen

Modern mobile devices are increasing in resolution (i.e. the amount of detail they can display per square inch), so if your images aren’t big enough, they won’t look very good on-screen.

All images should be in the RGB colour space and uploaded as either high-quality JPG or PNG files at a resolution of 72dpi.

Don’t worry if you don’t know what any of this means. Ask your graphic designer, who will be able to provide you with a set of appropriate images.

For smartphones, you should aim for background images approximately 360 x 640 pixels for a standard definition screen, or 720 x 1280 pixels for high-resolution (e.g. ‘retina’) devices.

For tablets, use at least 768 x 1024 pixels for standard definition, or 1536 x 2048 pixels for high-resolution (e.g. ‘retina’) devices.

Just getting started? Try the Tutorials section for handy quick-start guides.

Prefer to watch the action? Try our series of short video tutorials.

Can't find what you're looking for?

If you can't find the answer to your problem here, please contact Nutshell's support team via our dedicated help desk.