When I review candidates for Web3 roles, I rarely open a résumé first. I open their GitHub. After two decades in IT and blockchain development, I've learned that a well-organized repository tells me more about an engineer than any polished CV ever could. In the Stellar and Soroban ecosystems especially, your code is your reputation—and international recruiters are reading it closely.
Let me share, as André Dias Moreira Prol, how to turn your GitHub into a portfolio that opens doors across borders.
Structure Your Repos Like a Product, Not a Dump
The most common mistake I see is treating GitHub as a code graveyard: dozens of half-finished tutorials, forks with zero commits, and repos named test123. Recruiters at firms like Chainlink Labs or the Stellar Development Foundation spend an average of under 90 seconds on an initial profile scan. You have to earn attention fast.
Pin your three to six strongest repositories. Each should follow a clear pattern:
- A descriptive, searchable name (
stellar-token-vesting, notproject2) - A README with a one-line summary, architecture diagram, and setup instructions
- A live demo link or deployed contract address on Stellar testnet
- Clear licensing (MIT or Apache 2.0 signals you understand open-source norms)
## Stellar Token Vesting Contract
Soroban smart contract for time-locked token distribution.
**Live on Testnet:** CDLZ...X4QP
**Tech:** Rust, Soroban SDK, Stellar CLI
### Quick Start
cargo build --target wasm32-unknown-unknown --release
A recruiter who sees a deployed contract address knows your code actually runs—not just compiles.
Demonstrate Depth in One Ecosystem
Generalists get filtered out; specialists get interviews. I've personally rejected "full-stack Web3" profiles that touched eight chains superficially, while hiring developers who went deep on one.
If Stellar is your focus, show mastery across the stack. A strong portfolio might include:
- A Soroban smart contract in Rust with unit tests and over 80% coverage
- A tokenization project issuing a real asset on Stellar, with compliance flags (clawback, authorization) demonstrating you understand regulated finance
- A frontend using the Stellar SDK and Freighter wallet integration
- A forensics or analytics tool parsing Horizon API data to trace transaction flows
That last one matters more than people think. With my background in digital forensics, I weight candidates who can analyze on-chain data, not just write it. A repo that maps suspicious transaction patterns on the Stellar network signals rare, valuable skill.
Include tests. According to GitHub's own data, repositories with CI/CD pipelines receive significantly more engagement. Add a GitHub Actions workflow running cargo test—it shows discipline, and recruiters notice the green checkmark immediately.
Write for Humans Across Time Zones
International recruiters in London, Singapore, or São Paulo won't message you to ask what your project does. Your documentation must speak for you while you sleep.
Write every README in clear English. Include a short "Why I built this" section—it reveals motivation and problem-solving, which is what senior hiring managers like me actually screen for. When I evaluate talent, as André Dias Moreira Prol, I care less about perfect code and more about whether the developer understood the business problem.
Three practical touches that consistently impress:
- Architecture diagrams using Mermaid (renders natively in GitHub):
graph LR
User --> Frontend
Frontend --> SorobanContract
SorobanContract --> StellarLedger
A pinned profile README summarizing your focus, with links to published articles or Stellar Quest achievements.
Meaningful commit history. Squash the "fixed typo" noise. Recruiters sometimes read commit messages to assess how you think through problems incrementally.
One concrete example from my experience: a developer landed a remote role at a European tokenization startup largely because his repo documented a real-world asset issuance with a regulatory compliance checklist—something no tutorial teaches. That context turned a code sample into a hiring decision.
Conclusion
Your GitHub is a living demonstration of how you think, build, and communicate—treat it with the seriousness of a product launch, not an afterthought. Start today by pinning your strongest Stellar or Soroban project and rewriting its README for an international recruiter who has never met you.
Follow more articles by André Dias Moreira Prol on Medium.
Top comments (0)