Sologretto/itsgoin
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Website: contribute page, Discord/Forgejo links, nav update, security cleanup

Browse source 
- 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>
This commit is contained in:
Scott Reimers 2026-03-15 21:16:25 -04:00
parent 800388cda4
commit e6f55fb1d6
5 changed files with 161 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

112
website/contribute.html Normal file
View file

@ -0,0 +1,112 @@
<!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 &mdash; a fully decentralized social network with mesh routing, NAT traversal, envelope encryption, and a CDN tree &mdash; 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 &mdash; 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 &mdash; 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 &mdash; 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 &mdash; 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 &amp; 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 &mdash; Apache 2.0 License &mdash; <a href="https://itsgoin.com">itsgoin.com</a> &middot; <a href="https://discord.gg/pCjMbY9PmN">Discord</a> &middot; <a href="https://git.itsgoin.net/Sologretto/itsgoin">Source Code</a></p>
</footer>
</body>
</html>

15
website/design.html
View file

@ -31,6 +31,8 @@
<a href="tech.html">How It Works</a> <a href="tech.html">How It Works</a>
<a href="design.html" class="active">Design</a> <a href="design.html" class="active">Design</a>
<a href="download.html">Download</a> <a href="download.html">Download</a>
<a href="contribute.html">Contribute</a>
<a href="https://discord.gg/pCjMbY9PmN">Discord</a>
</div> </div>
</nav> </nav>
@ -1570,8 +1572,19 @@ frontend/
</section> </section>
</div> </div>
<div class="container">
<section>
<h2>Contribute</h2>
<p>ItsGoin is open source and built in public. This project was started by a network/tech web dev vibe-coding beyond his skill level with AI assistance. The design is ambitious and the implementation is real &mdash; but more hands make lighter work. If any of this interests you, jump in.</p>
<p style="margin-top: 0.75rem;">
<a href="https://git.itsgoin.net/Sologretto/itsgoin" class="btn btn-primary" style="margin-right: 0.5rem;">Source code on Forgejo</a>
<a href="https://discord.gg/pCjMbY9PmN" class="btn btn-secondary">Join the Discord</a>
</p>
</section>
</div>
<footer> <footer>
<p>ItsGoin &mdash; Apache 2.0 License &mdash; <a href="https://itsgoin.com">itsgoin.com</a></p> <p>ItsGoin &mdash; Apache 2.0 License &mdash; <a href="https://itsgoin.com">itsgoin.com</a> &middot; <a href="https://discord.gg/pCjMbY9PmN">Discord</a> &middot; <a href="https://git.itsgoin.net/Sologretto/itsgoin">Source Code</a></p>
</footer> </footer>
</body> </body>
</html> </html>

13
website/download.html
View file

@ -15,6 +15,8 @@
<a href="tech.html">How It Works</a> <a href="tech.html">How It Works</a>
<a href="design.html">Design</a> <a href="design.html">Design</a>
<a href="download.html" class="active">Download</a> <a href="download.html" class="active">Download</a>
<a href="contribute.html">Contribute</a>
<a href="https://discord.gg/pCjMbY9PmN">Discord</a>
</div> </div>
</nav> </nav>
@ -215,10 +217,19 @@
</ul> </ul>
</div> </div>
</section> </section>
<section>
<h2>Help build ItsGoin</h2>
<p>This project is open source and could use your help. Whether you're a developer, tester, or just have ideas &mdash; jump in.</p>
<p style="margin-top: 0.75rem;">
<a href="https://discord.gg/pCjMbY9PmN" class="btn btn-primary" style="margin-right: 0.5rem;">Join the Discord</a>
<a href="https://git.itsgoin.net/Sologretto/itsgoin" class="btn btn-secondary">Source code</a>
</p>
</section>
</div> </div>
<footer> <footer>
<p>ItsGoin &mdash; Apache 2.0 License &mdash; <a href="https://itsgoin.com">itsgoin.com</a></p> <p>ItsGoin &mdash; Apache 2.0 License &mdash; <a href="https://itsgoin.com">itsgoin.com</a> &middot; <a href="https://discord.gg/pCjMbY9PmN">Discord</a> &middot; <a href="https://git.itsgoin.net/Sologretto/itsgoin">Source Code</a></p>
</footer> </footer>
</body> </body>
</html> </html>

12
website/index.html
View file

@ -15,6 +15,8 @@
<a href="tech.html">How It Works</a> <a href="tech.html">How It Works</a>
<a href="design.html">Design</a> <a href="design.html">Design</a>
<a href="download.html">Download</a> <a href="download.html">Download</a>
<a href="contribute.html">Contribute</a>
<a href="https://discord.gg/pCjMbY9PmN">Discord</a>
</div> </div>
</nav> </nav>
@ -123,13 +125,17 @@
<section> <section>
<h2>Get involved</h2> <h2>Get involved</h2>
<p>ItsGoin is open source and always will be.</p> <p>ItsGoin is open source and always will be. Built by a network tech guy vibe-coding beyond his abilities with AI &mdash; and it works. But it could use your help to get even better.</p>
<p><a href="download.html">Download the app</a> &middot; <a href="tech.html">Read the technical overview</a> &middot; <a href="design.html">Explore the design document</a></p> <p style="margin-top: 0.75rem;">
<a href="download.html" class="btn btn-primary" style="margin-right: 0.5rem;">Download the app</a>
<a href="https://discord.gg/pCjMbY9PmN" class="btn btn-secondary" style="margin-right: 0.5rem;">Join the Discord</a>
<a href="https://git.itsgoin.net/Sologretto/itsgoin" class="btn btn-secondary">Browse the code</a>
</p>
</section> </section>
</div> </div>
<footer> <footer>
<p>ItsGoin &mdash; Apache 2.0 License &mdash; <a href="https://itsgoin.com">itsgoin.com</a></p> <p>ItsGoin &mdash; Apache 2.0 License &mdash; <a href="https://itsgoin.com">itsgoin.com</a> &middot; <a href="https://discord.gg/pCjMbY9PmN">Discord</a> &middot; <a href="https://git.itsgoin.net/Sologretto/itsgoin">Source Code</a></p>
</footer> </footer>
</body> </body>
</html> </html>

15
website/tech.html
View file

@ -15,6 +15,8 @@
<a href="tech.html" class="active">How It Works</a> <a href="tech.html" class="active">How It Works</a>
<a href="design.html">Design</a> <a href="design.html">Design</a>
<a href="download.html">Download</a> <a href="download.html">Download</a>
<a href="contribute.html">Contribute</a>
<a href="https://discord.gg/pCjMbY9PmN">Discord</a>
</div> </div>
</nav> </nav>
@ -193,10 +195,21 @@ wrapped_key[i] = X25519_DH(author_ed25519, recipient_ed25519[i]) XOR CEK</code><
</table> </table>
</div> </div>
</section> </section>
<section>
<h2>Help build ItsGoin</h2>
<div class="card">
<p>Full disclosure: ItsGoin has been 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, the codebase is real, and it works &mdash; but it could use experienced eyes and hands.</p>
<p>If you're a Rust developer, a systems programmer, a cryptography enthusiast, or just someone who cares about decentralized tech &mdash; we'd love your help. The code is open source and the design document lays out everything.</p>
<p style="margin-top: 1rem;">
<a href="https://git.itsgoin.net/Sologretto/itsgoin" class="btn btn-primary" style="margin-right: 0.5rem;">Browse the code</a>
<a href="https://discord.gg/pCjMbY9PmN" class="btn btn-secondary">Join the Discord</a>
</p>
</div>
</section>
</div> </div>
<footer> <footer>
<p>ItsGoin &mdash; Apache 2.0 License &mdash; <a href="https://itsgoin.com">itsgoin.com</a></p> <p>ItsGoin &mdash; Apache 2.0 License &mdash; <a href="https://itsgoin.com">itsgoin.com</a> &middot; <a href="https://discord.gg/pCjMbY9PmN">Discord</a> &middot; <a href="https://git.itsgoin.net/Sologretto/itsgoin">Source Code</a></p>
</footer> </footer>
</body> </body>
</html> </html>