229 lines
11 KiB
HTML
229 lines
11 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en" data-theme="dark">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
|
|
<meta name="theme-color" content="#0c0c10">
|
|
<script>
|
|
(function () {
|
|
try {
|
|
var t = localStorage.getItem('bridgeswarm.site.theme');
|
|
if (t !== 'light' && t !== 'dark') t = 'dark';
|
|
document.documentElement.setAttribute('data-theme', t);
|
|
var meta = document.querySelector('meta[name="theme-color"]');
|
|
if (meta) meta.setAttribute('content', t === 'light' ? '#2dd4bf' : '#0c0c10');
|
|
} catch (e) {
|
|
document.documentElement.setAttribute('data-theme', 'dark');
|
|
}
|
|
})();
|
|
</script>
|
|
|
|
<title>Community & Support — BridgeSwarm</title>
|
|
<meta name="description" content="BridgeSwarm's source repository, how to contribute, where to get support, who builds and owns BridgeSwarm (HoneyPeer, LLC), and what the AGPL-3.0 license means for you.">
|
|
<meta name="author" content="HoneyPeer, LLC">
|
|
<link rel="canonical" href="https://bridgeswarm.dev/community">
|
|
|
|
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
<link href="https://fonts.googleapis.com/css2?family=Syne:wght@600;700;800&family=DM+Sans:ital,wght@0,400;0,500;0,600;0,700;1,400;1,500&family=IBM+Plex+Mono:wght@400;500;600&display=swap" rel="stylesheet">
|
|
|
|
<link rel="stylesheet" href="/src/styles/global.css">
|
|
<link rel="stylesheet" href="/src/styles/theme-light.css">
|
|
<link rel="stylesheet" href="/src/styles/docs.css">
|
|
<link rel="stylesheet" href="/src/styles/community.css">
|
|
|
|
<link rel="icon" type="image/png" sizes="16x16" href="/assets/favicons/favicon-16x16.png">
|
|
<link rel="icon" type="image/png" sizes="32x32" href="/assets/favicons/favicon-32x32.png">
|
|
<link rel="icon" type="image/png" sizes="48x48" href="/assets/favicons/favicon-48x48.png">
|
|
<link rel="shortcut icon" href="/assets/favicons/favicon.ico">
|
|
<link rel="apple-touch-icon" sizes="180x180" href="/assets/favicons/apple-touch-icon.png">
|
|
<link rel="manifest" href="/assets/favicons/site.webmanifest">
|
|
<link rel="mask-icon" href="/assets/logo/bridgeswarm-wordmark.svg" color="#2dd4bf">
|
|
<meta name="msapplication-TileImage" content="/assets/favicons/mstile-150x150.png">
|
|
<meta name="msapplication-config" content="/assets/favicons/browserconfig.xml">
|
|
|
|
<meta property="og:type" content="website">
|
|
<meta property="og:site_name" content="BridgeSwarm">
|
|
<meta property="og:title" content="Community & Support — BridgeSwarm">
|
|
<meta property="og:description" content="Source repo, contributing guide, support channels, HoneyPeer LLC, and what AGPL-3.0 means for BridgeSwarm.">
|
|
<meta property="og:url" content="https://bridgeswarm.dev/community">
|
|
<meta property="og:image" content="https://bridgeswarm.dev/assets/brand/og-image.png">
|
|
<meta name="twitter:card" content="summary_large_image">
|
|
<meta name="twitter:title" content="Community & Support — BridgeSwarm">
|
|
<meta name="twitter:description" content="Source repo, contributing guide, support channels, HoneyPeer LLC, and what AGPL-3.0 means for BridgeSwarm.">
|
|
<meta name="twitter:image" content="https://bridgeswarm.dev/assets/brand/twitter-card.png">
|
|
|
|
<script type="application/ld+json">
|
|
{
|
|
"@context": "https://schema.org",
|
|
"@graph": [
|
|
{
|
|
"@type": "Organization",
|
|
"@id": "https://bridgeswarm.dev/#organization",
|
|
"name": "HoneyPeer, LLC",
|
|
"url": "https://bridgeswarm.dev/",
|
|
"logo": "https://bridgeswarm.dev/assets/logo/bridgeswarm-icon-512.png",
|
|
"email": "[email protected]",
|
|
"sameAs": ["https://git.ssh.surf/snxraven/BridgeSwarm"]
|
|
},
|
|
{
|
|
"@type": "SoftwareApplication",
|
|
"@id": "https://bridgeswarm.dev/#software",
|
|
"name": "BridgeSwarm",
|
|
"applicationCategory": "DeveloperApplication",
|
|
"operatingSystem": "macOS, Linux, Windows",
|
|
"url": "https://bridgeswarm.dev/",
|
|
"publisher": { "@id": "https://bridgeswarm.dev/#organization" },
|
|
"offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" },
|
|
"license": "https://www.gnu.org/licenses/agpl-3.0.html",
|
|
"downloadUrl": "https://bridgeswarm.dev/download",
|
|
"softwareVersion": "1.0.0",
|
|
"description": "Brings the Hyperswarm P2P stack into desktop browsers via a Bare native messaging host."
|
|
}
|
|
]
|
|
}
|
|
</script>
|
|
</head>
|
|
<body class="page-community">
|
|
<div class="bg-mesh" aria-hidden="true"></div>
|
|
<div class="bg-grid" aria-hidden="true"></div>
|
|
|
|
<div data-nav></div>
|
|
|
|
<main id="main">
|
|
|
|
<header class="page-hero">
|
|
<div class="container">
|
|
<p class="section-label" style="justify-content:center;">Community</p>
|
|
<h1>Source, support, and who's behind BridgeSwarm</h1>
|
|
<p class="lead">BridgeSwarm is source-available under AGPL-3.0, self-hosted on Gitea, and built by a small team that also uses it daily.</p>
|
|
</div>
|
|
</header>
|
|
|
|
<section class="section section-sm" id="source" aria-labelledby="source-title">
|
|
<div class="container install-wide">
|
|
<div class="section-head reveal">
|
|
<p class="section-label">Source</p>
|
|
<h2 id="source-title">Source repository</h2>
|
|
<p class="lead">The full history, issues, and CI pipeline live on our self-hosted Gitea instance — not GitHub.</p>
|
|
</div>
|
|
<div class="card reveal">
|
|
<h3><a href="https://git.ssh.surf/snxraven/BridgeSwarm">git.ssh.surf/snxraven/BridgeSwarm</a></h3>
|
|
<p>Extension, native host, examples, branding package, and documentation — one monorepo.</p>
|
|
<pre style="margin-top:1rem;"><code>git clone https://git.ssh.surf/snxraven/BridgeSwarm.git</code></pre>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="section section-sm" id="contributing" aria-labelledby="contributing-title">
|
|
<div class="container install-wide">
|
|
<div class="section-head reveal">
|
|
<p class="section-label">Contributing</p>
|
|
<h2 id="contributing-title">Set up a dev environment</h2>
|
|
</div>
|
|
|
|
<div class="grid grid-2 reveal">
|
|
<div class="card">
|
|
<h3>Get running</h3>
|
|
<pre><code>git clone https://git.ssh.surf/snxraven/BridgeSwarm.git
|
|
cd BridgeSwarm
|
|
npm run setup
|
|
# Load unpacked: extension/</code></pre>
|
|
<p>Run <code>npm run examples</code> to serve the demo gallery at <code>127.0.0.1:4173</code>, and <code>npm run sync:examples</code> after editing anything under <code>examples/</code>.</p>
|
|
</div>
|
|
<div class="card">
|
|
<h3>Where changes tend to land</h3>
|
|
<ul class="feature-list" style="margin-top:0.75rem;">
|
|
<li><code>extension/</code> — MV3 background, content script, Control Center UI</li>
|
|
<li><code>native-host/</code> — <code>host.js</code>, <code>messenger.js</code>, capability packs</li>
|
|
<li><code>examples/</code> — source of truth for every demo</li>
|
|
<li><code>docs/</code> — architecture, API, data, capabilities, Protomux, HRPC references</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<p class="lead" style="margin-top:1.5rem;">Please open an issue before a large change — especially anything touching the native messaging protocol, extension IDs, or the install scripts, since those have hard-coded coexistence checks against other tools. Build/verification commands and CI behavior are documented in the repository <a href="https://git.ssh.surf/snxraven/BridgeSwarm/src/branch/main/README.md">README</a>.</p>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="section section-sm" id="support" aria-labelledby="support-title">
|
|
<div class="container install-wide">
|
|
<div class="section-head reveal">
|
|
<p class="section-label">Support</p>
|
|
<h2 id="support-title">Get support</h2>
|
|
</div>
|
|
|
|
<div class="docs-cards reveal">
|
|
<a class="docs-card" href="https://join.discord-linux.com">
|
|
<span class="card-tag">Live chat</span>
|
|
<h3>Discord</h3>
|
|
<p>Live help and discussion on the Discord-Linux server — the fastest way to reach a real person.</p>
|
|
</a>
|
|
<a class="docs-card" href="https://git.ssh.surf/snxraven/BridgeSwarm/issues">
|
|
<span class="card-tag">Tracker</span>
|
|
<h3>Gitea Issues</h3>
|
|
<p>Bug reports and feature requests, tracked against the actual codebase.</p>
|
|
</a>
|
|
<a class="docs-card" href="/download#troubleshooting">
|
|
<span class="card-tag">Self-serve</span>
|
|
<h3>Troubleshooting guide</h3>
|
|
<p>Common install issues — native host exits, extension ID mismatches, missing HRPC spec.</p>
|
|
</a>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="section section-sm" id="honeypeer" aria-labelledby="honeypeer-title">
|
|
<div class="container install-wide">
|
|
<div class="section-head reveal">
|
|
<p class="section-label">Publisher</p>
|
|
<h2 id="honeypeer-title">HoneyPeer, LLC</h2>
|
|
</div>
|
|
<div class="card reveal">
|
|
<p>BridgeSwarm is owned and engineered by <strong>HoneyPeer, LLC</strong>, based in DeKalb County, Georgia, USA. For legal, licensing, or press inquiries, reach us at <a href="mailto:[email protected]">[email protected]</a>.</p>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="section section-sm" id="license" aria-labelledby="license-title">
|
|
<div class="container install-wide">
|
|
<div class="section-head reveal">
|
|
<p class="section-label">License</p>
|
|
<h2 id="license-title">AGPL-3.0</h2>
|
|
</div>
|
|
<div class="callout info reveal">
|
|
<div class="callout-icon">§</div>
|
|
<div class="callout-body">
|
|
<p style="margin-bottom:0.75rem;">BridgeSwarm is released under the <a href="https://www.gnu.org/licenses/agpl-3.0.html">GNU Affero General Public License v3.0</a>. In practice, that means:</p>
|
|
<ul style="margin:0 0 0.75rem; padding-left:1.1rem; display:flex; flex-direction:column; gap:0.4rem;">
|
|
<li>You can use, study, modify, and redistribute BridgeSwarm freely.</li>
|
|
<li>If you modify BridgeSwarm <strong>and let others interact with it over a network</strong> — the AGPL's key difference from plain GPL — you must make your modified source available to those users (AGPL §13).</li>
|
|
<li>Derivative works must remain under AGPL-3.0; there's no proprietary-relicensing path for forks.</li>
|
|
<li>Branding assets ship under the same license as the rest of the project.</li>
|
|
</ul>
|
|
<p style="margin:0;">This is a summary, not legal advice — read the <a href="https://git.ssh.surf/snxraven/BridgeSwarm/src/branch/main/LICENSE">full license text</a> before shipping a modified deployment, and contact <a href="mailto:[email protected]">[email protected]</a> with licensing questions specific to your use case.</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<section class="cta-band reveal">
|
|
<div class="container">
|
|
<div class="cta-card">
|
|
<h2>Join the swarm</h2>
|
|
<p class="lead">Install it, break it, tell us on Discord — or send a patch.</p>
|
|
<div class="cta-actions">
|
|
<a class="btn btn-primary btn-lg" href="/download">Install BridgeSwarm</a>
|
|
<a class="btn btn-ghost btn-lg" href="https://join.discord-linux.com">Join Discord</a>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
</main>
|
|
|
|
<div data-footer></div>
|
|
|
|
<script type="module" src="/src/js/site.js"></script>
|
|
</body>
|
|
</html>
|