Generated on May 8, 2026. This document maps the current repository footprint and Oshun-specific integration points for Nyx.
Implementation Context#
Nyx is a Cosmic Observatory Platform that combines interactive star mapping, high-precision celestial calculations, VR planetarium experiences, AR sky identification, telescope control, astrophotography tools, and educational features into a complete astronomy ecosystem. This document describes every user-facing feature from the perspective of stargazers, educators, astrophotographers, and telescope operators.
Status Snapshot#
- Repository status: Repository implementation exists under apps/libs/services.
- Oshun integration status: Dedicated Oshun domain adapter library present.
- TODO phases:
21
Applications#
apps/nyx/api/- Apiapps/nyx/ar-sky/- Ar Skyapps/nyx/education/- Educationapps/nyx/mobile/- Mobileapps/nyx/pipelines/- Pipelinesapps/nyx/star-map/- Star Mapapps/nyx/tools/- Toolsapps/nyx/vr-planetarium/- Vr Planetarium
Libraries#
libs/nyx/analysis/- Analysislibs/nyx/api-client/- Api Clientlibs/nyx/audio/- Audiolibs/nyx/catalogs/- Catalogslibs/nyx/client/- Clientlibs/nyx/client-python/- Client Pythonlibs/nyx/constants/- Constantslibs/nyx/constellations/- Constellationslibs/nyx/coordinates/- Coordinateslibs/nyx/database/- Databaselibs/nyx/docs/- Docslibs/nyx/education/- Educationlibs/nyx/ephemeris/- Ephemerislibs/nyx/events/- Eventslibs/nyx/integrations/- Integrationslibs/nyx/lilith-integration/- Lilith Integrationlibs/nyx/mythology/- Mythologylibs/nyx/orbital/- Orbitallibs/nyx/positional/- Positionallibs/nyx/README.md- README.mdlibs/nyx/realtime/- Realtimelibs/nyx/renderer/- Rendererlibs/nyx/time/- Timelibs/nyx/time-travel/- Time Travellibs/nyx/types/- Typeslibs/nyx/utils/- Utilslibs/nyx/visualization/- Visualizationlibs/nyx/widgets/- Widgets
Services#
No repository entries discovered.
OpenAPI And Contract Roots#
No OpenAPI or domain-specific API root discovered.
Existing Standalone Domain Docs#
docs/domains/nyx/accuracy.md- Accuracy.mddocs/domains/nyx/api/- Apidocs/domains/nyx/architecture.md- Architecture.mddocs/domains/nyx/database.md- Database.mddocs/domains/nyx/developer-guide.md- Developer Guide.mddocs/domains/nyx/features.md- Features.mddocs/domains/nyx/README.md- README.mddocs/domains/nyx/service-catalog.md- Service Catalog.mddocs/domains/nyx/user-guide/- User Guidedocs/domains/nyx/user-stories.md- User Stories.md
Test And Verification Evidence#
testing/e2e/tests/nyx/star-map.browser.e2e.tstesting/e2e/tests/nyx/star-map.performance.e2e.tstesting/e2e/tests/nyx/star-map.visual.e2e.ts
Oshun Integration Summary#
| Reference Scope | Count |
|---|---|
| apps/oshun | 548 |
| libs/oshun | 221 |
Oshun-Specific Integration References#
apps/oshun/admin/.next/server/app/api/admin/workspaces/[workspaceId]/saved-views/route.jsapps/oshun/admin/.next/server/app/inbox/page.jsapps/oshun/admin/.next/server/app/incidents/page.jsapps/oshun/admin/.next/server/app/policy/page.jsapps/oshun/admin/.next/server/app/review/page.jsapps/oshun/admin/.next/static/chunks/app/inbox/page.jsapps/oshun/admin/.next/static/chunks/app/incidents/page.jsapps/oshun/admin/.next/static/chunks/app/policy/page.jsapps/oshun/admin/.next/static/chunks/app/review/page.jsapps/oshun/bff/README.mdapps/oshun/bff/openapi/oshun-bff.openapi.yamlapps/oshun/bff/src/__tests__/activity-route.test.tsapps/oshun/bff/src/__tests__/aggregation-response.test.tsapps/oshun/bff/src/__tests__/continue-route.test.tsapps/oshun/bff/src/__tests__/contract/shell-bff-contract.test.tsapps/oshun/bff/src/__tests__/contract/shell-bff-operations-contract.test.tsapps/oshun/bff/src/__tests__/cross-domain-recommendations-route.test.tsapps/oshun/bff/src/__tests__/customer-entitlement-feature-exposure.test.tsapps/oshun/bff/src/__tests__/domain-adapter-fixture.tsapps/oshun/bff/src/__tests__/domain-service-adapters.test.tsapps/oshun/bff/src/__tests__/domain-service-discovery.test.tsapps/oshun/bff/src/__tests__/domains-route.test.tsapps/oshun/bff/src/__tests__/feature-flags-route.test.tsapps/oshun/bff/src/__tests__/health-routes.test.tsapps/oshun/bff/src/__tests__/home-route.test.ts
Additional references omitted: 744
Documentation Gaps#
- Repository implementation roots are present and reflected above.
- Standalone domain docs exist and were folded into the evidence profile.
- Domain test evidence exists and is listed above.