chore(Doc): Updated Getting started Section
CI / lint-and-format (push) Successful in 33s
CI / changeset-check (push) Successful in 37s
CI / unit-tests (push) Successful in 33s
CI / component-tests (push) Successful in 29s

- Fixed some typos
- Updated the roadmap and project structure
This commit is contained in:
2026-09-04 11:17:44 +02:00
parent 4033aba10a
commit 3bb9c1f6fb
3 changed files with 39 additions and 22 deletions
@@ -5,13 +5,22 @@ sidebar:
order: 0 order: 0
--- ---
LUNA Charts is an open-source charting library built with a strong focus on **accessibility**, **developer experience**, and **long-term maintainability**. LUNA Charts is an open-source charting library built with a strong focus on **accessibility**, **developer experience**, and
**long-term maintainability**.
The project was created because many existing charting libraries provide excellent visualizations, but often treat accessibility, architecture, and maintainability as secondary concerns. The project was created because many existing charting libraries provide excellent visualizations but often
treat accessibility as a secondary concern. Furthermore, a lot of teams have a lack of accessibility awareness,
and accessibility features are often pushed to the end of the project.
LUNA Charts takes a different approach. LUNA Charts takes a different approach.
Instead of starting with code, the project started with an **architecture-first process**. The entire foundation—including business goals, technical architecture, governance, and architectural decisions—was designed before implementation began. Instead of focusing on becoming a big library with numerous chart-creation functions, this project concentrates
on ease of use and chart modification, with accessibility playing a major role throughout the entire development process.
LUNA-Charts is open-source software.
This guarantees that everyone can use and modify it. We want to make the world more accessible for everyone.
Furthermore, we focus on an **architecture-first process**. The entire foundation—including
business goals, technical architecture, governance, and architectural decisions—was designed before implementation began.
## Project Goals ## Project Goals
@@ -26,11 +35,9 @@ LUNA Charts aims to provide a charting library that is:
## Current Project Status ## Current Project Status
The project is currently in the **Groundwork** phase. The project is currently in the **First Proof of Concept (v0.3.0)** phase.
We validate the core technical and accessibility assumptions of the library through a first working implementation.
At this stage, the architecture, repository structure, development workflow, and governance model are being established before implementing the first chart components. The goal is to prove that the chosen architecture actually works in practice before committing to a broader component set.
Although no production-ready charts are available yet, the project documentation already reflects the long-term vision and architectural direction.
## Learn More ## Learn More
@@ -5,7 +5,8 @@ sidebar:
order: 1 order: 1
--- ---
LUNA Charts follows a modular repository structure that separates the chart library from its documentation while keeping all project artifacts within a single repository. LUNA Charts follows a modular repository structure that separates the chart library from its documentation while keeping
all project artifacts within a single repository.
```text ```text
luna-charts/ luna-charts/
@@ -51,31 +52,38 @@ It serves as the **Single Point of Truth (SPOT)** for:
- Project governance - Project governance
- User documentation - User documentation
The documentation is rendered using **Starlight**, but the Markdown content remains the authoritative source. The documentation is rendered using **Astro and Starlight**, but the Markdown content remains the authoritative source.
--- ---
## examples/ ## examples/
Example applications demonstrating how to integrate LUNA Charts with supported frontend frameworks will be added here in future iterations. Example applications demonstrating how to integrate LUNA Charts with supported frontend frameworks
will be added here in future iterations.
Examples may include: Examples may include:
- Vanilla JavaScript
- React - React
- Angular - Angular
- Vue - Vue
Right now, we are working on version 0.3.0, implementing a first proof of concept.
The first Minimum Viable Product will be launched with version 1.0.0.
--- ---
## .gitea/
- Gitea Actions
- Issue templates
- Pull request templates
- Community workflows
## .github/ ## .github/
Contains project automation such as: Contains project automation such as:
- GitHub Actions - Code of Conduct
- Issue templates
- Pull request templates
- Community workflows
--- ---
@@ -83,6 +91,7 @@ Contains project automation such as:
LUNA Charts is maintained as a **pnpm workspace**. LUNA Charts is maintained as a **pnpm workspace**.
This structure allows multiple packages and supporting projects to evolve together while sharing a consistent toolchain and development workflow. This structure allows multiple packages and supporting projects to evolve together while sharing a consistent
toolchain and development workflow.
As the project grows, additional packages or tooling may be introduced without changing the overall repository organization. As the project grows, additional packages or tooling may be introduced without changing the overall repository organization.
@@ -7,7 +7,9 @@ sidebar:
LUNA Charts follows an **architecture-first** development approach. LUNA Charts follows an **architecture-first** development approach.
Instead of implementing features immediately, the project establishes a solid architectural and organizational foundation before writing production code. This ensures long-term maintainability, consistent quality, and transparent decision-making. Instead of implementing features immediately, the project establishes a solid architectural and organizational
foundation before writing production code. This ensures long-term maintainability, consistent quality, and
transparent decision-making.
--- ---
@@ -20,7 +22,7 @@ Instead of implementing features immediately, the project establishes a solid ar
Completed work includes: Completed work includes:
- **Repository structure:** Standardized layout for code, configurations, and assets. - **Repository structure:** Standardized layout for code, configurations, and assets.
- \*\*Development workflow: Definition of branching strategies, commit rules, and review processes. - **Development workflow:** Definition of branching strategies, commit rules, and review processes.
- **Architecture documentation (TOGAF ADM):** Architecture framework set up according to the TOGAF standard. - **Architecture documentation (TOGAF ADM):** Architecture framework set up according to the TOGAF standard.
- **Architecture Decision Records (ADRs 1-5):** System established for transparent documentation of architectural decisions. - **Architecture Decision Records (ADRs 1-5):** System established for transparent documentation of architectural decisions.
- **Project governance:** Defined roles, responsibilities, and decision-making processes. - **Project governance:** Defined roles, responsibilities, and decision-making processes.
@@ -102,6 +104,5 @@ Future work may include:
## Long-Term Vision ## Long-Term Vision
LUNA Charts aims to become an accessible, framework-independent charting library that combines modern Web Components with a transparent architecture and a sustainable open-source development model. LUNA Charts aims to become an accessible, framework-independent charting library that combines modern Web Components with a
transparent architecture and a sustainable open-source development model.
Every milestone builds upon the architectural foundation established during the Groundwork phase.