{"id":15068903,"url":"https://github.com/domix/wonky","last_synced_at":"2025-07-26T01:06:02.334Z","repository":{"id":42171384,"uuid":"39347965","full_name":"domix/wonky","owner":"domix","description":"Slack made easy for orgs","archived":false,"fork":false,"pushed_at":"2025-04-21T11:02:06.000Z","size":957,"stargazers_count":30,"open_issues_count":19,"forks_count":9,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-20T09:10:21.146Z","etag":null,"topics":["codecov","java11","java8","micronaut","micronautfw","slack"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/domix.png","metadata":{"files":{"readme":"README.md","changelog":"History.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2015-07-19T20:31:48.000Z","updated_at":"2025-01-27T15:26:58.000Z","dependencies_parsed_at":"2024-05-13T18:59:20.500Z","dependency_job_id":"e8ac7a43-ecce-4037-8212-504ee87cf878","html_url":"https://github.com/domix/wonky","commit_stats":{"total_commits":623,"total_committers":3,"mean_commits":"207.66666666666666","dds":"0.020866773675762396","last_synced_commit":"9d34c145806d1b8ca323f8831f3cf53088c173f5"},"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/domix/wonky","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domix%2Fwonky","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domix%2Fwonky/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domix%2Fwonky/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domix%2Fwonky/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/domix","download_url":"https://codeload.github.com/domix/wonky/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/domix%2Fwonky/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267096481,"owners_count":24035381,"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-07-25T02:00:09.625Z","response_time":70,"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":["codecov","java11","java8","micronaut","micronautfw","slack"],"created_at":"2024-09-25T01:39:40.935Z","updated_at":"2025-07-26T01:06:02.289Z","avatar_url":"https://github.com/domix.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wonky\n[![Build Status](https://travis-ci.org/domix/wonky.svg)](https://travis-ci.org/domix/wonky)\n[![codecov.io](http://codecov.io/github/domix/wonky/coverage.svg?branch=master)](http://codecov.io/github/domix/wonky?branch=master)\n\n\nWonky is a port of [slacking](https://github.com/rauchg/slackin/), to the JVM written in `Java` and [Micronaut](http://micronaut.io/).\n\n## Features\n\n- A landing page you can point users to fill in their emails and receive an invite (`http://slack.yourdomain.com`)\n\n## Build\n\nDocker Engine\n\n### Requirements\n\n[![\"JDK\"](https://img.shields.io/badge/JDK-8.0+-F30000.svg?style=flat)](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)\n\n### Slack token\n\nTo build \u0026 run wonky you need a `Slack API token`. Note that the user you use to generate the token must be an admin. You may want to create a dedicated @wonky-inviter user (or similar) for this.\n\nYou can find your API token [here](http://api.slack.com/web)\n\nOnce you have the token, you need to write the `configuration file`.\n\n#### Configuration file\n\nThe configuration file is very simple to write, it's a `YAML`.\n\n##### Single Slack organization\n\n```YAML\n- !!wonky.service.SlackOrganization\n  token: \"xoxp-...\"\n  wonkyDomain: \"localhost:8080\"\n```\n\n*NOTE:* Wonky supports multiple organizations (aka multitenancy), Wonky will use the domain (HOST http header) to select the right token. Consider this.\n\n##### Multiple Slack organizations\n\n```YAML\n- !!wonky.service.SlackOrganization\n  token: \"xoxp-...\"\n  wonkyDomain: \"localhost:8080\"\n- !!wonky.service.SlackOrganization\n  token: \"xoxp-...\"\n  wonkyDomain: \"slack.myorganization.com\"\n``` \n\n##### Recomendation\n\nWe strongly recommend you write and name the config file as `orgs_ignored.yaml` and save it to the root source of wonky, in git is marked as ignored.  \n\n#### Environment variables\n\nIn order to run properly the test, you have to provide the following `Environment Variables`;\n\n* WONKY_TENANTS_FILE\n* WONKY_TEST_EMAIL_PREFIX\n\nYou can configued as follows in the shell:\n\n````bash\n$ export WONKY_TENANTS_FILE=./orgs_ignored.yaml\n$ export WONKY_TEST_EMAIL_PREFIX=something\n\n````\n\nNow you can build wonky from source :)\n\n## Building from source\n\n```bash\n$ ./gradlew clean build\n```\n\n## Run\n\nBy default wonky runs on port `8080`, as any `Micronaut` application you can chance the port as you wish.\n\n\n```bash\n$ ./gradlew run  \n```\n\nAlternatively, you can run Wonky with Docker as a container:\n\n\n```bash\n$ docker run --rm -p 8080:8080 -v `pwd`/orgs_ignored.yaml:/etc/wonky/tenants.yaml  domix/wonky:0.3.7\n```\n\n### Communities using Wonky\n\n- [The Data Pub](http://slack.thedata.pub)\n- [JavaMexico.org](http://slack.javamexico.org)\n- [SpringHispano.org](http://slack.springhispano.org)\n- [Groovyando.org](http://slack.groovyando.org)\n- [JavaHispano.org](http://slack.javahispano.org)\n\n### Development badges\n\n![codecov.io](http://codecov.io/github/domix/wonky/branch.svg?branch=master)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdomix%2Fwonky","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdomix%2Fwonky","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdomix%2Fwonky/lists"}