{"id":28941424,"url":"https://github.com/metosin/si-frame","last_synced_at":"2025-08-09T09:13:26.237Z","repository":{"id":271221357,"uuid":"912327839","full_name":"metosin/si-frame","owner":"metosin","description":"A fork of Re-frame, with the reactivity provided by Signaali","archived":false,"fork":false,"pushed_at":"2025-03-16T18:39:24.000Z","size":4525,"stargazers_count":21,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"no-siagent","last_synced_at":"2025-05-24T11:07:26.698Z","etag":null,"topics":["metosin-experimental","re-frame","signaali"],"latest_commit_sha":null,"homepage":"","language":"Clojure","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/metosin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"license.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.md","codeowners":null,"security":null,"support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-05T09:03:16.000Z","updated_at":"2025-04-16T11:17:59.000Z","dependencies_parsed_at":"2025-02-09T22:45:26.690Z","dependency_job_id":null,"html_url":"https://github.com/metosin/si-frame","commit_stats":null,"previous_names":["metosin/re-signaali","metosin/si-frame"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/metosin/si-frame","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metosin%2Fsi-frame","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metosin%2Fsi-frame/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metosin%2Fsi-frame/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metosin%2Fsi-frame/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/metosin","download_url":"https://codeload.github.com/metosin/si-frame/tar.gz/refs/heads/no-siagent","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metosin%2Fsi-frame/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261397487,"owners_count":23152492,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["metosin-experimental","re-frame","signaali"],"created_at":"2025-06-23T02:10:32.665Z","updated_at":"2025-08-09T09:13:26.230Z","avatar_url":"https://github.com/metosin.png","language":"Clojure","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Si-frame\n\n[![Clojars Project](https://img.shields.io/clojars/v/fi.metosin/si-frame.svg)](https://clojars.org/fi.metosin/si-frame)\n[![Slack](https://img.shields.io/badge/slack-signaali-orange.svg?logo=slack)](https://clojurians.slack.com/app_redirect?channel=signaali)\n[![cljdoc badge](https://cljdoc.org/badge/fi.metosin/si-frame)](https://cljdoc.org/d/fi.metosin/si-frame)\n\nThis project is a fork of [Re-frame `v1.4.3`](https://github.com/day8/re-frame/tree/v1.4.3) where\nthe reactivity is implemented using [Signaali](https://github.com/metosin/signaali)\nwithout [Reagent](https://github.com/reagent-project/reagent).\n\nIt was created:\n- to battle-proof Signaali's API before its release,\n- to demonstrate how Signaali could be used in future versions of Re-frame,\n- for Re-frame users who already use another React wrapper than Reagent and who want to try Signaali.\n\nProject status: [experimental](https://github.com/metosin/open-source/blob/main/project-status.md#experimental).\n\n## How well does it work?\n\n- The fork is working fine when tested on our own projects and on the port of Re-frame's examples.\n- The fork passes all the unit tests in the same way than the original, except for one test in `re-frame.flow.alpha-test`.\n  Because this feature is still \"alpha\", I didn't bother investigate but I suspect that the difference is due to\n  the expectation from Re-frame that the Reagent atoms are run eagerly while Signaali's reactive nodes are run lazily.\n\n## Ported Re-frame library\n\nThe namespaces were not modified, keep using it as if it was the original Re-frame project.\n\nWhat's different in the library:\n- Reagent was removed.\n- Some small changes were needed in `re-frame.interop` to making it work with Signaali.\n- `re-frame.interop/after-render` won't work exactly in the same way, but most apps don't use it.\n\n## How to use it in your Re-frame project\n\nIn your `deps.edn`, replace the re-frame dependencies with:\n\n```clojure\nfi.metosin/si-frame {:mvn/version \"1.4.3.0-no-siagent\"}\n```\n\nThis lib should work for you if you don't use Reagent in your code base.\n\n## UIx interop\n\nWe provide the extra namespace `re-frame.uix` for UIx users who need to use the subscriptions as React hooks.\n\nExample:\n```clojure\n(ns my-namespace\n  (:require [re-frame.uix :refer [use-subscribe]]\n            [uix.core :as uix :refer [$ defui]]))\n\n(defui my-component []\n  (let [user-display-name (use-subscribe [:user/display-name])]\n    ($ :div \"Hello \" user-display-name)))\n```\n\n## Will this be maintained?\n\n**Yes.**\n\nThe change compared to the Re-frame codebase is so small that it will probably be very easy\nto make a new release of this fork for any official release of Re-frame after the current `v1.4.3`.\n\nHowever, I do hope that in the future Re-frame can offer a customization mechanism for its reactivity\nsuch that no project fork is needed.\n\n## Feedback\n\nYour feedback is greatly appreciated and needed. Please let us know how was your experience with our fork\nin [![Slack](https://img.shields.io/badge/slack-signaali-orange.svg?logo=slack)](https://clojurians.slack.com/app_redirect?channel=signaali)\n\n---\n\nBelow this line is the original content of Re-frame's `README.md`.\n\n---\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://day8.github.io/re-frame\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\u003cimg src=\"docs/images/logo/re-frame-colour.png?raw=true\" alt=\"re-frame logo\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n## Derived Values, Flowing\n\n\u003e This, milord, is my family's axe. We have owned it for almost nine hundred years, see. Of course,\nsometimes it needed a new blade. And sometimes it has required a new handle, new designs on the\nmetalwork, a little refreshing of the ornamentation ... but is this not the nine hundred-year-old\naxe of my family? And because it has changed gently over time, it is still a pretty good axe,\ny'know. Pretty good.\n\n\u003e -- Terry Pratchett, The Fifth Elephant \u003cbr\u003e\n\u003e \u0026nbsp;\u0026nbsp;\u0026nbsp; reflecting on identity, flow and derived values  (aka [The Ship of Theseus](https://en.wikipedia.org/wiki/Ship_of_Theseus))\n\u003cbr/\u003e \n\u003cbr/\u003e\n\n\u003c!--\n[![CI](https://github.com/day8/re-frame/workflows/ci/badge.svg)](https://github.com/day8/re-frame/actions?workflow=ci)\n[![CD](https://github.com/day8/re-frame/workflows/cd/badge.svg)](https://github.com/day8/re-frame/actions?workflow=cd)\n[![License](https://img.shields.io/github/license/day8/re-frame.svg)](license.txt)\n--\u003e\n\n## Overview\n\nre-frame is a ClojureScript framework for building user interfaces.\nIt has a data-oriented, functional design. Its primary focus is on high programmer productivity and scaling up to larger Single-Page applications.\n\nDeveloped in late 2014, and released in 2015, it is mature and stable. It is used by both small startups and companies with over 500 developers, and it has delivered into production applications which are 40K lines of code and beyond. \n\nAcross the last 6 years, it has outlasted multiple generations of Javascript churn - just imagine your team's productivity if you didn't have to contend with technical churn, and have new magic burn your fingers every two years. Brand new, exciting concepts like recoiljs (in the React world), have been a regular part of re-frame from the beginning. \n\nre-frame is lucky enough to enjoy an unfair advantage - ClojureScript is a Lisp. Alan Kay\nonce described Lisp as \"Maxwell's equations of software\". Paul Graham \ndescribed how Lisp was a competitive advantage for his startup.  When we use Lisp, we \nget to leverage 50 years of foliated excellence from the very best minds available.\nAnd then there's also a thriving ClojureScript community which delivers modern ideas and best-in-class tooling.\n\nAlthough re-frame leverages React (via Reagent), it only needs \nReact to be the V in MVC, and no more. re-frame takes a different road to the currently-pervasive idea that Views should be causal (colocated queries, ComponentDidMount, hooks, etc).\nIn re-frame, events are causal, and views are purely reactive. \n\n## Documentation \n\nThe re-frame documentation is [available here](https://day8.github.io/re-frame/).\n\n\n## The Current Version \n\n[![Clojars Project](https://img.shields.io/clojars/v/re-frame?labelColor=283C67\u0026color=729AD1\u0026style=for-the-badge\u0026logo=clojure\u0026logoColor=fff)](https://clojars.org/re-frame)\n\nFor full dependency information, see the [Clojars page](https://clojars.org/re-frame/)\n\n## Getting Help \n\n[![Get help on Slack](http://img.shields.io/badge/slack-clojurians%20%23re--frame-97C93C?labelColor=283C67\u0026logo=slack\u0026style=for-the-badge)](https://clojurians.slack.com/channels/re-frame)\n\n## Licence\n\nre-frame is [MIT licenced](license.txt)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetosin%2Fsi-frame","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmetosin%2Fsi-frame","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetosin%2Fsi-frame/lists"}