{"id":34729314,"url":"https://github.com/aditya-xq/weft-template","last_synced_at":"2026-04-19T22:34:33.395Z","repository":{"id":329675223,"uuid":"1119553822","full_name":"aditya-xq/weft-template","owner":"aditya-xq","description":"Template repo to setup and run the weft action","archived":false,"fork":false,"pushed_at":"2026-02-02T05:11:12.000Z","size":1907,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-02T16:45:35.687Z","etag":null,"topics":["automation","github-actions","twitter-automation","typescript","x-api"],"latest_commit_sha":null,"homepage":"","language":null,"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/aditya-xq.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-19T13:07:30.000Z","updated_at":"2026-02-02T05:11:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/aditya-xq/weft-template","commit_stats":null,"previous_names":["aditya-xq/weft-template"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/aditya-xq/weft-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya-xq%2Fweft-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya-xq%2Fweft-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya-xq%2Fweft-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya-xq%2Fweft-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aditya-xq","download_url":"https://codeload.github.com/aditya-xq/weft-template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aditya-xq%2Fweft-template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32025774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"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":["automation","github-actions","twitter-automation","typescript","x-api"],"created_at":"2025-12-25T02:55:30.433Z","updated_at":"2026-04-19T22:34:33.391Z","avatar_url":"https://github.com/aditya-xq.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Weft Quickstart Template\n\n![Latest Summary](out/summary.svg)\n\nThis repository is a **template** for setting up **Weft**, a GitHub Action that turns your GitHub activity into a visual summary and optionally publishes it to X (Twitter).\n\n**What Weft does**\n\n* Collects GitHub activity\n* Renders a clean visual snapshot\n* Publishes to X on a schedule or runs in preview mode\n\n---\n\n## Quickstart\n\n| Step | Action                                              |\n| ---- | --------------------------------------------------- |\n| 1    | Click **Use this template** to create your repo     |\n| 2    | Add required repository secrets                     |\n| 3    | Enable GitHub Actions and edit `config/default.yml` |\n\nOnce enabled, the daily/weekly workflow runs automatically.\n\n---\n\n## Required secrets\n\nAdd these under **Repository Settings → Secrets → Actions**. You can get them from your [X developer portal dashboard](https://developer.x.com/en/portal/dashboard)\n\n| Secret name         | Description                            |\n| ------------------- | -------------------------------------- |\n| `X_CONSUMER_KEY`    | X API consumer key                     |\n| `X_CONSUMER_SECRET` | X API consumer secret                  |\n| `X_ACCESS_TOKEN`    | X access token                         |\n| `X_ACCESS_SECRET`   | X access secret                        |\n\n**Preview only?**\nUse `config/dry-run.yml`. It disables publishing.\n\n---\n\n## Workflows included\n\n| File               | Purpose                                    |\n| ------------------ | ------------------------------------------ |\n| `daily-github.yml` | Scheduled daily run (03:30 UTC by default) |\n| `manual-run.yml`   | Manual preview and debugging               |\n\nBy default, workflows use:\n\n```yaml\nuses: aditya-xq/weft@main\n```\n\nYou can pin to a version tag when available.\n\n---\n\n## Configuration\n\nEdit `config/default.yml`.\n\n| Key                    | What to change            |\n| ---------------------- | ------------------------- |\n| `github.username`      | Your GitHub username      |\n| `runtime.timezone`     | Your local timezone       |\n| `time_window.duration` | Example: `24h`            |\n| `visual.theme`         | Colors and layout         |\n| `twitter.publish`      | Enable or disable posting |\n\nChanges apply on the next run.\n\n---\n\n## Dry runs and previews\n\nTwo ways to preview without publishing:\n\n1. Run **Manual / Preview: Weft** from the Actions tab\n   Select `config/dry-run.yml`\n2. Set `twitter.publish: false` in `config/default.yml`\n\nExpected outputs:\n\n* `out/summary.svg`\n* `out/summary.png`\n\n---\n\n## Recommended usage\n\n| Goal             | Recommendation           |\n| ---------------- | ------------------------ |\n| First-time setup | Start with `dry-run.yml` |\n| Public posting   | Enable `twitter.publish` |\n| Stability        | Pin to a tagged release  |\n| Privacy          | Keep publishing disabled |\n\n---\n\n## Troubleshooting\n\nIf a run fails, check the following:\n\n* All required secrets are present and valid\n* `github.username` is correct\n* The workflow logs in the Actions tab\n* Run the manual preview workflow for isolation\n\nMost failures are caused by missing secrets or incorrect usernames.\n\n---\n\n## Related project\n\nThis template uses the Weft action:\n\n* [https://github.com/aditya-xq/weft](https://github.com/aditya-xq/weft)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faditya-xq%2Fweft-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faditya-xq%2Fweft-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faditya-xq%2Fweft-template/lists"}