{"id":18103825,"url":"https://github.com/simlf/area","last_synced_at":"2025-04-06T05:47:54.338Z","repository":{"id":65577722,"uuid":"584863216","full_name":"simlf/AREA","owner":"simlf","description":null,"archived":false,"fork":false,"pushed_at":"2023-03-06T08:32:33.000Z","size":37316,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-12T11:33:37.752Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/simlf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2023-01-03T17:56:15.000Z","updated_at":"2023-01-31T23:03:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"80ccd32d-bda5-439b-b88e-88280cb66832","html_url":"https://github.com/simlf/AREA","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simlf%2FAREA","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simlf%2FAREA/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simlf%2FAREA/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simlf%2FAREA/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simlf","download_url":"https://codeload.github.com/simlf/AREA/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247441006,"owners_count":20939235,"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":[],"created_at":"2024-10-31T22:13:15.331Z","updated_at":"2025-04-06T05:47:54.322Z","avatar_url":"https://github.com/simlf.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AREA\r\n\r\n\u003ca href=\"https://www.npmjs.com/~nestjscore\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/@nestjs/core.svg\" alt=\"NPM Version\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://www.npmjs.com/~nestjscore\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/npm/l/@nestjs/core.svg\" alt=\"Package License\" /\u003e\u003c/a\u003e\r\n\r\nAREA is an app that allows you to easily connect various services together, similar to IFTT. With AREA, you can automate tasks and streamline your workflow by creating custom \"recipes\" that link different services together.\r\n\r\n## Features\r\n\r\n-   Easy to use interface for creating and managing recipes\r\n-   Support for a wide variety of popular services such as Gmail, League of Legends, Twitter, etc.\r\n-   Triggers and actions can be customized to fit your specific needs\r\n-   Ability to chain multiple actions together to create complex recipes\r\n\r\n## Usage\r\n\r\n### Using Docker Compose\r\n\r\nThe project can be easily run using Docker Compose. To get started, make sure you have Docker and Docker Compose installed on your machine.\r\n\r\n1.  Build the Docker images: `docker-compose build`\r\n2.  Start the containers: `docker-compose up`\r\n3.  The web app will be running at [http://localhost:8001](http://localhost:8001/)\r\n\r\n#### Notes:\r\n\r\n- You may need to update the environment variables in the `docker-compose.yml` file to match your specific setup.\r\n\r\n- Every time you add a new package to your `package.json` file or make any changes to it or the `.env` file, please consider rebuilding the docker image using `docker-compose down \u0026\u0026 docker-compose up --build`.\r\n\r\n- To stop the containers, simply run `docker-compose down`.\r\n\r\n- You can also run the app in background by running `docker-compose up -d`.\r\n\r\n- To see the logs of the containers, use `docker-compose logs -f`.\r\n\r\n- You can change the ports exposed in the `docker-compose.yml` file.\r\n\r\n- To open the container inside your shell, you can run `docker exec -it myapp_backend sh`. But keep in mind that you won't be able to execute commands like `vim` or `emacs`.\r\n\r\n## Using Nest.js with NPM\r\n\r\nThe project is built with [Nest.js](https://nestjs.com/) and can be easily run with NPM. To get started, make sure you have Node.js and NPM installed on your machine.\r\n\r\n1.  Navigate to the server directory: `cd server`\r\n3.  Install the dependencies: `npm install`\r\n4.  Start the server: `npm run start`\r\n5.  The app will be running at [http://localhost:8000](http://localhost:8000/)\r\n\r\nTo run the app in development mode, use `npm run start:dev`.\r\n\r\nTo run the tests, use `npm run test`.\r\n\r\nYou can change the ports exposed in the `.env` file.\r\n\r\nMake sure you have the correct version of Node installed, check the `.nvmrc` or `.node-version` for the version.\r\n\r\n## Getting Started\r\n\r\n1.  Download and install the AREA app on your device\r\n2.  Sign in or create an account\r\n3.  Browse the available services and select the ones you want to use\r\n4.  Create a new recipe and select the trigger and action(s) you want to use\r\n5.  Save and activate your recipe\r\n\r\n## Examples of use\r\n\r\n-   Automatically send a tweet every time a new item is added to your RSS feed\r\n-   Send a text message to your phone when an email from a specific sender arrives in your inbox\r\n-   Automatically save attachments from specific emails to your cloud storage account\r\n\r\n## API Documentation\r\n\r\nYou can find the documentation when the project is running at this address [http://localhost:8080/swagger](http://localhost:8080/swagger).\r\n\r\nHere are the routes:\r\n\r\n/, GET route\r\n/about.json, GET route\r\n\r\n### Auth\r\n\r\n/auth/register, POST route\r\n/auth/login, POST route\r\n/auth/whoami, GET route\r\n/auth/discord, GET route\r\n/auth/discord/redirect, GET route\r\n\r\n### Workflows\r\n\r\n/workflows, GET route\r\n/workflowsDb/addWorkflow, POST route\r\n/workflowsDb/displayWorkflow, POST route\r\n/workflowsDb/displayAllWorkflow, GET route\r\n/workflowsDb/deleteWorkflow, POST route\r\n\r\n### GitHub\r\n\r\n/github, GET route\r\n/github/user, GET route\r\n/github/repo, GET route\r\n\r\n### League\r\n\r\n/league, GET route\r\n/league/profile, GET route\r\n/league/matches, GET route\r\n/league/rankone, GET route\r\n/league/challenges, GET route\r\n/league/statistics, GET route\r\n/league/mastery, GET route\r\n\r\n### Nasa\r\n\r\n/nasa, GET route\r\n/nasa/imageOfTheDay, GET route\r\n\r\n### Meteo\r\n\r\n/meteo, GET route\r\n/meteo/sendTemperature, GET route\r\n\r\n### Spotify\r\n\r\n/spotify, GET route\r\n/spotify/users/playlist, GET route\r\n/spotify/users/playlist/:playlistId, PUT route\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimlf%2Farea","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimlf%2Farea","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimlf%2Farea/lists"}