{
  "markdown": "<div align=\"center\">\n  <img src=\"apps/neural-site/public/neuralng-repository-banner.svg?v=3\" alt=\"NeuralNg — Interfaces for the agentic era\" width=\"100%\" />\n\n  <br />\n\n[![npm](https://img.shields.io/npm/v/@neural-ng/core?logo=npm&label=%40neural-ng%2Fcore)](https://www.npmjs.com/package/@neural-ng/core)\n[![Angular 22+](https://img.shields.io/badge/Angular-22%2B-DD0031?logo=angular)](https://angular.dev/)\n[![MIT](https://img.shields.io/badge/license-MIT-2563eb.svg)](./LICENSE)\n\n[Documentation](https://neuralng.dev) · [Installation](https://neuralng.dev/docs/installation) · [Components](https://neuralng.dev/docs/components) · [MCP server](https://neuralng.dev/docs/mcp-server) · [Contributing](./CONTRIBUTING.md)\n\n</div>\n\nNeuralNg is an Angular UI component system designed first for code-generating\nagents and fully usable by human developers. It combines standalone,\nSignal-native APIs with\nstrict types, accessible native semantics, SSR-safe behavior, headless styling\nand tree-shakable secondary entry points.\n\n> **Beta:** the current Core release is `0.1.0-beta.8`. Public APIs may change\n> before the first stable release.\n\n## Why NeuralNg?\n\n- **Agent-readable:** every public component ships focused README and `llms.txt`\n  context, while the MCP server exposes component discovery and theme tools.\n- **Angular-native:** standalone components, Signals, strict TypeScript, Angular\n  Forms integration and deterministic hydration.\n- **Accessible by contract:** native semantics, keyboard interaction, focus\n  behavior and accessible names are part of component acceptance.\n- **Style without lock-in:** use Neutral defaults, typed class slots, component\n  tokens or complete `unstyled` control.\n- **Package what you use:** import from dedicated secondary entry points for\n  predictable, tree-shakable builds.\n\n## Quick start\n\nInstall the component library and the framework-independent icon set:\n\n```bash\nnpm install @neural-ng/core @neural-ng/icons\n```\n\nLoad the icons and a bundled theme in your application styles:\n\n```css\n@import '@neural-ng/icons/icons.css';\n@import '@neural-ng/core/themes/neutral.css';\n```\n\nImport only the component entry points you need:\n\n```ts\nimport { Component } from '@angular/core';\nimport { NeuralButton } from '@neural-ng/core/button';\nimport { NeuralInput } from '@neural-ng/core/input';\n\n@Component({\n  selector: 'app-agent-form',\n  imports: [NeuralButton, NeuralInput],\n  template: `\n    <label for=\"agent-task\">Task</label>\n    <input neuralInput id=\"agent-task\" placeholder=\"Describe the task\" />\n    <neural-button label=\"Run agent\" icon=\"nt nt-sparkles\" />\n  `,\n})\nexport class AgentForm {}\n```\n\nSee the [installation guide](https://neuralng.dev/docs/installation)\nfor application configuration, theming and SSR setup.\n\n## Packages\n\n| Package                                                                        | Purpose                                                             | Current release |\n| ------------------------------------------------------------------------------ | ------------------------------------------------------------------- | --------------- |\n| [`@neural-ng/core`](https://www.npmjs.com/package/@neural-ng/core)             | 51 accessible Angular components, services, localization and tokens | `0.1.0-beta.8`  |\n| [`@neural-ng/editor`](https://www.npmjs.com/package/@neural-ng/editor)         | Structured, AI-native and collaboration-ready editor                | `0.1.0-beta.0`  |\n| [`@neural-ng/icons`](https://www.npmjs.com/package/@neural-ng/icons)           | 6,184 framework-independent `nt nt-*` CSS mask icons                | `0.1.0-beta.0`  |\n| [`@neural-ng/theme`](https://www.npmjs.com/package/@neural-ng/theme)           | Typed theme recipe compiler and Tailwind v4 bridge                  | `0.1.0-beta.5`  |\n| [`@neural-ng/mcp-server`](https://www.npmjs.com/package/@neural-ng/mcp-server) | Read-only component discovery and theme tooling for AI agents       | `0.1.0-beta.6`  |\n\n## AI-agent workflow\n\nNeuralNg keeps machine-readable context close to its public APIs. Agents can\nread the hosted [`llms.txt`](https://neuralng.dev/llms.txt), consume the package\ndocumentation beside each component, or connect the MCP server:\n\n```bash\nnpx @neural-ng/mcp-server\n```\n\nThe server supports bounded discovery and theme recipe operations without\ngranting write access to your application. See the\n[MCP guide](https://neuralng.dev/docs/mcp-server) for client setup and\navailable resources.\n\nAgent Skills-compatible clients can also install or upload the portable\n[`neuralng-angular` skill](./skills/neuralng-angular/SKILL.md). It teaches an\nagent to resolve versioned component contracts before generating Angular UI.\n\n## Theming\n\nNeutral is the recommended stable source contract. `@neural-ng/theme` expands a\ncompact `neural.theme.json` recipe into Core and Editor CSS, a Tailwind v4\nbridge, token interchange JSON and diagnostics:\n\n```bash\nnpm install --save-dev @neural-ng/theme\nnpx neural-theme init\nnpx neural-theme build\n```\n\nGlass, Futuristic and Mist remain experimental presets while the theme system\nis in beta. Use Neutral or `unstyled` for production-sensitive customization.\n\n## Repository map\n\n```text\napps/neural-site          Production documentation and landing application\napps/neural-site-e2e      Production-site Playwright coverage\napps/neural-demo          Component contract and regression laboratory\napps/neural-demo-e2e      Exhaustive interaction coverage\nlibs/neural-ng            @neural-ng/core source and component documentation\nlibs/neural-editor        @neural-ng/editor source\nlibs/neural-icons         @neural-ng/icons generator and assets\nlibs/neural-mcp           @neural-ng/mcp-server resources, tools and CLI\nlibs/neural-theme         Theme schema, token contract, compiler and CLI\ntemplates/neural-starter  Angular + Tailwind consumer template\ntools/neural-docs         Documentation contract and coverage verification\n```\n\n`neural-demo` is intentionally retained as a non-production regression\nlaboratory while its broader scenarios are migrated to `neural-site`. Public\ndocumentation belongs in `neural-site`.\n\n## Development\n\nUse Node 24 and npm 11:\n\n```bash\nnpm ci\nnpm run dev\n```\n\nBefore opening a pull request, run the relevant quality gates:\n\n```bash\nnpm run format:check\nnpm run lint\nnpm test\nnpm run build\nnpm run package:test\nnpm run docs:verify\nnpm run e2e:chromium\n```\n\nThe package smoke test packs generated npm artifacts and compiles a minimal\nexternal consumer. The MCP smoke test validates the published server over\nstdio, and documentation verification checks package-to-route contracts,\ninstallable examples and navigation coverage.\n\n## Contributing\n\nIssues, focused pull requests and documentation improvements are welcome. Read\n[CONTRIBUTING.md](./CONTRIBUTING.md) before starting. Report vulnerabilities\nprivately through the process in [SECURITY.md](./SECURITY.md).\n\n## Support the project\n\nIf NeuralNg saves you time, you can support its development by starring the\nrepository, sharing it, contributing fixes, or sponsoring ongoing work through\nthe **Sponsor** button at the top of the repository.\n\n## License\n\nNeuralNg is released under the [MIT License](./LICENSE).\n",
  "bytes": 7223,
  "sha": "21f8317c625f4897ec9c7b1cf1568558b065ba652fc1dda791212092b1eea907",
  "repo_slug": "hasanaydin7/neuraltech",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hasanaydin7_neuralng_143ae504/readme"
}