{"id":19371641,"url":"https://github.com/braziljs/newsletter-tool","last_synced_at":"2025-04-23T16:31:16.760Z","repository":{"id":46940390,"uuid":"151338737","full_name":"braziljs/newsletter-tool","owner":"braziljs","description":"BrazilJS' newsletter tool","archived":false,"fork":false,"pushed_at":"2023-01-04T14:29:27.000Z","size":1267,"stargazers_count":35,"open_issues_count":19,"forks_count":11,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-04-14T15:46:12.809Z","etag":null,"topics":["braziljs","github","javascript","newsletter"],"latest_commit_sha":null,"homepage":null,"language":"HTML","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/braziljs.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2018-10-02T23:50:51.000Z","updated_at":"2022-10-16T08:56:17.000Z","dependencies_parsed_at":"2023-02-02T15:49:34.704Z","dependency_job_id":null,"html_url":"https://github.com/braziljs/newsletter-tool","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/braziljs%2Fnewsletter-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/braziljs%2Fnewsletter-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/braziljs%2Fnewsletter-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/braziljs%2Fnewsletter-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/braziljs","download_url":"https://codeload.github.com/braziljs/newsletter-tool/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223927974,"owners_count":17226641,"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":["braziljs","github","javascript","newsletter"],"created_at":"2024-11-10T08:19:23.372Z","updated_at":"2024-11-10T08:19:23.447Z","avatar_url":"https://github.com/braziljs.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Newsletter Tool\nThe __BrazilJS Weekly Newsletter__ is one of the best Brazilian resources to keep up-to-date with technology in general, specially Web Technologies.  \nEvery week, more than 15,000 developers get the latest and more relevant news, tools, articles, etc., in their inboxes.  \nBrazilJS crew is responsible for the curatorship and review, but the main content feed come from the community.  \nEverything is done in our [BrazilJS Weekly repository](https://github.com/braziljs/weekly), where people can share all kinds of content.  \nAfter that, it's time to filter what is going to be listed in our newsletter by reading the content and validating every single suggestion.  \nThat's our secret, we do love to be up-to-date and we care about great content, so we make sure that every sent email is carefully handcrafted by our editors.  \nThat's a hard but necessary work.  \nHowever, that's a lot of steps in this process which can be automated, and with that in mind, we created this tool.  \n\nThe `newsletter-tool` aims to help BrazilJS' editors.  \nHere are some key steps done every single week to build our beloved newsletter:\n\n- Create a new campaign (normally a copy of the last one) on [Mailchimp](https://mailchimp.com/) (the service we use to create and send the newsletter)  \n- Sort in categories (normally *news*, *articles*, *tools* and *others*)  \n- Sort the content by relevance  \n- Insert each link on the campaign email template \n- Review\n\nThat's just the main steps 😓  \nAs we have a video version of the newsletter ([BrazilJS Weekly on YouTube](https://www.youtube.com/braziljs)) and a text version on [BrazilJS' portal](https://braziljs.org/), which one with a different approach, the task could be tedious.  \n\nThe `Newsletter Tool` is basically a JavaScript piece of software automation tool.  \nOf course, the tool is focused on solving our own problems and is 100% based on our community-curatorship process, but we strong believe in this model, so every Newsletter owner can try to adapt to it and use and evolve the tool.\n\n# How to run\n```javascript\nnpm install\nnpm start\n```\nGo to `http://localhost:8080/` and you should see a simulated newsletter based on our last open issue on the BrazilJS Weekly repository.  \n\n![BrazilJS Weekly Tool in action](https://i.imgur.com/GpToL45.png)\n  \nIf you use the vscode you need to install the `Prettier - Code formatter` extension to respect the `.prettierrc` file, you can install this extension with the following command: `ext install prettier-vscode`.  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbraziljs%2Fnewsletter-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbraziljs%2Fnewsletter-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbraziljs%2Fnewsletter-tool/lists"}