Skip to content
This repository was archived by the owner on Feb 6, 2025. It is now read-only.

Commit fc39828

Browse files
committed
(docs): Implementing Yuval's feedback on the Blueprints Overview page.
1 parent ba1cd91 commit fc39828

File tree

1 file changed

+26
-21
lines changed

1 file changed

+26
-21
lines changed

Diff for: docs/platform-features/blueprints.md

+26-21
Original file line numberDiff line numberDiff line change
@@ -7,25 +7,24 @@ slug: /blueprints
77

88
# Blueprints
99

10-
Blueprints are a powerful feature that let organizations create and manage any type of resource in their development ecosystem.
11-
Whether you're working with Java services, Python apps, deployment configurations, or database setups, Blueprints provide a flexible way to define, generate, and manage these resources.
10+
Blueprints are a powerful feature that lets organizations create and manage any type of resource in their development ecosystem.
11+
Whether you're building Java microservices, Python SDKs, React front-end apps, Terraform configurations, or PostgreSQL database setups, Blueprints provide a flexible way to define, generate, and manage these resources.
1212

1313
![Project-level Blueprints Tab](./assets/blueprints/blueprint.png)
1414

1515
## Why Use Blueprints
1616

17-
Amplication provides enterprise-grade code generation for Node.js and .NET services, offering integration with industry-leading tools like Prisma, PostgreSQL, and MongoDB.
18-
19-
With Blueprints, we expand these capabilities to support any programming language, framework, database, or deployment option your team uses.
20-
This allows you to create standardized resources that match your organization's specific technology choices and requirements.
17+
Blueprints enable organizations to implement their own standards, best practices, and technology choices across their development ecosystem.
18+
You can create standardized resources that match your specific requirements while maintaining consistency across teams and projects.
2119

2220
With Blueprints you can:
2321

24-
- Create resources for any programming language or framework
25-
- Standardize resource creation across your organization
26-
- Define custom deployment configurations
27-
- Connect external services and APIs
28-
- Set up database resources
22+
- Describe any piece of software like SDKs, deplyoyment configs, front-end apps, and even Amplication plugins.
23+
- Create resources using your preferred technologies and frameworks
24+
- Implement organization-specific development standards
25+
- Define relationships between different parts of your system
26+
- Generate sophisticated and dynamic code based on resource relationships
27+
- Create reusable components that follow your architectural patterns
2928

3029
## How To Access Blueprints
3130

@@ -39,40 +38,46 @@ Access Blueprints from your Workspace by navigating to the dedicated Blueprints
3938

4039
### Blueprint
4140

42-
A blueprint defines how a specific type of resource will be implemented in your project. It provides the foundation for generating consistent, standardized resources across your organization. Each blueprint can generate multiple resources based on your specific requirements.
41+
A blueprint defines how a specific type of resource will be implemented in your project. It provides the foundation for generating consistent, standardized resources that align with your organization's architecture and practices. Each blueprint serves as a template that can generate multiple resources based on your requirements.
4342

4443
### Resource
4544

4645
A resource is a specific instance of a blueprint that developers use in their projects.
4746
When you create a resource from a blueprint, you get a fully configured instance that follows your organization's standards and best practices.
48-
You can manage that blueprint resource with the same tools that you can other resources
49-
For example, you can create multiple Java microservices from a single Java Spring Boot blueprint.
47+
48+
You manage blueprint resources using the same tools available for other resources in your project, like services.
5049

5150
![A resource created from a Blueprint](./assets/blueprints/resource.png)
5251

5352
### Plugins
5453

5554
Plugins define the code generation logic for your blueprints. When you create a resource from a blueprint, its associated plugins determine how the actual code and configuration files are generated.
5655

57-
Each plugin can provide specific functionality for your blueprint. For example:
56+
Each plugin can provide specific functionality for your blueprint.
57+
For example:
5858

59-
- Code generation for specific programming languages
60-
- Infrastructure configurations like Terraform files
61-
- Database schema definitions
62-
- API integrations and configurations
59+
- Custom code generation logic for your technology stack
60+
- Infrastructure and deployment configurations
61+
- Integration patterns and configurations
62+
- Organization-specific development standards
6363

6464
:::note
6565
Organizations can create private plugins to implement their specific requirements and standards. Visit the [Private Plugins](/private-plugins) page to learn more.
6666
:::
6767

6868
### Relations
6969

70-
Relations define connections between different blueprints, allowing you to model in-depth relationships in your architecture. For example, you can:
70+
Relations define connections between different blueprints, enabling you to model sophisticated relationships in your architecture.
71+
These relationships are available during the code generation process, allowing plugins to generate dynamic code based on connected resources and their configurations.
7172

72-
1. Connect service blueprints to their deployment configurations
73+
For example, you can:
74+
75+
1. Connect services to their deployment configurations
7376
2. Link services to their respective databases
7477
3. Define dependencies between different components
7578

79+
The context from these relationships enables intelligent code generation that understands how your resources interact and depend on each other.
80+
7681
![Relations between Blueprints](./assets/blueprints/relations.png)
7782

7883
## Next Steps

0 commit comments

Comments
 (0)