Skip to content

(WiP) Faqs + edge home pages #2448

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
yevheniia-mala wants to merge 9 commits into
base: master
Choose a base branch
from
Open

(WiP) Faqs + edge home pages #2448

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
dd438dd
TB Edge docs
yevheniia-mala Dec 3, 2025
58fbb5b
TB Edge docs
yevheniia-mala Dec 3, 2025
c4d7f32
TB Edge docs
yevheniia-mala Dec 5, 2025
47b4321
TB Edge docs
yevheniia-mala Dec 5, 2025
1c75500
TB Edge docs
yevheniia-mala Dec 8, 2025
4026050
TB Edge docs
yevheniia-mala Dec 10, 2025
0567bc4
TB Edge docs
yevheniia-mala Dec 15, 2025
0e0457f
TB Edge docs
yevheniia-mala Dec 16, 2025
c892d2b
TB Edge docs
yevheniia-mala Dec 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
760 changes: 536 additions & 224 deletions _includes/docs/edge/faq.md
View file
Open in desktop

Large diffs are not rendered by default.

329 changes: 285 additions & 44 deletions _includes/docs/edge/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,77 +1,318 @@
{% if docsPrefix == 'pe/' %}
{% assign platformName = 'ThingsBoard PE' %}
{% assign platformName = 'Edge Computing add-on' %}
{% else %}
{% assign platformName = 'ThingsBoard' %}
{% assign platformName = 'Open-source IoT edge computing' %}
{% endif %}

{% if docsPrefix != 'pe/' %}
<h3>Interested in the Professional Edition? Explore the ThingsBoard PE Edge Documentation <a style="pointer-events: all;" href="/docs/pe/edge/">Here</a>.</h3>
<br>
<div class="ce-banner" id="ceBanner">
<span>Looking for white-labeling or premium features? <a href="/docs/pe/edge/" target="_blank">Explore Edge Professional Edition documentation →</a></span>
<button class="banner-close" aria-label="Close banner">×</button>
</div>
{% endif %}

The {{platformName}} **Edge** empowers you to leverage edge computing for the distribution of data processing and analysis.
<ul class="benefits-list">
<li>Your devices operate in locations with unreliable or expensive connectivity</li>
<li>You need sub-second response times that cloud round-trips can't provide</li>
<li>Local operators need dashboards and controls without depending on internet access</li>
<li>You want to filter or aggregate data before sending it to the cloud</li>
</ul>

<p class="learn-more">
Learn how Edge handles offline operation, local alarms, and data synchronization → <a href="/docs/{{docsPrefix}}edge/getting-started-guides/what-is-edge/" target="_blank">What is ThingsBoard Edge?</a>
</p>

For instance, it allows you to perform calculations and group data from edge devices right on the {{platformName}} Edge.
By doing so, you can push only filtered and grouped data to the cloud.
This strategy effectively reduces data traffic and saves cost.
<h2>IoT Edge Computing Documentation & Guides</h2>

<div class="doc-features row mt-4">
<div class="col-12 col-sm-6 col-lg col-xxl-6 col-4xl mb-4">
<a class="feature-card" href="/docs/{{docsPrefix}}edge/getting-started-guides/what-is-edge/">
<img class="feature-logo" src="/images/feature-logo/edge-logo.svg" alt="Edge logo">
<div class="feature-title">What is {{platformName}} Edge?</div>
<div class="feature-text">
<ul>
<li>Features</li>
<li>Architecture</li>
</ul>
</div>
</a>
</div>
<div class="col-12 col-sm-6 col-lg col-xxl-6 col-4xl mb-4">
<a class="feature-card" href="/docs/{{docsPrefix}}edge/getting-started/">
<a class="feature-card" href="/docs/{{docsPrefix}}edge/getting-started/" target="_blank">
<img class="feature-logo" src="/images/feature-logo/getting-started.svg" alt="Getting started icon">
<div class="feature-title">Getting started</div>
<h3 class="feature-title">Getting started</h3>
<div class="feature-text">
Provides an overview of the edge functionality and classical "Hello World" guide.
Set up your first Edge instance and connect a device. Takes 15-30 minutes.
</div>
</a>
</div>
<div class="col-12 col-sm-6 col-lg col-xxl-6 col-4xl mb-4">
<a class="feature-card" href="/docs/user-guide/install/{{docsPrefix}}edge/installation-options/">
<a class="feature-card" href="/docs/user-guide/install/{{docsPrefix}}edge/installation-options/" target="_blank">
<img class="feature-logo" src="/images/feature-logo/install.svg" alt="Install icon">
<div class="feature-title">Installation</div>
<h3 class="feature-title">Installation</h3>
<div class="feature-text">
Learn how to install and upgrade {{platformName}} Edge.
Deploy on Docker, Ubuntu, CentOS, Windows, or Raspberry Pi.
</div>
</a>
</div>
<div class="col-12 col-sm-6 col-lg col-xxl-6 col-4xl mb-4">
<a class="feature-card" href="/docs/{{docsPrefix}}edge/faq/">
<img class="feature-logo" src="/images/feature-logo/faq.svg" alt="Question icon">
<div class="feature-title">FAQ</div>
<div class="feature-text">
Get answers to the most common questions.
</div>
</a>
</div>
<div class="w-100"></div>
<div class="col-12 col-sm-6 mb-4">
<a class="feature-card" href="/docs/{{docsPrefix}}edge/use-cases/overview/">
<a class="feature-card" href="/docs/{{docsPrefix}}edge/use-cases/overview/" target="_blank">
<img class="feature-logo" src="/images/feature-logo/tutorials.svg" alt="Tutorials icon">
<div class="feature-title">Use cases</div>
<h3 class="feature-title">Edge Use Cases</h3>
<div class="feature-text">
Overview use cases that could be achieved with {{platformName}} Edge.
Deployment scenarios, traffic reduction, and local data processing.
</div>
</a>
</div>
<div class="col-12 col-sm-6 mb-4">
<a class="feature-card" href="/docs/{{docsPrefix}}edge/api/">
<img class="feature-logo" src="/images/feature-logo/api.svg" alt="API documentationn icon">
<div class="feature-title">API</div>
<div class="col-12 col-sm-6 col-lg col-xxl-6 col-4xl mb-4">
<a class="feature-card" href="/docs/{{docsPrefix}}edge/faq/" target="_blank">
<img class="feature-logo" src="/images/feature-logo/faq.svg" alt="Question icon">
<h3 class="feature-title">FAQ</h3>
<div class="feature-text">
Learn device connectivity and server-side platform specific API.
Common questions about Edge capabilities, limitations, and configuration.
</div>
</a>
</div>
</div>

{% if docsPrefix != 'pe/' %}
<div class="commercial-banner">
<h2>Need more opportunities?</h2>
<p>Start with pre-built solution templates, connect legacy equipment via 30+ integration protocols, and white-label everything as your own product.</p>
<div class="banner-actions">
<a href="/docs/contact-us/" class="btn-primary" target="_blank">Request a Demo</a>
</div>
</div>
{% endif %}

<script>
(function() {
'use strict';

function closeBanner() {
const banner = document.getElementById('ceBanner');
if (!banner) return;

banner.style.opacity = '0';
banner.style.transition = 'opacity 0.3s ease';

setTimeout(() => {
banner.style.display = 'none';
}, 300);

try {
sessionStorage.setItem('ceBannerClosed', 'true');
} catch (e) {
console.warn('Could not save banner state:', e);
}
}

document.addEventListener('DOMContentLoaded', function() {
const banner = document.getElementById('ceBanner');
if (!banner) return;

try {
if (sessionStorage.getItem('ceBannerClosed') === 'true') {
banner.style.display = 'none';
return;
}
} catch (e) {
console.warn('Could not read banner state:', e);
}

const closeBtn = banner.querySelector('.banner-close');
if (closeBtn) {
closeBtn.addEventListener('click', closeBanner);
}
});
})();
</script>

<style>
/* Top banner */
.ce-banner {
position: relative;
top: -10px;
background: linear-gradient(135deg, #f8fbff 0%, #ffffff 100%);
border: 1px solid #e3f2fd;
border-left: 4px solid #1976D2;
border-radius: 8px;
padding: 8px 12px;
margin: 0 0 0 0;
font-size: 13px;
color: #424242;
display: flex;
align-items: center;
justify-content: space-between;
gap: 16px;
}

.ce-banner a {
color: #1976D2;
text-decoration: none;
font-weight: 500;
}

.ce-banner a:hover {
text-decoration: underline;
}

.banner-close {
background: none;
border: none;
font-size: 20px;
color: #757575;
cursor: pointer;
padding: 0;
width: 20px;
height: 20px;
display: flex;
align-items: center;
justify-content: center;
transition: color 0.2s ease;
flex-shrink: 0;
line-height: 1;
}

.banner-close:hover {
color: #1976D2;
}

.banner-close:focus {
outline: 2px solid #1976D2;
outline-offset: 2px;
}

/* Lead text */
.lead-text {
font-size: 16px;
line-height: 1.6;
color: #424242;
}

/* Benefits list */
.benefits-list {
padding: 0;
}

.benefits-list li {
position: relative;
padding-left: 24px;
margin-bottom: 8px;
font-size: 15px;
line-height: 1.5;
color: #424242;
}

/* Learn more link */
.learn-more {
font-size: 15px;
color: #424242;
margin: 0 0 20px 0;
}

.learn-more a {
{% if docsPrefix != 'pe/' %}
color: #1976D2;
{% else %}
color: #009688;
{% endif %}
text-decoration: none;
font-weight: 500;
}

.learn-more a:hover {
text-decoration: underline;
}

/* Section heading */
h2 {
font-size: 24px;
font-weight: 600;
color: #1a1a1a;
margin: 20px 0 24px 0;
}
/* Cards */

.doc-features .feature-card {
display: block;
text-decoration: none;
color: inherit;
height: 100%;
padding: 16px;
}

.doc-features .feature-title {
font-size: 18px !important;
font-weight: 400;
color: #1a1a1a;
margin: 0 0 4px 0 !important;
}

/* Commercial banner */
.commercial-banner {
background: linear-gradient(135deg, #f8fbff 0%, #ffffff 100%);
border: 1px solid #e3f2fd;
border-left: 4px solid #1976D2;
border-radius: 8px;
padding: 15px;
margin: 5px 0;
}

.commercial-banner h2 {
font-size: 24px;
font-weight: 600;
color: #1a1a1a;
margin: 0 0 12px 0;
}

.commercial-banner p {
font-size: 15px;
line-height: 1.6;
color: #424242;
margin: 0 0 20px 0;
}

.banner-actions {
display: flex;
gap: 12px;
flex-wrap: wrap;
}

.btn-secondary,
.btn-primary {
display: inline-block;
padding: 12px 24px;
font-size: 15px;
font-weight: 500;
text-decoration: none;
border-radius: 6px;
transition: all 0.2s ease;
border: none;
cursor: pointer;
}

.btn-secondary {
color: #1976D2;
background: white;
border: 1px solid #1976D2;
}

.btn-secondary:hover {
background: #e3f2fd;
}

.btn-primary {
color: white;
background: #1976D2;
border: 1px solid #1976D2;
}

.btn-primary:hover {
background: #1565C0;
box-shadow: 0 4px 12px rgba(25, 118, 210, 0.3);
}

/* Responsive */
@media (max-width: 768px) {
h1 {
font-size: 28px;
}

h2 {
font-size: 22px;
}

.commercial-banner {
padding: 24px;
}
}
</style>
Loading