How nasa-jpl/stellar works
Main Components
• Monorepo (Stellar Design System) – At the highest level, represent the overall repository and its infrastructure.
• Packages:
– React Package: Implements reusable React components (with storybook, rollup build config, component directories for Alerts, Buttons, Input, etc.).
– Svelte Package: Provides Svelte-based UI components, including examples, configuration files, and routes for demo purposes.
• Core Infrastructure & CI/CD:
– Build and deployment workflows (GitHub Actions for deploy-to-gh-pages and publish-to-npm).
– Shared configuration files (e.g., .npmrc, lerna.json, ESLint, Prettier, Stylelint configs).
• Documentation:
– Developer docs in the “docs” directory and developer guide in docs/DEVELOPER.md.
– README and other guidelines (LICENSE, CODE_OF_CONDUCT, SECURITY, etc.).
Relationships and Interactions
• CI/CD pipelines (GitHub Actions) as an external process node that interacts with the monorepo for building, testing, and deploying packages.
Architectural Patterns and Tools
• Monorepo structure with Lerna handling multi-package management.
• Use of component-based design in React and Svelte (with directories for individual UI components).
• Emphasis on cross-framework consistency: the CSS package is the foundation, and React/Svelte packages provide framework-specific wrappers.
• Build scripts, configuration files, and versioning are set up for automated publishing and deployment.