{"id":29894177,"url":"https://github.com/juxt/home-apps","last_synced_at":"2025-08-01T04:45:39.571Z","repository":{"id":42900744,"uuid":"458599925","full_name":"juxt/home-apps","owner":"juxt","description":"Monorepo for SPAs that use home.juxt.site as a backend","archived":false,"fork":false,"pushed_at":"2023-01-06T15:12:57.000Z","size":2863,"stargazers_count":2,"open_issues_count":6,"forks_count":1,"subscribers_count":32,"default_branch":"main","last_synced_at":"2025-07-29T14:44:59.510Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/juxt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-12T18:02:21.000Z","updated_at":"2024-10-06T07:51:33.000Z","dependencies_parsed_at":"2023-02-06T05:47:01.181Z","dependency_job_id":null,"html_url":"https://github.com/juxt/home-apps","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/juxt/home-apps","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Fhome-apps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Fhome-apps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Fhome-apps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Fhome-apps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juxt","download_url":"https://codeload.github.com/juxt/home-apps/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juxt%2Fhome-apps/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268171719,"owners_count":24207417,"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","status":"online","status_checked_at":"2025-08-01T02:00:08.611Z","response_time":67,"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":[],"created_at":"2025-08-01T04:45:34.441Z","updated_at":"2025-08-01T04:45:39.446Z","avatar_url":"https://github.com/juxt.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"Monorepo for internal JUXT apps\n\nThis monorepo uses [NX](https://nx.dev) to manage packages, builds, tests and development servers. It is a little complex (like a lot of js tools), but it allows very easy reuse of frontend components such as the generated site hooks.\n\nIt is recommended to install the NX vscode extension which saves you from remembering all the difference commands (generating new projects, testing, running, building etc).\n\nThere are two parts to developing one of these apps, the 'backend' and the frontend. The frontend can use any build system (clojurescript/etc) but NX built in tooling will use webpack and babel. The backend uses [Site](https://github.com/juxt/site) which generates a graphql API given a schema file. The same schema file is also used to generate react-hooks using graphql-code-generator and react-query.\n\n## Initial Setup\n\nFirst run `yarn` from the root of the project. This will install all the dependencies and may take a while. Then run `yarn` from any directory with its own package.json (currently /libs/site and /apps/photography-guild).\n\n## Running a Frontend app\n\nThe basic command for running any frontend app is `yarn nx run {APP_NAME}:serve` where {APP_NAME} is the name of the app. For example `yarn nx run photography-guild:serve`.\n\n## Backend (changing the schema/generated graphql hooks)\n\nYou can either use the schema file in libs/site or make your own (see the photography app for an example of that). But if you want to make changes to the schema, you'll need to run the schema watcher script for the schema you are using. For example, in the photography app directory, run (after running `yarn` to install the dependencies):\n\n```\nyarn prod-generate\n```\n\nwhich will build react hooks for each 'operation' in operations.graphql as well as deploying the schema to the remote Site server when you edit the file.\n\nIf you have a local Site server running, see if there is a `dev-generate` command in the `package.json` file. If not you should be able to figure it out as its just a case of updating the domain from the prod example.\n\n## Full process to develop the hiring app\n\nFirst install [Site](https://github.com/juxt/site)\n\n```\ngit clone https://github.com/juxt/site.git\ncd site\nmkdir -p $HOME/.config/site\ncp etc/config.edn $HOME/.config/site/config.edn\nbin/site-server\n\n(new terminal window)\n\nrlwrap ncat localhost 50505\n(init! \"admin\" \"admin\")\nctrl-c\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuxt%2Fhome-apps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuxt%2Fhome-apps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuxt%2Fhome-apps/lists"}