প্রকল্প সম্পর্কে

Mistorias Web contains the source code for the Mistorias platform's website. The project uses Astro as its primary framework for building the user interface and generating static or dynamic pages. The core mission of Mistorias is to transform education by combining narrative, data, and reflection, providing a user experience focused on meaningful learning. A key feature of this architecture is the clear separation between presentation logic and editorial content. While this repository manages the site structure, components, and technical configuration, the actual content is hosted in a dedicated repository called `mistorias-contenido`. This content repository is integrated into the main project as a Git submodule, allowing for independent and collaborative management of educational resources without interfering with the core codebase development. For local development, the project requires Node.js (with versions specified in `.nvmrc`) and the pnpm package manager. Basic commands for starting the development environment include installing dependencies and running the local server on port 4321. Additionally, the project supports a consistent development environment via Dev Containers (Docker), which helps replicate the deployment environment and reduces configuration issues across collaborators' machines. The technical documentation is extensive and well-structured. Developers can refer to `CONTRIBUTING.md` for setup and contribution guides, as well as specific guidelines for handling content via submodules. For architectural decisions, there are Architecture Decision Records (ADRs) in the `docs/adr/` folder, along with coding standards and commit practices in `docs/STANDARDS.md`. A quick guide for code assistants like Claude Code is also provided in `CLAUDE.md`.