Under Construction Lite - User Manual
Purpose
Under Construction Lite is a reusable OutSystems Reactive Web component for displaying polished placeholders for pages, features, or sections that are still under development, coming soon, or temporarily unavailable.
Component Details
Module: UnderConstructionLite
Public Block: UnderConstruction
Database Required: No
Supported Modes: FullPage, Card, Inline
Supported Themes: Construction, Info, Minimal, Dark
How to Add the Component
1. Add the dependency
- Open the consuming application in Service Studio.
- Open Manage Dependencies.
- Select the UnderConstructionLite module.
- Add the UnderConstruction public block.
- Apply the dependency changes.
2. Place the block
- Use FullPage mode for an unfinished screen.
- Use Card mode for an unfinished module or section.
- Use Inline mode for a small unavailable feature.
3. Configure the inputs
Recommended FullPage configuration:
Title = "Feature Under Development"
Message = "This feature is currently being built and will be available soon."
DisplayMode = "FullPage"
Theme = "Construction"
ExpectedDate = NullDate()
ActionText = "Return to Dashboard"
ActionUrl = "/Dashboard"
EnableAnimation = True
Input Reference
Title: Text
Main heading. Hidden automatically when blank.
Message: Text
Supporting explanation. Hidden automatically when blank.
DisplayMode: Text
Supported values: FullPage, Card, Inline.
Theme: Text
Supported values: Construction, Info, Minimal, Dark.
ExpectedDate: Date
Optional availability date. Hidden when the value is NullDate().
ActionText: Text
Text displayed on the optional navigation link.
ActionUrl: Text
Destination of the optional navigation link. The link appears only when both ActionText and ActionUrl contain values.
EnableAnimation: Boolean
Enables or disables the subtle construction visual animation.
Display Mode Guidance
FullPage:
Use for an entire unfinished screen or page. The component displays a large centered placeholder.
Card:
Use inside an existing page for an unfinished section, dashboard, or module.
Inline:
Use for a small feature that is not yet available. The compact layout shows the visual and title only.
Theme Guidance
Construction:
Yellow and orange theme for development or work-in-progress placeholders.
Info:
Blue theme for planned features and general coming-soon messages.
Minimal:
Neutral white and grey theme for a subtle placeholder.
Dark:
Dark theme for dark applications or stronger visual focus.
Common Usage Examples
Unfinished Screen:
Title = "Reports Dashboard"
Message = "The new reporting experience is currently under development."
Upcoming Section:
Title = "Export Feature"
Message = "Export capabilities will be available in a future release."
DisplayMode = "Card"
Theme = "Info"
ExpectedDate = the planned release date
ActionText = ""
ActionUrl = ""
Small Coming-Soon Feature:
Title = "Export Feature Coming Soon"
Message = ""
DisplayMode = "Inline"
Theme = "Minimal"
EnableAnimation = False
Automatic Visibility
- Blank Title hides the title.
- Blank Message hides the message.
- Null ExpectedDate hides the expected availability text.
- Blank ActionText or ActionUrl hides the action link.
Testing Checklist
- FullPage mode displays correctly.
- Card mode displays correctly.
- Inline mode displays correctly.
- Construction, Info, Minimal, and Dark themes work.
- Blank title and message are hidden.
- Expected date appears only when provided.
- Action link appears only when ActionText and ActionUrl are provided.
- Action link opens the correct destination.
- Animation starts when EnableAnimation is True.
- Animation stops when EnableAnimation is False.
- Mobile layout remains readable and responsive.
Best Practices
- Use FullPage mode for unfinished screens.
- Use Card mode for incomplete page sections.
- Use Inline mode for individual unavailable features.
- Keep the title and message concise.
- Show an expected date only when the date is reasonably confirmed.
- Provide a return or alternative action when users could otherwise become stuck.
- Do not use this component for authorization failures; use a proper access-denied message instead.
Forge Short Description
Under Construction Lite is a reusable OutSystems component for displaying polished under-development, coming-soon, or temporarily unavailable placeholders in FullPage, Card, or Inline modes.
Version 1.0.0
- Added UnderConstruction public block.
- Added FullPage, Card, and Inline modes.
- Added Construction, Info, Minimal, and Dark themes.
- Added optional expected availability date.
- Added optional action link.
- Added CSS-based animation.
- Added responsive styling and demo-screen support.