monorepo

A modern TypeScript monorepo with Nx, featuring automated releases, comprehensive code quality tools, and strict type safety.

🚀 Quick Start

💻 Local Setup (macOS, Recommended)

./scripts/local/setup.sh

🐳 Dev Container Setup

Install Docker Desktop, VSCode, and the Dev Containers extension, then open this repository and run the command Reopen in Container (it should prompt the command)

💽 Projects

• affirmations - Python LangChain + Ollama affirmation generator (LangGraph ReAct agent, SearxNG)
• caelundas - CLI ephemeris calendar generator with astronomical calculations
• conformance - Nx generators for scaffolding code
• infrastructure - Helm charts, Terraform, Kubernetes infrastructure
• JimmyPaolini - GitHub profile site
• lexico - TanStack Start dictionary web application
• lexico-components - Shared React component library using shadcn/ui
• lexico-entities - Shared TypeORM entities and GraphQL types package
• lexico-ingestion - NestJS CLI app for Latin dictionary data ingestion

📖 Documentation

Getting Started & Workflow

• Contributing Guide - Local setup, PR conventions, and workflows
• Tool Execution Model - When to use Nx vs. direct tooling
• Release Process - Automated semantic versioning and changelogs
• Troubleshooting Gotchas - Solutions to common environment and tooling issues

Architecture & Systems

• CI/CD Pipeline - GitHub Actions workflows
• Conformance Generators - Scaffolding code using Nx generators
• Static Analysis & Code Quality - Linting, formatting, and tests
• Deployment Models - Kubernetes, Helm, and infrastructure architecture
• Framework Guides - References for Kubernetes, NestJS, and LangChain Python

Conventions & Guidelines

• TypeScript / React / Python - Language standards
• Imports - Import sorting and module resolution
• Testing Strategy - Unit, integration, and E2E testing approaches
• Error Handling - Typed errors and boundary validations
• Context Engineering - Building AI-friendly context
• Gitmoji

🤖 Agent Skills (Domain Knowledge) Skills are specialized instruction files used by our automated agents, but they also serve as excellent deep-dive documentation for human developers.

• View all Skills - Complete index of available skills
• Workflows: Git Commits / PR Management / Branch Naming
• Tooling: Nx Workspaces / Generators / Task Running
• Infrastructure: Docker / Kubernetes / Terraform
• Domains: TanStack Start / Ephemeris Pipeline

Other important files include CHANGELOG.md and SECURITY.md.