{"id":13929116,"url":"https://github.com/davidje13/Refacto","last_synced_at":"2025-07-19T11:30:42.331Z","repository":{"id":151511256,"uuid":"171376585","full_name":"davidje13/Refacto","owner":"davidje13","description":"A remote retro facilitation tool.","archived":false,"fork":false,"pushed_at":"2024-12-22T02:54:05.000Z","size":7762,"stargazers_count":26,"open_issues_count":22,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-20T18:24:10.162Z","etag":null,"topics":["collaboration","retro","retrospective"],"latest_commit_sha":null,"homepage":"https://retro.davidje13.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davidje13.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-02-19T00:24:58.000Z","updated_at":"2025-04-06T11:34:16.000Z","dependencies_parsed_at":"2023-10-14T16:17:17.283Z","dependency_job_id":"576ceb68-ab78-49e8-8171-c2d8953b38f4","html_url":"https://github.com/davidje13/Refacto","commit_stats":{"total_commits":602,"total_committers":1,"mean_commits":602.0,"dds":0.0,"last_synced_commit":"cad1b6a7546d7997f56d45e4f15e783786441c23"},"previous_names":[],"tags_count":73,"template":false,"template_full_name":null,"purl":"pkg:github/davidje13/Refacto","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidje13%2FRefacto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidje13%2FRefacto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidje13%2FRefacto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidje13%2FRefacto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidje13","download_url":"https://codeload.github.com/davidje13/Refacto/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidje13%2FRefacto/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265926917,"owners_count":23850886,"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":["collaboration","retro","retrospective"],"created_at":"2024-08-07T18:02:07.722Z","updated_at":"2025-07-19T11:30:42.324Z","avatar_url":"https://github.com/davidje13.png","language":"TypeScript","funding_links":[],"categories":["others"],"sub_categories":[],"readme":"# Refacto\n\nA complete from-scratch re-write of\n[Postfacto](https://github.com/vmware-archive/postfacto), with a focus on\nsimplified code, development, and deployment.\n\n![Refacto](docs/screenshot.png)\n\n## Running locally\n\nRequires [Node.js 18 or above](https://nodejs.org/en/).\n\n```sh\nnpm start\n```\n\nThe site will be available at \u003chttp://localhost:5000/\u003e, using a mock\nGoogle authentication server and an in-memory database.\n\nSee [CONTRIBUTING.md](docs/CONTRIBUTING.md) for full guidance on local\ndevelopment.\n\n## Building for deployment\n\nYou can find pre-built releases at\n[Refacto/releases](https://github.com/davidje13/Refacto/releases),\nor you can build your own:\n\n```sh\nnpm run build\n```\n\nThe output is placed in `build`.\n\n## Deploying\n\nYou will need to have Node.js 18 or newer installed in the deployment\nenvironment.\n\n```sh\ncd build\nnpm install --omit=dev\n./index.js\n```\n\nBy default:\n\n- no authentication providers are available\n  (you will need to add at least one to use the service);\n- an in-memory database is used\n  (all data will be lost when the process ends);\n- blank secrets are used for encryption and password hashing\n  (you can use `./scripts/random-secrets.mjs` to generate a set of\n  secure random secrets for a deployment);\n- Giphy integration is not enabled;\n- haveibeenpwned integration _is_ enabled;\n- the server listens on port `5000`.\n\nSee [SERVICES.md](docs/SERVICES.md) and\n[SECURITY.md](docs/SECURITY.md) for details.\n\nThe full list of recognised configuration options (and their default\nvalues) can be found in\n[config/default.json](./backend/src/config/default.json)\n(nested properties are joined and written in `UPPER_SNAKE_CASE`).\n\nTypical values to configure are:\n\n```sh\nPORT=5000 \\\nSSO_GOOGLE_CLIENT_ID=\"\u003cyour-google-client-id\u003e\" \\\nSSO_GITHUB_CLIENT_ID=\"\u003cyour-github-client-id\u003e\" \\\nSSO_GITHUB_CLIENT_SECRET=\"\u003cyour-github-client-secret\u003e\" \\\nSSO_GITLAB_CLIENT_ID=\"\u003cyour-gitlab-client-id\u003e\" \\\nDB_URL=\"mongodb://localhost:27017/refacto\" \\\nGIPHY_API_KEY=\"\u003cyour-giphy-api-key\u003e\" \\\nTRUST_PROXY=\"false\" \\\nPASSWORD_WORK_FACTOR=10 \\\nPASSWORD_SECRET_PEPPER=\"\u003cvalue-from-random-secrets.mjs\u003e\" \\\nENCRYPTION_SECRET_KEY=\"\u003cvalue-from-random-secrets.mjs\u003e\" \\\nTOKEN_SECRET_PASSPHRASE=\"\u003cvalue-from-random-secrets.mjs\u003e\" \\\n./index.js\n```\n\n## Services\n\nSee the [services documentation](docs/SERVICES.md) for details on\nsetting up a database and integrating with authentication providers.\n\n## Extra security\n\nSee the [security documentation](docs/SECURITY.md) for details on\nconfiguring additional security for deployments.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidje13%2FRefacto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidje13%2FRefacto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidje13%2FRefacto/lists"}