{"id":28458133,"url":"https://github.com/jolicode/starfleet","last_synced_at":"2025-07-06T16:01:58.812Z","repository":{"id":29347036,"uuid":"121412232","full_name":"jolicode/starfleet","owner":"jolicode","description":":rocket: Share your conferences activity to your buddies","archived":true,"fork":false,"pushed_at":"2024-03-29T12:33:30.000Z","size":3418,"stargazers_count":20,"open_issues_count":33,"forks_count":3,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-06-07T00:09:47.331Z","etag":null,"topics":["bot","cfp","conferences","slack"],"latest_commit_sha":null,"homepage":"https://starfleet.app/","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":"CHANGELOG.md","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":"2018-02-13T17:22:38.000Z","updated_at":"2025-03-06T16:44:39.000Z","dependencies_parsed_at":"2024-02-08T17:55:33.981Z","dependency_job_id":null,"html_url":"https://github.com/jolicode/starfleet","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jolicode/starfleet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fstarfleet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fstarfleet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fstarfleet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fstarfleet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jolicode","download_url":"https://codeload.github.com/jolicode/starfleet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2Fstarfleet/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263081278,"owners_count":23410841,"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":["bot","cfp","conferences","slack"],"created_at":"2025-06-07T00:10:03.385Z","updated_at":"2025-07-02T05:31:30.234Z","avatar_url":"https://github.com/jolicode.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://starfleet.jolicode.com/build/images/logo.svg\" width=100 height=100 alt=\"Starfleet logo\" /\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003eStarfleet\u003c/h1\u003e\n\n\u003e Share your conferences activity to your buddies\n\n### Requirements\n\nA Docker environment is provided and requires you to have these tools available:\n\n* Docker\n* Bash\n* PHP \u003e= 8.1\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- PostgreSQL\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 (like docker-machine for example).\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 local.starfleet.app' | sudo tee -a /etc/hosts\n```\n\n### Starting the stack\n\nLaunch the stack by running this command:\n\n```bash\ncastor start\n```\n\n\u003e Note: 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\nHTTPS is supported out of the box. SSL certificates are not versioned and will\nbe generated the first time you start the infrastructure (`castor start`) or if\nyou run `castor infra:generate-certificates`.\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## Usage\n\nBy default, the fetchers are not configured and won't fetch anything. You first need to head to the admin and configure them in the `fetcher` menu, then you can run `inv fetch-conferences`.\n\nIf you want to add a source, you only have to implement the `FetcherInterface`.\n\nSome fetchers will use tags to fetch their data, and some of these tags may be missing. If this is the case, you should find the fetcher in `src\\Fetcher` and add the missing tag to its tags list.\n\n## Slack\n\nStarfleet uses strong integration with Slack as it sends daily Slack notifications. You must [create a Slack application](https://api.slack.com/apps) if you don't have any.\nYou need to configure a webhook at `https://[your-slack-organization].slack.com/apps/A0F7XDUAZ-incoming-webhooks` and add it to the `SLACK_WEB_HOOK_URL` env variable.\nSince Starfleet uses user interaction, you must configure your application at to allow user interaction. You may see how to do it at `https://api.slack.com/interactivity/handling#setup`. Your Slack Signing Secret should be stored in the `SLACK_SIGNING_SECRET` env variable.\nDuring dev, you may use [Ngrok](https://ngrok.com/) to let Slack reach your application. We provide a command to start Ngrok : `inv ngrok`. Paste the resulting address in your Slack app `Request URL` field.\n\n## Map\n\nWe provide you with the possibility of adding a map with a marker on every location you and your team attended a conference. If you want to enable this feature, you need to create an account at [Mapbox](https://www.mapbox.com/). You then need to retrieve your API Token and add it to your `.env` file, by replacing the default value of the `MAPBOX_TOKEN` variable.\n\n## Translations\n\nTo add easily add new translations, please install and use [i18n-ally](https://plugins.jetbrains.com/plugin/17212-i18n-ally).\n\n## Changes\n\nView the [CHANGELOG](CHANGELOG.md) file attached to this project.\n\n## Sponsor\n\n[![JoliCode](https://jolicode.com/images/logo.svg)](https://jolicode.com)\n\nOpen Source time sponsored by JoliCode\n\n## Credits\n\n* [All contributors](https://github.com/jolicode/starfleet/graphs/contributors)\n\n## License\n\nView the [LICENSE](LICENSE) file attached to this project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjolicode%2Fstarfleet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjolicode%2Fstarfleet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjolicode%2Fstarfleet/lists"}