{"id":50787638,"url":"https://github.com/vkrychun/stemjson","last_synced_at":"2026-06-12T09:01:30.453Z","repository":{"id":356557126,"uuid":"1188316437","full_name":"vkrychun/StemJSON","owner":"vkrychun","description":"Declarative JSON DSL for Native UI/UX, authored by humans or AI.","archived":false,"fork":false,"pushed_at":"2026-06-05T12:39:00.000Z","size":106,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-05T14:18:23.838Z","etag":null,"topics":["ai","backend-driven-ui","declarative-ui","dsl","ios","json-dsl","server-driven-ui","specification","stemjson","swiftui"],"latest_commit_sha":null,"homepage":"https://stemjson.com","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vkrychun.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-21T22:54:35.000Z","updated_at":"2026-06-05T12:39:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vkrychun/StemJSON","commit_stats":null,"previous_names":["vkrychun/stemjson"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/vkrychun/StemJSON","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vkrychun%2FStemJSON","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vkrychun%2FStemJSON/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vkrychun%2FStemJSON/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vkrychun%2FStemJSON/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vkrychun","download_url":"https://codeload.github.com/vkrychun/StemJSON/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vkrychun%2FStemJSON/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34236552,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","backend-driven-ui","declarative-ui","dsl","ios","json-dsl","server-driven-ui","specification","stemjson","swiftui"],"created_at":"2026-06-12T09:00:56.249Z","updated_at":"2026-06-12T09:01:30.429Z","avatar_url":"https://github.com/vkrychun.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# StemJSON\n\n*A Declarative JSON DSL for Native UI/UX — authored by humans or AI, delivered bundled or backend-driven, scaling from a single screen to complete flows.*\n\n---\n\nStemJSON, originated and authored by **Vasyl Krychun**, is a declarative language expressed in plain JSON. A StemJSON payload describes screens, UI trees, reactive state, and interaction flows; a runtime validates it, parses it into a component tree, and renders it as a native UI on the target platform. Payloads can be authored by developers or AI systems and delivered either bundled in an app or from a backend at runtime.\n\nThis repository hosts the normative specification, trademark policy, and brand assets. The language is licensed under the **Open Web Foundation Agreement 1.0 (OWFa 1.0)** — anyone may implement it in any language or on any platform, subject to the attribution requirement in [LICENSE §1.5](LICENSE).\n\n---\n\n## Specification\n\n| Edition | File | Use |\n|---|---|---|\n| Full specification (human-readable) | [`spec/v1.0.md`](spec/v1.0.md) | The authoritative normative document — prose, rationale, and worked examples. |\n| LLM reference (condensed) | [`spec/v1.0-ai.md`](spec/v1.0-ai.md) | Same normative surface, optimised for AI prompt use. Load this when instructing a language model to generate StemJSON. |\n\nBoth editions cover the same v1.0 normative language. The LLM edition is token-optimised — no prose, just the schemas, enums, and grammar tables a model needs to emit valid StemJSON.\n\n---\n\n## Implementations\n\n| Platform | Repository | Status |\n|---|---|---|\n| Apple (iOS, iPadOS) | [stem-runtime-swift](https://github.com/vkrychun/stem-runtime-swift) | Official. Native SwiftUI renderer. Proprietary binary SDK (separate license). |\n\nReference demos: [stem-examples-swift](https://github.com/vkrychun/stem-examples-swift) — runnable iOS apps whose features are authored in StemJSON and rendered via StemRuntimeSDK.\n\nIndependent implementations on other platforms are permitted under OWFa 1.0.\n\n---\n\n## Support and feedback\n\n| For | Channel |\n|---|---|\n| Spec clarifications (ambiguous wording, apparent contradictions) | Issues → *Spec clarification* template |\n| Improvement suggestions for v1.1+ | Discussions → *Proposals*, or Issues → *Improvement suggestion* |\n| Typos / editorial fixes | Issues → *Typo* template |\n| Questions about the spec | Discussions → Q\u0026A |\n| Licensing, commercial enquiries, trademark permission | vkrychun@stemjson.com |\n\n---\n\n## License\n\nThe specification documents in [`spec/`](spec/) are licensed under the [Open Web Foundation Agreement 1.0 (OWFa 1.0)](http://www.openwebfoundation.org/legal/the-owf-1-0-agreements/owfa-1-0). See [LICENSE](LICENSE) for the full terms and [NOTICE](NOTICE) for attribution requirements.\n\nYou MAY freely implement the StemJSON specification in any programming language, on any platform, for any purpose (commercial or non-commercial).\n\nYou MUST include the following attribution in a reasonably discoverable location within any product that implements the specification (e.g., README, about screen, third-party notices):\n\n\u003e *\"StemJSON specification created by Vasyl Krychun — https://stemjson.com\"*\n\nThe **StemRuntimeSDK** is a separate product distributed under its own proprietary End-User License Agreement. See [https://stemjson.com/sdk/license](https://stemjson.com/sdk/license) and the [stem-runtime-swift](https://github.com/vkrychun/stem-runtime-swift) repository for details.\n\n---\n\n## Trademarks\n\n\"StemJSON\", \"StemRuntimeSDK\", \"StemRuntime\", and the StemJSON logo are trademarks of Vasyl Krychun. The OWFa 1.0 license on the specification does not grant rights to use these marks. See [TRADEMARK_POLICY.md](TRADEMARK_POLICY.md) for permitted uses, restrictions, and how to request a trademark licence.\n\n---\n\n## Contact\n\n- **Specification author:** Vasyl Krychun\n- **Email:** vkrychun@stemjson.com\n- **Website:** https://stemjson.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvkrychun%2Fstemjson","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvkrychun%2Fstemjson","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvkrychun%2Fstemjson/lists"}