How technical-assignment-spherity/vc-wallet works
Project Type and Purpose
• This is a full-stack web application (“Verifiable Credential Wallet”) whose goal is to let users issue, store, share, display, and verify signed credentials.
• The frontend is a React/TypeScript Single-Page App; the backend is a NestJS/TypeScript REST API. Credentials are signed with JWT (HS256) and persisted to the local file system. Both sides are containerized via Docker Compose.
File Structure
• Top-level:
• docker-compose.yml, env.example, README.md
• backend/
• frontend/
• backend/:
• Dockerfile, NestJS config (nest-cli.json, tsconfig.json, ESLint/Prettier).
• src/app.module.ts wires modules.
• src/credentials ● controller, service, module, DTOs, entity.
• main.ts boots the NestJS HTTP server on port 3001.
• frontend/:
• Dockerfile, nginx.conf (serving built assets).
• public/index.html, src/index.tsx mounts React.
• src/components (CredentialForm, CredentialList, CredentialCard, CredentialVerifier).
• src/services/credentialService.ts calls the backend API.
• TypeScript config (tsconfig.json).
• Root-level docker-compose.yml orchestrates two services (backend:3001, frontend:3000).
README for Additional Insights
• Tech Stack summary aligns with the file structure.
• Environment variables: JWT_SECRET, PORT, FRONTEND_URL.
• Local development (npm scripts) vs. containerized deployment.
• API endpoints under /credentials for CRUD + verify.