{"id":20230252,"url":"https://github.com/jiayisheji/miracle","last_synced_at":"2026-04-10T12:32:02.079Z","repository":{"id":232618116,"uuid":"767856188","full_name":"jiayisheji/miracle","owner":"jiayisheji","description":"This is a typescript full-stack project. Use Nodejs, Nx, Nextjs, Nestjs, Angular, etc.","archived":false,"fork":false,"pushed_at":"2024-03-07T06:53:27.000Z","size":80,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-03T13:35:05.661Z","etag":null,"topics":["angular","fullstack","material-design","mysql","nestjs","nextjs","nx","pnpm","prisma","react","typeorm","typescript"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/jiayisheji.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2024-03-06T02:37:00.000Z","updated_at":"2024-03-07T06:53:31.000Z","dependencies_parsed_at":"2024-04-10T18:29:56.226Z","dependency_job_id":null,"html_url":"https://github.com/jiayisheji/miracle","commit_stats":null,"previous_names":["jiayisheji/miracle"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jiayisheji/miracle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiayisheji%2Fmiracle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiayisheji%2Fmiracle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiayisheji%2Fmiracle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiayisheji%2Fmiracle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jiayisheji","download_url":"https://codeload.github.com/jiayisheji/miracle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jiayisheji%2Fmiracle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31642749,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T07:40:12.752Z","status":"ssl_error","status_checked_at":"2026-04-10T07:40:11.664Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["angular","fullstack","material-design","mysql","nestjs","nextjs","nx","pnpm","prisma","react","typeorm","typescript"],"created_at":"2024-11-14T07:40:27.616Z","updated_at":"2026-04-10T12:32:02.038Z","avatar_url":"https://github.com/jiayisheji.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv id=\"top\"\u003e\u003c/div\u003e\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n\n[![Nx][nx-shield]][nx-url]\n[![NodeJs][nodejs-shield]][nodejs-url]\n[![Angular][angular-shield]][angular-url]\n[![NestJs][nestjs-shield]][nestjs-url]\n[![NextJs][nextjs-shield]][nextjs-url]\n[![Typescript][typescript-shield]][typescript-url]\n[![Mysql][mysql-shield]][mysql-url]\n[![JWT][jwt-shield]][jwt-url]\n[![Jest][jest-shield]][jest-url]\n[![Docker][docker-shield]][docker-url]\n\n# Miracle\n\nThis is a miracle project. Use Nodejs, Nx, Nextjs, Nestjs, Angular, etc.\n\n## Getting Start\n\n### Installing core dependencies\n\nBefore we start, we need to install:\n\n- [nodejs](https://nodejs.org/en/download/)\n\n\u003e Make sure we don't get any error after installation\n\nOpen our terminal and follow this instruction\n\nCheck NodeJs is successful installed in our OS.\n\n```sh\nnode --version\n\n# will return\n# v20.10.0\n```\n\n### Run with Docker\n\n1. We need to install `docker` and `docker compose`.\n\n- Docker official Documentation, [here][docker-url]\n- Docker Compose official Documentation, [here][docker-compose-url]\n\n2. Check `docker` is running or not\n\n```sh\ndocker --version\n\n# will return\n# Docker version 24.0.7, build afdd53b\n```\n\nand check `docker-compose`\n\n```sh\ndocker-compose --version\n\n# will return\n# Docker Compose version v2.23.3-desktop.2\n```\n\n3. Run docker compose\n\n```sh\ndocker-compose up -d\n```\n\n## Running the project\n\nThese instructions should be sufficient for one to get the project going on their local machine\n\n### Cloning the github repository\n\nTo clone the project, run\n\n```bash\ngit clone https://github.com/jiayisheji/miracle.git\n```\n\n### Installing the dependencies\n\nTo install the dependencies after you've cloned the project, go to its root folder and run\n\n```bash\ncd miracle \u0026\u0026 pnpm install --frozen-lockfile\n```\n\n### Setting environment variables\n\n```bash\ncp .env.example  .env\n```\n\n### Alternative commands\n\nIf you need to work on the client, you can run\n\n```bash\npnpm exec nx serve webapp\n```\n\nThen, you can go to the Angular dev server at port 4200 and test server requests (to port 3000), we got a proxy to the backend\n\nIf you only need to work on the frontend, you can run\n\n```bash\npnpm exec nx serve admin\n```\n\nAlternatively, if you only need to work on the backend, you can run\n\n```bash\npnpm exec nx serve api\n```\n\n## Reference\n\n1. Awesome Nest\n\n- [https://github.com/juliandavidmr/awesome-nest](https://github.com/juliandavidmr/awesome-nest)\n\n2. Awesome Next\n\n- [https://github.com/unicodeveloper/awesome-nextjs](https://github.com/unicodeveloper/awesome-nextjs)\n\n3. Awesome Angular\n\n- [https://github.com/PatrickJS/awesome-angular](https://github.com/PatrickJS/awesome-angular)\n\n4. Awesome Nx\n\n- [https://github.com/nrwl/nx-examples](https://github.com/nrwl/nx-examples)\n\n\u003cbr /\u003e\n\u003cp align=\"right\"\u003e\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e\u003c/p\u003e\n\n\u003c!-- BADGE LINKS --\u003e\n\n[contributors-shield]: https://img.shields.io/github/contributors/jiayisheji/miracle?style=for-the-badge\n[forks-shield]: https://img.shields.io/github/forks/jiayisheji/miracle?style=for-the-badge\n[stars-shield]: https://img.shields.io/github/stars/jiayisheji/miracle?style=for-the-badge\n[issues-shield]: https://img.shields.io/github/issues/jiayisheji/miracle?style=for-the-badge\n[license-shield]: https://img.shields.io/github/license/jiayisheji/miracle?style=for-the-badge\n[typescript-shield]: https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge\u0026logo=typescript\u0026logoColor=white\n[nodejs-shield]: https://img.shields.io/badge/Node.js-339933?style=for-the-badge\u0026logo=nodedotjs\u0026logoColor=white\n[jwt-shield]: https://img.shields.io/badge/JWT-000000?style=for-the-badge\u0026logo=JSON%20web%20tokens\u0026logoColor=white\n[jest-shield]: https://img.shields.io/badge/-jest-C21325?style=for-the-badge\u0026logo=jest\u0026logoColor=white\n[docker-shield]: https://img.shields.io/badge/docker-0db7ed.svg?style=for-the-badge\u0026logo=docker\u0026logoColor=white\n[nestjs-shield]: https://img.shields.io/badge/nestjs-E0234E.svg?style=for-the-badge\u0026logo=nestjs\u0026logoColor=white\n[nextjs-shield]: https://img.shields.io/badge/Nextjs-black?style=for-the-badge\u0026logo=vercel\u0026logoColor=white\n[angular-shield]: https://img.shields.io/badge/Angular-DD0031?style=for-the-badge\u0026logo=angular\u0026logoColor=white\n[mysql-shield]: https://img.shields.io/badge/MySQL-005C84?style=for-the-badge\u0026logo=mysql\u0026logoColor=white\n[nx-shield]: https://img.shields.io/badge/workspace-143157?style=for-the-badge\u0026logo=NX\u0026logoColor=white\n\n\u003c!-- GITHUB LINKS --\u003e\n\n[license-url]: https://github.com/jiayisheji/miracle/blob/main/LICENSE.md\n[issues-url]: https://github.com/jiayisheji/miracle/issues\n[stars-url]: https://github.com/jiayisheji/miracle/stargazers\n[forks-url]: https://github.com/jiayisheji/miracle/network/members\n[contributors-url]: https://github.com/jiayisheji/miracle/graphs/contributors\n\n\u003c!-- NEXTJS LINKS --\u003e\n\n[nextjs-url]: https://nextjs.org/\n\n\u003c!-- NESTJS LINKS --\u003e\n\n[nestjs-url]: http://nestjs.com/\n\n\u003c!-- ANGULAR LINKS --\u003e\n\n[angular-url]: https://angular.io/\n\n\u003c!-- OTHER LINKS --\u003e\n\n[nodejs-url]: https://nodejs.org/\n[nx-url]: https://nx.dev/\n[mysql-url]: https://docs.oracle.com/en-us/iaas/mysql-database/doc/getting-started.html\n[typescript-url]: https://www.typescriptlang.org/\n[jwt-url]: https://jwt.io\n[jest-url]: https://jestjs.io/docs/getting-started\n[docker-url]: https://docs.docker.com\n[docker-compose-url]: https://docs.docker.com/compose/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjiayisheji%2Fmiracle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjiayisheji%2Fmiracle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjiayisheji%2Fmiracle/lists"}