How radzionc/radzionkit works
• Monorepo Shell: Represent the overall monorepo container managed via Yarn Workspaces.
• Library Side (lib): Create a cluster that includes all generic packages:
– UI Library (@lib/ui, @lib/next-ui, @lib/countries-ui, @lib/subscription-ui, @lib/analytics-ui, etc.)
– Utility Packages (@lib/utils, codegen, dynamodb, lambda, chain, dnd, etc.)
– Specialized modules (e.g., authentication types in @lib/auth, blockchain interactions in @lib/chain, country handling in @lib/countries).
– API backend (product/api, product/api-interface, product/api-ui, etc.) which contains further modules for auth, resolvers, database access, and AWS Lambda integration.
– Frontend application (product/app) built on Next.js.
– Auxiliary services (email, email-forwarder, secrets, entities, languages, and a UI demo (product/ui-demo)).
– Also include infrastructure-as-code components (Terraform configuration under infra directories and deployment scripts).
• Integration points with external infrastructure: AWS components (Lambda, DynamoDB, Secrets Manager), Terraform-managed resources (represented as a dedicated “Infra” component that links to both API and email-forwarder services).
• Cross-cutting concerns like “analytics” and “codegen” that might be used in both lib and product clusters.
Architectural Patterns and Design Principles
• Modular and reusable architecture: Emphasize the separation of concern between generic “lib” packages and project-specific “product” implementations.
• Monorepo Structure: Illustrate the use of Yarn Workspaces as an enabler of dependency sharing and central version control.
• Full-Stack Cohesion: Separate layers for frontend (UI, pages, Next.js configurations), backend (API, authentication, resolvers), and middleware/infrastructure (deployment scripts, Terraform files).
• Infrastructure as Code: Point out that Terraform configurations (files like main.tf, outputs.tf) work alongside API and email components to provision AWS resources.
Relevant Technologies, Frameworks, and Tools
• Yarn Workspaces, Next.js, React (in multiple UI libraries), TypeScript.
• AWS Services: Lambda, DynamoDB, Secrets Manager (with Terraform managing configuration).
• Build tools/configurations: Prettier, ESLint, Husky for git hooks, and code generation utilities.