Best practices around exporting/import backend about docs

[josefaidt]

Hey @kekami 👋 thanks for raising this! I do think we need a bit of an explainer on how to work with custom resources in practice (with other Amplify-managed resources). To answer the immediate question think of backend.ts as your App.tsx but for your backend, and custom resources as your backend components. It's where everything comes together and resources are wired into the backend.

For custom resources (or custom constructs), you'd define construct props and set the prop values' type to the corresponding CDK resource. There's a couple of blog posts on writing custom constructs, like this one from bobbyhadz.com. Thinking about these custom resources as components, defining the inputs as props allows your construct to be portable.

Not sure if exporting backend would result in circular dependencies from a CDK perspective.

It may create a circular dependency, but it will create a circular reference if you were to import the backend into your custom construct, then import and initialize your custom construct in the backend.ts file

[kekami]

Hey @kekami 👋 thanks for raising this! I do think we need a bit of an explainer on how to work with custom resources in practice (with other Amplify-managed resources). To answer the immediate question think of backend.ts as your App.tsx but for your backend, and custom resources as your backend components. It's where everything comes together and resources are wired into the backend.

For custom resources (or custom constructs), you'd define construct props and set the prop values' type to the corresponding CDK resource. There's a couple of blog posts on writing custom constructs, like this one from bobbyhadz.com. Thinking about these custom resources as components, defining the inputs as props allows your construct to be portable.

Not sure if exporting backend would result in circular dependencies from a CDK perspective.

It may create a circular dependency, but it will create a circular reference if you were to import the backend into your custom construct, then import and initialize your custom construct in the backend.ts file

Sorry for the late response @josefaidt . Thanks for the clarification and an absolutely amazing response! 💫