{"id":26103157,"url":"https://github.com/PreMiD/Activities","last_synced_at":"2025-03-09T20:02:39.090Z","repository":{"id":37246925,"uuid":"177561445","full_name":"PreMiD/Activities","owner":"PreMiD","description":"🛒 Storage for Activities located at our Activity Store.","archived":false,"fork":false,"pushed_at":"2025-02-28T08:15:32.000Z","size":46285,"stargazers_count":624,"open_issues_count":444,"forks_count":1347,"subscribers_count":32,"default_branch":"main","last_synced_at":"2025-02-28T15:11:59.661Z","etag":null,"topics":["discord","discord-activities","hacktoberfest","rich-presence","service","store","typescript"],"latest_commit_sha":null,"homepage":"https://premid.app/store","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PreMiD.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","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},"funding":{"github":"Timeraa","patreon":"Timeraa","ko_fi":"Timeraa"}},"created_at":"2019-03-25T10:10:50.000Z","updated_at":"2025-02-28T08:13:01.000Z","dependencies_parsed_at":"2023-10-20T22:39:00.806Z","dependency_job_id":"e8c6d564-8539-43aa-bc7c-84e99ee8bc66","html_url":"https://github.com/PreMiD/Activities","commit_stats":null,"previous_names":["premid/activities"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PreMiD%2FActivities","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PreMiD%2FActivities/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PreMiD%2FActivities/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PreMiD%2FActivities/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PreMiD","download_url":"https://codeload.github.com/PreMiD/Activities/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242335126,"owners_count":20110807,"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":["discord","discord-activities","hacktoberfest","rich-presence","service","store","typescript"],"created_at":"2025-03-09T20:02:36.231Z","updated_at":"2025-03-09T20:02:39.076Z","avatar_url":"https://github.com/PreMiD.png","language":"TypeScript","funding_links":["https://github.com/sponsors/Timeraa","https://patreon.com/Timeraa","https://ko-fi.com/Timeraa"],"categories":["TypeScript"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"https://avatars3.githubusercontent.com/u/46326568?s=400\u0026amp;u=15e4a4988014780288d30ffb969fd1569fec23e6\u0026amp;v=4\" width=\"128px\" style=\"max-width:100%;\"\u003e\n    \u003ch1\u003ePreMiD Activities\u003c/h1\u003e\n\u003c/div\u003e\n\nThis repository contains the source code of all Activities that are available in [PreMiD's Store](https://premid.app/store). Activities enhance your Discord presence by showing what you're doing on various websites.\n\n\u003cdiv align=\"left\"\u003e\n    \u003ca target=\"_blank\" href=\"https://discord.premid.app/\" title=\"Join our Discord!\"\u003e\n        \u003cimg  src=\"https://discordapp.com/api/guilds/493130730549805057/widget.png?style=banner2\" height=\"76px\" draggable=\"false\" alt=\"Join our Discord!\"\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n---\n\n## Getting Started\n\nWant to create your own Activity or modify an existing one? Great! Follow these simple steps:\n\n1. **Set up your development environment**\n\n   - Install [Node.js](https://nodejs.org/) (version 20 or higher)\n   - Clone this repository: `git clone https://github.com/PreMiD/Activities.git`\n   - Navigate to the project directory: `cd Activities`\n   - Install dependencies: `npm install`\n\n2. **Learn the basics**\n\n   - Read our [documentation](https://docs.premid.app/dev/presence) to understand how Activities work\n   - Browse through existing Activities to see examples and best practices\n\n3. **Start creating/editing**\n   - Use our CLI tool as described below to create and develop your Activity\n\n## CLI Commands\n\nThe repository includes a command-line tool (`pmd`) to help you create and develop Activities easily.\n\n### Creating a New Activity\n\nTo create a new Activity with all the necessary files and structure:\n\n```bash\nnpx pmd new my-activity-name\n```\n\nThis will guide you through a setup process, asking for basic information to generate the Activity structure.\n\n### Developing an Activity\n\nOnce you've created an Activity, you can develop it with live-reload functionality:\n\n```bash\nnpx pmd dev my-activity-name\n```\n\nThis command will:\n\n- Start a development server\n- Watch for changes in your Activity files\n- Automatically rebuild when you make changes\n- Validate your Activity against PreMiD standards\n\nUseful options:\n\n- `--validate`: Run additional validation checks for metadata, images, etc.\n\n## Testing Your Activity\n\nTo test your Activity:\n\n1. Install the [PreMiD Extension](https://premid.app/downloads) in your browser\n2. **Enable \"Activity Developer Mode\"** in the extension settings:\n   - Click on the PreMiD extension icon in your browser\n   - Go to settings (⚙️)\n   - Enable \"Activity Developer Mode\"\n3. Run the development command:\n   ```bash\n   npx pmd dev my-activity-name\n   ```\n4. The `pmd` tool will automatically send your Activity to the extension while in development mode\n5. Navigate to the website your Activity supports to see it in action\n6. Changes you make will be automatically picked up and sent to the extension\n\nThis development workflow allows you to see your changes in real-time without having to manually load the Activity each time you make a change.\n\n## Submitting Your Activity\n\nWhen your Activity is ready:\n\n1. Make sure it passes all validation checks\n2. Create a Pull Request to this repository\n3. Wait for a review from our maintainers\n\n## Committing\n\nThis repository strictly enforces the use of commitlint. For more information read the [Commit Convention guide](./.github/COMMIT_CONVENTION.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPreMiD%2FActivities","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPreMiD%2FActivities","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPreMiD%2FActivities/lists"}