@bluealba/platform-cli 1.0.1 → 1.1.0

package/docs/getting-started/overview.mdx

@@ -0,0 +1,83 @@
+---
+title: Platform Overview
+description: Introduction to the Blue Alba Platform - a comprehensive framework for building customer-facing applications with multi-tenancy, micro-frontends, and enterprise-grade features
+---
+
+import { Card, CardGrid } from '@astrojs/starlight/components';
+
+## What is the Blue Alba Platform?
+
+The **Blue Alba Platform** is a comprehensive enterprise framework designed to accelerate the development of customer-facing applications. It provides a complete foundation with built-in multi-tenancy, micro-frontend/micro-services architecture, robust authentication/authorization, and a rich set of shared libraries and tools. It provides a robust foundation for building scalable applications with enterprise-grade features.
+
+Think of it as a production-ready platform that handles all the complex infrastructure and common features, allowing you to focus on building your unique business logic and user experiences.
+
+## Key Value Concepts
+
+<CardGrid stagger>
+  <Card title="Authentication / Authorization" icon="license">
+    Multi-provider OAuth 2.0, JWT sessions, API keys, service-to-service auth.
+    Role-based access control with operations, roles, and conditional rules.
+  </Card>
+
+  <Card title="Multi-Tenancy Built-In" icon="star">
+    Complete tenant isolation and context management out of the box. Deploy once, serve multiple customers with data isolation, custom branding, and tenant-specific configurations.
+  </Card>
+
+  <Card title="Microservices / Micro-Frontend Architecture" icon="puzzle">
+    Modular, independently deployable services.
+    Build and deploy UI applications independently using single-spa. Teams can work autonomously while maintaining a cohesive user experience through the Shell UI.
+  </Card>
+
+  <Card title="Rapid Development" icon="rocket">
+    Pre-built services, UI components, and development tools dramatically reduce time-to-market. Focus on features, not infrastructure.
+  </Card>
+
+  <Card title="Production-Ready" icon="approve-check">
+    Battle-tested architecture with authentication (multi-IDP), API gateway, WebSocket support, audit trails, and comprehensive monitoring capabilities.
+  </Card>
+
+  <Card title="Extensibility" icon="puzzle">
+    Designed for customization. Add new services, UI applications, or integrate with existing systems using well-defined APIs and SDK libraries.
+  </Card>
+</CardGrid>
+
+## Who Should Use It?
+
+The Blue Alba Platform is ideal for:
+
+- **Product Teams** building applications that need multi-tenancy from day one
+- **Enterprise Organizations** developing internal or customer-facing applications with complex authorization requirements
+- **Development Teams** looking to standardize on a proven architecture and avoid reinventing common platform features
+
+## What's Included?
+
+Out of the box, the platform provides:
+
+### Core Features
+
+- Multi-tenant architecture
+- JWT-based authentication with [multi-IDP support]
+- Role-based access control with operations, roles, and rules
+- API gateway with HTTP/2, WebSocket, and Lambda support
+- Application catalog
+- User management
+
+### Services
+
+- **HTTP Gateway** centralized routing, SSL termination, HTTP/2, WebSocket support, authentication, authorization
+- **Database** sotrage for all the platform related data
+- **Documentation** built-in site with all the platform documentation
+- **Scheduler** to schedule tasks to be executed asynchronously
+
+### Administration UIs
+
+- **Shell UI** main platform layout to host micro-frontend applications
+- **Admin UI** Platform administration UI for managing users, roles, applications
+
+## Next Steps
+
+Ready to get started?
+
+**[Quick Start Guide](/_/docs/getting-started/quick-start/)** - Get up and running
+
+