e6f55fb1d6
- New contribute.html with honest project story and contributor guide - Discord and Contribute links added to nav on all pages - Forgejo + Discord links in all footers - Removed sensitive data from project-notes (passwords, server paths) - Updated .gitignore to exclude keystores, APKs, AppImages, credentials Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
112 lines
6.1 KiB
HTML
112 lines
6.1 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<title>Contribute — ItsGoin</title>
|
|
<meta name="description" content="Help build ItsGoin. Open source decentralized social media that needs developers, testers, and ideas.">
|
|
<link rel="stylesheet" href="style.css">
|
|
</head>
|
|
<body>
|
|
<nav>
|
|
<a href="index.html" class="logo">ItsGoin</a>
|
|
<div class="links">
|
|
<a href="index.html">About</a>
|
|
<a href="tech.html">How It Works</a>
|
|
<a href="design.html">Design</a>
|
|
<a href="download.html">Download</a>
|
|
<a href="contribute.html" class="active">Contribute</a>
|
|
<a href="https://discord.gg/pCjMbY9PmN">Discord</a>
|
|
</div>
|
|
</nav>
|
|
|
|
<div class="container">
|
|
<section>
|
|
<h1 style="font-size: 2rem; font-weight: 800; letter-spacing: -0.03em; margin-bottom: 0.25rem;">Help build ItsGoin</h1>
|
|
<p>ItsGoin is an open source project that welcomes contributors of all kinds.</p>
|
|
</section>
|
|
|
|
<section>
|
|
<h2>The honest story</h2>
|
|
<p>ItsGoin was built by a network/tech web dev and junior programmer who's been vibe-coding well beyond his skill level with the help of AI. The architecture is ambitious — a fully decentralized social network with mesh routing, NAT traversal, envelope encryption, and a CDN tree — and it actually works.</p>
|
|
<p>But "works" and "works well" are different things. The codebase needs experienced eyes. There are rough edges, performance opportunities, and entire planned features that need real expertise to do right.</p>
|
|
<p>If you find that interesting rather than terrifying, you're exactly who we need.</p>
|
|
</section>
|
|
|
|
<section>
|
|
<h2>Where to start</h2>
|
|
<div class="card">
|
|
<h3 style="color: var(--accent);">Read the design</h3>
|
|
<p>The <a href="design.html">design document</a> is comprehensive — it covers every protocol message, every architectural decision, and what's planned next. Start here to understand what you're looking at.</p>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<h3 style="color: var(--green);">Browse the code</h3>
|
|
<p>The full source is on our self-hosted Forgejo instance. Fork it, poke around, open issues, submit pull requests.</p>
|
|
<p style="margin-top: 0.5rem;"><a href="https://git.itsgoin.net/Sologretto/itsgoin" class="btn btn-primary">git.itsgoin.net</a></p>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<h3 style="color: var(--amber);">Join the conversation</h3>
|
|
<p>The Discord is where we discuss design decisions, report bugs, coordinate work, and generally hang out. It's small right now — that means your voice matters more.</p>
|
|
<p style="margin-top: 0.5rem;"><a href="https://discord.gg/pCjMbY9PmN" class="btn btn-secondary">Join Discord</a></p>
|
|
</div>
|
|
</section>
|
|
|
|
<section>
|
|
<h2>What we need help with</h2>
|
|
|
|
<div class="card">
|
|
<h3>Rust developers</h3>
|
|
<p>The core library (<code>crates/core</code>) is ~15K lines of Rust handling networking, sync, encryption, and storage. If you know Rust and are interested in P2P systems, there's plenty to dig into — performance tuning, error handling, protocol edge cases.</p>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<h3>Frontend developers</h3>
|
|
<p>The UI is plain HTML/CSS/JS with no build step — intentionally simple. But simple doesn't mean it can't be better. The frontend talks to the Rust backend through Tauri IPC commands.</p>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<h3>Testers</h3>
|
|
<p>Download the app, use it with friends, and tell us what breaks. Real-world testing across different networks, NAT types, and devices is invaluable. Bug reports on the Forgejo issue tracker or Discord are hugely helpful.</p>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<h3>Security reviewers</h3>
|
|
<p>We're doing envelope encryption, group keys, ed25519 signatures, X25519 DH key exchange. If you have cryptography experience, we'd love a review of the implementation.</p>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<h3>Documentation & ideas</h3>
|
|
<p>Not a coder? That's fine. Help improve docs, suggest features, find UX problems, write tutorials. Every perspective helps.</p>
|
|
</div>
|
|
</section>
|
|
|
|
<section>
|
|
<h2>Tech stack</h2>
|
|
<div class="card">
|
|
<table>
|
|
<tr><th>Component</th><th>Technology</th></tr>
|
|
<tr><td>Core library</td><td>Rust (~15K lines)</td></tr>
|
|
<tr><td>P2P networking</td><td>iroh 0.96 (QUIC + mDNS)</td></tr>
|
|
<tr><td>Storage</td><td>SQLite</td></tr>
|
|
<tr><td>Encryption</td><td>ChaCha20-Poly1305 + X25519</td></tr>
|
|
<tr><td>Desktop/mobile</td><td>Tauri v2</td></tr>
|
|
<tr><td>Frontend</td><td>Plain HTML/CSS/JS (no framework, no build step)</td></tr>
|
|
<tr><td>Platforms</td><td>Android, Linux (AppImage)</td></tr>
|
|
<tr><td>Code hosting</td><td><a href="https://git.itsgoin.net/Sologretto/itsgoin">Forgejo (self-hosted)</a></td></tr>
|
|
</table>
|
|
</div>
|
|
</section>
|
|
|
|
<section>
|
|
<h2>License</h2>
|
|
<p>ItsGoin is licensed under <strong>Apache 2.0</strong>. Use it, fork it, build on it. The only requirement is that you keep the license notice.</p>
|
|
</section>
|
|
</div>
|
|
|
|
<footer>
|
|
<p>ItsGoin — Apache 2.0 License — <a href="https://itsgoin.com">itsgoin.com</a> · <a href="https://discord.gg/pCjMbY9PmN">Discord</a> · <a href="https://git.itsgoin.net/Sologretto/itsgoin">Source Code</a></p>
|
|
</footer>
|
|
</body>
|
|
</html>
|