{"id":13519010,"url":"https://github.com/jolicode/secret-santa","last_synced_at":"2026-03-11T04:31:27.552Z","repository":{"id":37977117,"uuid":"45856040","full_name":"jolicode/secret-santa","owner":"jolicode","description":"🎅 The code behind Secret Santa, the holiday bot for Slack / Discord / Webex","archived":false,"fork":false,"pushed_at":"2026-01-28T22:07:18.000Z","size":12148,"stargazers_count":218,"open_issues_count":30,"forks_count":19,"subscribers_count":19,"default_branch":"main","last_synced_at":"2026-01-29T07:25:34.531Z","etag":null,"topics":["discord","discord-bot","hacktoberfest","happyness","secret-santa","slack","slack-blockkit","slack-bot","symfony","symfony-flex","webex"],"latest_commit_sha":null,"homepage":"https://secret-santa.team/","language":"PHP","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/jolicode.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,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2015-11-09T17:55:07.000Z","updated_at":"2026-01-28T22:07:21.000Z","dependencies_parsed_at":"2023-02-17T10:16:02.358Z","dependency_job_id":"7253fa72-4009-4c51-9238-1b550f13833e","html_url":"https://github.com/jolicode/secret-santa","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jolicode/secret-santa","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fsecret-santa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fsecret-santa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fsecret-santa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fsecret-santa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jolicode","download_url":"https://codeload.github.com/jolicode/secret-santa/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fsecret-santa/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30370797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T21:41:54.280Z","status":"online","status_checked_at":"2026-03-11T02:00:07.027Z","response_time":84,"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":["discord","discord-bot","hacktoberfest","happyness","secret-santa","slack","slack-blockkit","slack-bot","symfony","symfony-flex","webex"],"created_at":"2024-08-01T05:01:52.221Z","updated_at":"2026-03-11T04:31:27.535Z","avatar_url":"https://github.com/jolicode.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003ca href=\"https://github.com/jolicode/secret-santa\"\u003e\u003cimg src=\"https://jolicode.com/media/original/oss/headers/secret-santa.png\" alt=\"Secret Santa\"\u003e\u003c/a\u003e\n  \u003cbr /\u003e\n  Secret Santa\n  \u003cbr /\u003e\n  \u003csub\u003e\u003cem\u003e\u003ch6\u003eAn application to organize Secret Santa with your Slack / Discord / Webex teams.\u003c/h6\u003e\u003c/em\u003e\u003c/sub\u003e\n\u003c/h1\u003e\n\n# About the project\n\nJust go to https://secret-santa.team/ and have fun.\n\nCode source is under MIT License.\n\n- This application is powered by Symfony;\n- Hosting is provided by [Clever Cloud](https://www.clever-cloud.com/);\n- Built with ♥ by [@pyrech](https://github.com/pyrech) and [@damienalexandre](https://github.com/damienalexandre).\n\n## Running the application locally\n\n### Requirements\n\nA Docker environment is provided and requires you to have these tools available:\n\n* Docker\n* Bash\n* [Castor](https://github.com/jolicode/castor#installation)\n\n#### Castor\n\nOnce castor is installed, in order to improve your usage of castor scripts, you\ncan install console autocompletion script.\n\nIf you are using bash:\n\n```bash\ncastor completion | sudo tee /etc/bash_completion.d/castor\n```\n\nIf you are using something else, please refer to your shell documentation. You\nmay need to use `castor completion \u003e /to/somewhere`.\n\nCastor supports completion for `bash`, `zsh` \u0026 `fish` shells.\n\n### Docker environment\n\nThe Docker infrastructure provides a web stack with:\n- NGINX\n- Redis\n- PHP\n- Traefik\n- A container with some tooling:\n  - Composer\n  - Node\n  - Yarn / NPM\n\n### Domain configuration (first time only)\n\nBefore running the application for the first time, ensure your domain names\npoint the IP of your Docker daemon by editing your `/etc/hosts` file.\n\nThis IP is probably `127.0.0.1` unless you run Docker in a special VM (docker-machine, dinghy, etc).\n\nNote: The router binds port 80 and 443, that's why it will work with `127.0.0.1`\n\n```\necho '127.0.0.1 secret-santa.test' | sudo tee -a /etc/hosts\n```\n\nUsing dinghy? Run `dinghy ip` to get the IP of the VM.\n\n### Env vars configuration (first time only)\n\nWe rely on some env variables to configure how to communicate with various\nAPI's and Redis.\n\nCopy the content of the file `.env` into a new `.env.local` (which will be\nignored by git) and fill the missing vars with correct values.\n\n### Starting the stack\n\nLaunch the stack by running this command:\n\n```bash\ncastor start\n```\n\n\u003e [!NOTE]\n\u003e the first start of the stack should take a few minutes.\n\nThe site is now accessible at the hostnames your have configured over HTTPS\n(you may need to accept self-signed SSL certificate if you do not have mkcert\ninstalled on your computer - see below).\n\n### SSL certificates\n\nThis stack no longer embeds self-signed SSL certificates. Instead they will be\ngenerated the first time you start the infrastructure (`castor start`) or if you\nrun `castor infra:generate-certificates`. So *HTTPS will work out of the box*.\n\nIf you have `mkcert` installed on your computer, it will be used to generate\nlocally trusted certificates. See [`mkcert` documentation](https://github.com/FiloSottile/mkcert#installation)\nto understand how to install it. Do not forget to install CA root from mkcert\nby running `mkcert -install`.\n\nIf you don't have `mkcert`, then self-signed certificates will instead be\ngenerated with openssl. You can configure [infrastructure/docker/services/router/openssl.cnf](infrastructure/docker/services/router/openssl.cnf)\nto tweak certificates.\n\nYou can run `castor infra:generate-certificates --force` to recreate new certificates\nif some were already generated. Remember to restart the infrastructure to make\nuse of the new certificates with `castor up` or `castor start`.\n\n### Builder\n\nHaving some composer, yarn or other modifications to make on the project?\nStart the builder which will give you access to a container with all these\ntools available:\n\n```bash\ncastor builder\n```\n\n### Other tasks\n\nCheckout `castor` to have the list of available tasks.\n\n\u003cbr\u003e\u003cbr\u003e\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://jolicode.com/\"\u003e\u003cimg src=\"https://jolicode.com/media/original/oss/footer-github.png?v3\" alt=\"JoliCode is sponsoring this project\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjolicode%2Fsecret-santa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjolicode%2Fsecret-santa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjolicode%2Fsecret-santa/lists"}