Skip to content

Commit 262d323

Browse files
Update version to 26.2.1 in astro.config.mjs and revise documentation to reflect rebranding to Dynamia Platform
1 parent 62e950d commit 262d323

4 files changed

Lines changed: 139 additions & 67 deletions

File tree

.github/copilot-instructions.md

Lines changed: 21 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22

33
## Project Overview
44

5-
This is the official documentation website for **DynamiaTools** (https://dynamia.tools), a full-stack Java 25 framework for building enterprise web applications powered by Spring Boot 4, ZK 10 and frontend libraries.
5+
This is the official documentation website for **Dynamia Platform** (https://dynamia.tools), the next generation of DynamiaTools. It's a cutting-edge full-stack Java 25 framework for building enterprise web applications powered by Spring Boot 4 and ZK 10.
6+
7+
**Current Version**: 26.2.0 (CalVer: YY.MM.MINOR - February 2026)
68

79
The website is built using:
810
- **Astro** (v5.17.2+) - Static site generator
@@ -37,7 +39,10 @@ website/
3739
## Key Configuration
3840

3941
### Framework Version
40-
- Current DynamiaTools version is defined in `astro.config.mjs` as `dynamiaToolsVersion`
42+
- Current Dynamia Platform version: **26.2.0** (CalVer format: YY.MM.MINOR)
43+
- Version is defined in `astro.config.mjs` as `dynamiaToolsVersion`
44+
- CalVer means: Year 26 (2026), Month 02 (February), Release 0
45+
- All Dynamia Platform modules share the same version (unified versioning)
4146
- When updating framework version, update this constant
4247

4348
### Site Configuration
@@ -62,13 +67,14 @@ All documentation files should:
6267
- `Code` for syntax highlighting
6368

6469
### Code Examples
65-
When writing code examples for DynamiaTools:
70+
When writing code examples for Dynamia Platform:
6671
- Use **Java 25** syntax and features
6772
- Include relevant **Spring Boot 4** annotations
6873
- Show **JPA/Jakarta Persistence** annotations (not javax.*)
6974
- Reference **ZK 10** components when applicable
7075
- Include package declarations and imports
7176
- Add comments to explain key concepts
77+
- When mentioning versions, use CalVer format (e.g., 26.2.0)
7278

7379
Example format:
7480
```java
@@ -105,7 +111,9 @@ autofields: true
105111
```
106112
107113
### Framework Concepts to Document
108-
Key DynamiaTools concepts to explain clearly:
114+
Key Dynamia Platform concepts to explain clearly:
115+
- **CalVer Versioning** - Calendar-based versioning (YY.MM.MINOR)
116+
- **Unified Repository** - Core + Extensions in one place
109117
- **Modules** and ModuleProvider
110118
- **Pages** and PageGroups
111119
- **Navigation** system
@@ -114,6 +122,8 @@ Key DynamiaTools concepts to explain clearly:
114122
- **View Descriptors** (forms, tables)
115123
- **Actions** and ActionEvent
116124
- **Templates** and themes
125+
- **Enterprise Extensions** - SaaS, reporting, dashboard, security, email/SMS, file management
126+
- **@EnableDynamiaTools** annotation
117127
118128
## Styling
119129
@@ -172,9 +182,10 @@ npm run astro check # Type check
172182
3. Follow existing patterns for structure
173183

174184
### Updating Framework Version
175-
1. Update `dynamiaToolsVersion` in `astro.config.mjs`
185+
1. Update `dynamiaToolsVersion` in `astro.config.mjs` (e.g., from 26.2.0 to 26.3.0)
176186
2. Update any version references in documentation
177187
3. Update code examples if API changed
188+
4. Remember: All Dynamia Platform modules share the same CalVer version
178189

179190
### Adding Images
180191
1. Place images in `src/assets/` for optimized processing
@@ -194,10 +205,11 @@ npm run astro check # Type check
194205
4. **Mobile Friendly**: Starlight handles this, but test complex layouts
195206
5. **Accessibility**: Use semantic HTML and proper alt text
196207
6. **SEO**: Write descriptive titles and descriptions
197-
7. **Version Awareness**: Specify which DynamiaTools version features require
208+
7. **Version Awareness**: Specify which Dynamia Platform version features require (use CalVer format)
198209
8. **Cross-reference**: Link related concepts together
199210
9. **Update Both Languages**: When adding English content, plan for Spanish translation
200211
10. **Test Locally**: Always run `npm run dev` to preview changes
212+
11. **CalVer Consistency**: When mentioning versions, always use YY.MM.MINOR format (e.g., 26.2.0)
201213

202214
## External Resources
203215

@@ -227,5 +239,7 @@ Before committing documentation changes:
227239
- [ ] Mobile-friendly layout
228240
- [ ] Accessible to screen readers
229241
- [ ] Spanish translation planned/added (if applicable)
230-
- [ ] Framework version requirements noted (if applicable)
242+
- [ ] Framework version requirements noted using CalVer format (if applicable)
243+
- [ ] References to "DynamiaTools" updated to "Dynamia Platform" where appropriate
244+
- [ ] Java 25 and Spring Boot 4 mentioned correctly
231245

astro.config.mjs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
import {defineConfig} from 'astro/config';
22
import starlight from '@astrojs/starlight';
33

4-
export const dynamiaToolsVersion = '5.4.5'
4+
export const dynamiaToolsVersion = '26.2.1'
55

66

77
// https://astro.build/config

src/content/docs/es/index.mdx

Lines changed: 58 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: DynamiaTools
3-
description: Framework Fullstack Java 21 para aplicaciones web empresariales, impulsado por Spring Boot 3.5 y ZK 10
2+
title: Dynamia Platform
3+
description: Framework full-stack Java 25 para aplicaciones web empresariales impulsado por Spring Boot 4 y ZK 10
44
template: splash
55
hero:
6-
tagline: Un framework Java 21 full-stack de vanguardia diseñado para construir potentes aplicaciones web empresariales, aprovechando la fuerza de Spring Boot 3 y la elegancia de ZK 10.
6+
tagline: La próxima generación de DynamiaTools. Un framework Java 25 full-stack de vanguardia diseñado para construir aplicaciones web empresariales robustas y escalables, impulsado por Spring Boot 4 y ZK 10.
77
image:
88
file: ../../../assets/dynamia-tools-splash.webp
99
actions:
@@ -17,41 +17,71 @@ hero:
1717
---
1818

1919
import {Card, CardGrid, LinkButton} from '@astrojs/starlight/components';
20+
import {dynamiaToolsVersion} from '../../../../astro.config.mjs';
21+
22+
export const version = dynamiaToolsVersion;
2023

2124
<CardGrid stagger>
22-
<Card title="¿Qué es?" icon="pencil">
23-
DynamiaTools es un framework para construir aplicaciones web Java 21 de forma rápida y sencilla usando patrones de diseño estándar,
24-
descriptores de vistas para generación automática de UI, acciones, servicios y módulos.
25+
<Card title="¿Qué es Dynamia Platform?" icon="pencil">
26+
**Dynamia Platform** es la próxima generación de DynamiaTools—un framework unificado con baterías incluidas para construir aplicaciones web empresariales en Java 25 de forma rápida y sencilla usando patrones de diseño estándar, descriptores de vistas para generación automática de UI, acciones, servicios y módulos.
27+
28+
Impulsado por **Spring Boot 4** (https://spring.io), **ZK 10** (https://www.zkoss.org) para generación automática de interfaces web, y **JPA** para persistencia de datos.
2529

26-
Impulsado por Spring Boot (https://spring.io), ZK (https://www.zkoss.org) para la interfaz web y JPA.
30+
Ahora con **versionado CalVer** (AA.MM.MENOR) y todos los módulos unificados en una sola versión: **{version}** (Febrero 2026).
2731
</Card>
2832
<Card title="¿Qué puede hacer?" icon="add-document">
29-
* Crear aplicaciones web full-stack.
30-
* Escribir aplicaciones modulares. Sí, puedes crear un módulo (archivo jar) y reutilizarlo. Te ayuda a mantener tu
31-
proyecto DRY.
32-
* Vistas CRUD automáticas y endpoints REST para operaciones CRUD.
33-
* Extiende el framework con nuevos módulos, acciones y servicios.
34-
* Usa HTML5 en tu aplicación gracias al framework ZK, esto significa que puedes usar Bootstrap, CSS 3 y muchas tecnologías HTML5.
35-
* Personaliza tu aplicación con temas o plantillas.
36-
* Integra con otros frameworks Java y mucho más.
33+
* **Construir aplicaciones web full-stack** con generación automática de UI
34+
* **Escribir aplicaciones modulares** - Crea módulos (archivos JAR) y reutilízalos en múltiples proyectos (principio DRY)
35+
* **Vistas CRUD y endpoints REST automáticos** - Cero código requerido para operaciones estándar
36+
* **Extensiones empresariales listas** - Multi-tenencia (SaaS), reportes, dashboards, email/SMS, seguridad y más
37+
* **Extender el framework** con módulos, acciones y servicios personalizados
38+
* **Soporte HTML5 moderno** vía framework ZK - Usa Bootstrap, CSS3 y tecnologías HTML5
39+
* **Personalizar con temas y plantillas** - Sistema de tematización enchufable
40+
* **Integración perfecta** con cualquier framework o librería Java
3741
</Card>
38-
<Card title="¿Es maduro?" icon="setting">
39-
Sí, se utiliza en muchos proyectos en producción y está impulsado por los mejores frameworks del ecosistema Java:
40-
* Spring framework para integración, REST e infraestructura.
41-
* Spring Boot para configuración y despliegue sencillo.
42-
* ZK framework para interfaces de usuario web.
43-
* JPA estándar para la capa de persistencia por defecto.
44-
* Jackson para serialización JSON/XML.
45-
* YAML para descriptores de vistas.
46-
47-
<LinkButton href="/history" variant="secondary" >
42+
<Card title="¿Es maduro y está listo para producción?" icon="setting">
43+
**¡Absolutamente!** Dynamia Platform tiene **más de 13 años** de desarrollo continuo e impulsa **más de 10 proyectos en producción** con **más de 40 módulos empresariales** en entornos del mundo real.
44+
45+
Construido sobre los mejores frameworks del ecosistema Java:
46+
* **Spring Boot 4** para infraestructura moderna y despliegue sencillo
47+
* **Java 25** - Últimas innovaciones y rendimiento
48+
* **ZK 10** para generación automática de interfaces de usuario web
49+
* **JPA** para capa de persistencia estándar
50+
* **Jackson** para serialización JSON/XML
51+
* **YAML** para descriptores de vistas declarativos
52+
53+
<LinkButton href="/es/history" variant="secondary">
4854
Conoce nuestra historia
4955
</LinkButton>
5056
</Card>
57+
<Card title="¿Qué hay de nuevo en v26?" icon="star">
58+
La **serie 26.x** trae mejoras importantes:
59+
60+
* 📅 **Versionado CalVer** - Todos los módulos comparten la misma versión ({version})
61+
* ☕ **Java 25** - Últimas características y rendimiento del JVM
62+
* 🚀 **Spring Boot 4** - Ecosistema Spring de próxima generación
63+
* 🏢 **Repositorio Unificado** - Core + Extensiones juntos
64+
* 📦 **Extensiones Integradas** - SaaS, reportes, dashboard, seguridad, email/SMS, gestión de archivos
65+
* ⚡ **Filosofía Zero-Config** - Valores predeterminados sensatos con fácil personalización
66+
* 🛡️ **Nivel Empresarial** - Multi-tenencia, seguridad y escalabilidad
67+
68+
Todo impulsado por una plataforma **probada en producción** utilizada por empresas en América Latina y Europa.
69+
</Card>
70+
<Card title="Inicio Rápido" icon="rocket">
71+
Comienza en minutos:
72+
73+
1. Crea un proyecto Spring Boot 4 + Java 25
74+
2. Agrega la dependencia `tools.dynamia.app:{version}`
75+
3. Agrega la anotación `@EnableDynamiaTools`
76+
4. ¡Ejecuta y disfruta tu aplicación full-stack!
77+
78+
Lee la guía de [Comenzando](/es/getting-started) para instrucciones detalladas y ejemplos.
79+
</Card>
5180
<Card title="Lee la documentación" icon="open-book">
52-
Comienza con la guía de [Comenzando](/getting-started) para empezar rápidamente. A medida que avances, explora temas avanzados
53-
para profundizar tu conocimiento.
81+
Comienza con la guía de [Comenzando](/es/getting-started) para ponerte en marcha rápidamente. Aprende sobre [Conceptos Clave](/es/key-concepts) y explora temas avanzados para profundizar tu conocimiento.
82+
83+
Descubre las **extensiones empresariales integradas**, personaliza tu aplicación, extiende el framework y construye soluciones innovadoras con **Dynamia Platform**.
5484

55-
Personaliza tu aplicación, extiende el framework y construye tus propias soluciones innovadoras con DynamiaTools.
85+
**Próximamente**: SDK de TypeScript, plantillas Vue/React, documentación mejorada, ¡y más!
5686
</Card>
5787
</CardGrid>

src/content/docs/index.mdx

Lines changed: 59 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: DynamiaTools
3-
description: Fullstack Java 21 framework for enterprise web applications powered by Spring Boot 3.5 and ZK 10
2+
title: Dynamia Platform
3+
description: Full-stack Java 25 framework for enterprise web applications powered by Spring Boot 4 and ZK 10
44
template: splash
55
hero:
6-
tagline: A cutting-edge full-stack Java 21 framework designed for building powerful enterprise web applications, harnessing the strength of Spring Boot 3 and the elegance of ZK 10.
6+
tagline: The next generation of DynamiaTools. A cutting-edge full-stack Java 25 framework engineered for building robust, scalable enterprise web applications, powered by Spring Boot 4 and ZK 10.
77
image:
88
file: ../../assets/dynamia-tools-splash.webp
99
actions:
@@ -17,43 +17,71 @@ hero:
1717
---
1818

1919
import {Card, CardGrid, LinkButton} from '@astrojs/starlight/components';
20+
import {dynamiaToolsVersion} from '../../../astro.config.mjs';
21+
22+
export const version = dynamiaToolsVersion;
2023

2124
<CardGrid stagger>
22-
<Card title="What is?" icon="pencil">
23-
DynamiaTools is a framework for building Java 21 web applications fast and easy using standard design patterns,
24-
views descriptors for automatic UI generation, actions, services and modules.
25+
<Card title="What is Dynamia Platform?" icon="pencil">
26+
**Dynamia Platform** is the next generation of DynamiaTools—a unified, batteries-included framework for building Java 25 enterprise web applications fast and easy using standard design patterns, view descriptors for automatic UI generation, actions, services, and modules.
27+
28+
Powered by **Spring Boot 4** (https://spring.io), **ZK 10** (https://www.zkoss.org) for automatic web UI generation, and **JPA** for data persistence.
2529

26-
Powered by Spring Boot (https://spring.io), ZK (https://www.zkoss.org) for web UI and JPA.
30+
Now with **CalVer versioning** (YY.MM.MINOR) and all modules unified in one version: **{version}** (February 2026).
2731
</Card>
28-
<Card title="What can do?" icon="add-document">
29-
* Create full-stack web applications.
30-
* Write modular applications. Yes, you could create a module (jar file) and reuse it. It helps you to keep your
31-
project DRY.
32-
* Automatic CRUD views and REST endpoints for CRUD operations.
33-
* Extends the framework with new modules, actions and services.
34-
* Use HTML5 in your application thanks to ZK framework, this means you can use Bootstrap, CSS 3, and many HTML5
35-
technologies
36-
* Customize your application with themes or templates.
37-
* Integrate with other Java framework and much more
32+
<Card title="What can it do?" icon="add-document">
33+
* **Build full-stack web applications** with automatic UI generation
34+
* **Write modular applications** - Create modules (JAR files) and reuse them across projects (DRY principle)
35+
* **Automatic CRUD views and REST endpoints** - Zero code required for standard operations
36+
* **Enterprise-ready extensions** - Multi-tenancy (SaaS), reporting, dashboards, email/SMS, security, and more
37+
* **Extend the framework** with custom modules, actions, and services
38+
* **Modern HTML5 support** via ZK framework - Use Bootstrap, CSS3, and HTML5 technologies
39+
* **Customize with themes and templates** - Pluggable UI theming system
40+
* **Seamless integration** with any Java framework or library
3841
</Card>
39-
<Card title="It is mature?" icon="setting">
40-
Yes, is used in many productions projects and is powered by the best frameworks in Java ecosystem:
41-
* Spring framework for integration, REST and infrastructure.
42-
* Spring Boot for easy setup and deploy
43-
* ZK framework for web user interfaces
44-
* Standard JPA for default persistence layer.
45-
* Jackson for JSON/XML serialization
46-
* YAML for view descriptors
47-
48-
<LinkButton href="/history" variant="secondary" >
42+
<Card title="Is it mature and production-ready?" icon="setting">
43+
**Absolutely!** Dynamia Platform has **13+ years** of continuous development and powers **10+ production projects** with **40+ enterprise modules** in real-world environments.
44+
45+
Built on the best frameworks in the Java ecosystem:
46+
* **Spring Boot 4** for modern infrastructure and easy deployment
47+
* **Java 25** - Latest innovations and performance
48+
* **ZK 10** for automatic web user interface generation
49+
* **JPA** for standard persistence layer
50+
* **Jackson** for JSON/XML serialization
51+
* **YAML** for declarative view descriptors
52+
53+
<LinkButton href="/history" variant="secondary">
4954
Know our history
5055
</LinkButton>
5156
</Card>
57+
<Card title="What's new in v26?" icon="star">
58+
The **26.x series** brings major improvements:
59+
60+
* 📅 **CalVer Versioning** - All modules share the same version ({version})
61+
* ☕ **Java 25** - Latest JVM features and performance
62+
* 🚀 **Spring Boot 4** - Next-gen Spring ecosystem
63+
* 🏢 **Unified Repository** - Core + Extensions together
64+
* 📦 **Built-in Extensions** - SaaS, reporting, dashboard, security, email/SMS, file management
65+
* ⚡ **Zero-Config Philosophy** - Sensible defaults with easy customization
66+
* 🛡️ **Enterprise-Grade** - Multi-tenancy, security, and scalability
67+
68+
All powered by a **production-proven** platform used by companies across Latin America and Europe.
69+
</Card>
70+
<Card title="Quick Start" icon="rocket">
71+
Get started in minutes:
72+
73+
1. Create a Spring Boot 4 + Java 25 project
74+
2. Add `tools.dynamia.app:{version}` dependency
75+
3. Add `@EnableDynamiaTools` annotation
76+
4. ¡Run and enjoy your full-stack application!
77+
78+
Read the [Getting Started](/getting-started) guide for detailed instructions and examples.
79+
</Card>
5280
<Card title="Read the docs" icon="open-book">
53-
Start with the [Getting Started](/getting-started) guide to quickly get up and running. As you progress, dive into advanced topics
54-
to deepen your knowledge.
81+
Start with the [Getting Started](/getting-started) guide to quickly get up and running. Learn about [Key Concepts](/key-concepts) and explore advanced topics to deepen your knowledge.
82+
83+
Discover the **built-in enterprise extensions**, customize your application, extend the framework, and build innovative solutions with **Dynamia Platform**.
5584

56-
Customize your application, extend the framework, and build your own innovative
57-
solutions with DynamiaTools.
85+
**Coming soon**: TypeScript SDK, Vue/React templates, enhanced documentation, and more!
5886
</Card>
5987
</CardGrid>

0 commit comments

Comments
 (0)