FAQ: Getting Started with Guardyn Development

[anrysys]

Frequently Asked Questions - Development

This thread covers common questions about setting up and developing Guardyn.

🚀 Getting Started

Q: What are the prerequisites?

A: You need Nix package manager installed. Run nix develop to enter the development shell with all tools (Rust, kubectl, k3d, helm, etc.).

Q: How do I set up a local development environment?

A:

nix develop              # Enter dev shell
just kube-create         # Create k3d cluster
just kube-bootstrap      # Install core components
just k8s-deploy <service> # Deploy specific services

Q: What technologies does Guardyn use?

A:

• Backend: Rust with tonic (gRPC)
• Cryptography: X3DH, Double Ratchet, OpenMLS (MLS)
• Data: TiKV (transactional KV), ScyllaDB (high-throughput)
• Messaging: NATS JetStream
• Orchestration: Kubernetes (k3d for local dev)
• Client: Flutter (cross-platform)

🔧 Development

Q: How is the project structured?

A:

• backend/ - Rust services (auth, messaging, media, presence, notification)
• client/ - Flutter mobile/desktop client
• infra/ - Kubernetes manifests and deployment scripts
• docs/ - All project documentation

Q: How do I run tests?

A:

backend/crates/e2e-tests/scripts/run-e2e-tests.sh  # E2E tests
backend/crates/e2e-tests/scripts/run-performance-tests.sh  # Performance tests

Q: How do I deploy changes?

A:

infra/scripts/build-and-deploy-services.sh  # Build and deploy all services
infra/scripts/redeploy-messaging.sh         # Redeploy messaging service only

�� Security

Q: What encryption does Guardyn use?

A:

• 1-on-1: X3DH for key exchange + Double Ratchet for forward secrecy
• Groups: MLS (Messaging Layer Security) via OpenMLS
• Transport: TLS 1.3 for all connections

Q: Is Guardyn audited?

A: We're in MVP/PoC phase. Professional security audit is planned before production release.

📚 More Questions?

If your question isn't answered here:

1. Check the Documentation
2. Search existing discussions
3. Ask a new question in Q&A category

We're here to help! 🤝