{"id":39935450,"url":"https://github.com/peerigon/template","last_synced_at":"2026-01-18T18:34:43.621Z","repository":{"id":251349987,"uuid":"837124761","full_name":"peerigon/template","owner":"peerigon","description":"🚀 Boilerplate template to kick start new projects at Peerigon","archived":false,"fork":false,"pushed_at":"2025-12-12T10:47:49.000Z","size":421,"stargazers_count":2,"open_issues_count":2,"forks_count":2,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-12-13T23:36:17.307Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/peerigon.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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2024-08-02T09:09:23.000Z","updated_at":"2025-12-12T10:47:53.000Z","dependencies_parsed_at":"2025-03-09T23:18:53.852Z","dependency_job_id":"42013b71-6246-4ae1-ac08-3da55bf82e20","html_url":"https://github.com/peerigon/template","commit_stats":null,"previous_names":["peerigon/create-package","peerigon/template-package"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/peerigon/template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peerigon%2Ftemplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peerigon%2Ftemplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peerigon%2Ftemplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peerigon%2Ftemplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/peerigon","download_url":"https://codeload.github.com/peerigon/template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peerigon%2Ftemplate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28547292,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T14:59:57.589Z","status":"ssl_error","status_checked_at":"2026-01-18T14:59:46.540Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-01-18T18:34:43.000Z","updated_at":"2026-01-18T18:34:43.606Z","avatar_url":"https://github.com/peerigon.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# template\n\n**🚀 Boilerplate template to kick start new projects at Peerigon**\n\n## Getting Started\n\n### Option A: From a blank slate\n\n#### Step 1:\n\nFork this repository. This way the new repository will reference this repository as `upstream` and you will be able to easily pull in updates from this repository.\n\n#### Step 2:\n\nPrompt your AI coding assistant to customize the template project files:\n\n\u003cdetails\u003e\n\n```markdown\n# Customize Template Project Files\n\n## Information Gathering\n\nFirst, prompt the user for the following information:\n\n1. **Project name** (e.g., `my-awesome-project` or `@scope/package-name`)\n2. **Project description** (one-line summary of what the project does)\n3. **Keywords** (array of relevant keywords for package.json, can be empty)\n4. **Author/Organization** (e.g., `Peerigon`, `John Doe \u003cjohn@example.com\u003e`, or email)\n5. **License type** (e.g., `MIT`, `Apache-2.0`, `ISC`, `Unlicensed`, or `PROPRIETARY`)\n6. **Copyright holder** (name for LICENSE file, defaults to author/organization)\n\n## Files to Update\n\n### 1. package.json\n\nUpdate the following fields:\n\n- `name`: Replace `@peerigon/template` with the new project name\n- `version`: Consider resetting to `0.1.0` or `1.0.0` depending on project stage\n- `description`: Replace template description with actual project description\n- `keywords`: Update with relevant project keywords\n- `license`: Update license identifier (e.g., `MIT`, `Apache-2.0`, `UNLICENSED`)\n- `author`: Update with the actual author/organization\n\n### 2. README.md\n\n- Replace title with actual project name\n- Remove the emoji rocket and template description\n- Remove the \"Getting Started\" section about forking the template\n- Add project-specific description and usage instructions\n- Consider adding sections: Installation, Usage, Development, Contributing\n\n### 3. LICENSE\n\n- Update copyright year to current year (2025)\n- Update copyright holder name\n- If license type is not MIT, replace entire file contents with appropriate license text\n- If `UNLICENSED` or `PROPRIETARY`, either remove the file or replace with appropriate notice\n\n### 4. AGENTS.md\n\n- Note: `CLAUDE.md` is a symbolic link to `AGENTS.md`, so only `AGENTS.md` needs to be updated\n- Update \"Project Structure\" section if the actual project structure differs\n- Update \"Code Organization\" section with project-specific patterns\n- Keep the development commands and MCP tool instructions as-is\n\n### 5. Example Source Files\n\nThe `src/` directory contains example files (`add.ts`, `add.test.ts`, `main.ts`):\n\n- Keep them as reference examples per user preference\n- Note to user: these can be deleted once actual project code is implemented\n- They serve as examples of the testing and code organization patterns\n\n## Additional Considerations\n\n- Check if `package-lock.json` should be regenerated after package.json changes\n- Verify all tests still pass after changes: `npm test`\n```\n\n\u003c/details\u003e\n\n### Option B: With an already existing repository\n\n#### Step 1:\n\nPrompt your AI coding assistant to merge the template repository into your repository:\n\n\u003cdetails\u003e\n\n````markdown\n# Merge Template into Existing Project\n\n## Phase 1: Pre-Merge Information Gathering\n\nBefore starting the merge, collect information about the existing project:\n\n1. Read current `package.json` to extract:\n   - Project name\n   - Description\n   - Keywords\n   - Author/Organization\n   - License\n   - Current version\n\n2. Check for existing `LICENSE` file and note copyright holder\n\n3. Review existing source structure in `src/` directory\n\n## Phase 2: Execute Git Merge\n\nRun the merge command to bring in template changes:\n\n```bash\ngit remote add upstream https://github.com/peerigon/template.git\ngit fetch upstream\ngit merge --allow-unrelated-histories --strategy-option theirs --no-commit upstream/main\n```\n\nThis will:\n\n- Allow merging unrelated histories\n- Prefer template files in conflicts (`--strategy-option theirs`)\n- Stage changes without committing (`--no-commit`)\n\n## Phase 3: Restore Project Identity\n\nAfter merge, restore project-specific metadata:\n\n### package.json\n\n- Restore original `name`, `description`, `keywords`, `author`, `license`, `version`\n- Keep template's updated dependencies and scripts\n- Merge any custom scripts from original project\n\n### LICENSE\n\n- Restore original copyright holder and year\n- Keep original license type if different from MIT\n\n### README.md\n\n- Restore the original README.md\n- Add new commands from the `package.json` that haven't been mentioned yet\n\n### AGENTS.md\n\n- Update with project-specific structure and patterns\n- Keep template's MCP tool instructions\n\n## Phase 4: Handle Source Files\n\nDecide on treatment of `src/` directory:\n\n- Remove template example files (`add.ts`, `add.test.ts`) if project has real source\n- Keep template examples only if project is just starting\n\n## Phase 5: Verify and Clean Up\n\n1. Run `npm install` to update lockfile\n2. Run `npm test` to verify all changes work\n3. Review `git status` and `git diff --staged` for any unexpected changes\n4. Clean up any unwanted template artifacts\n\n## Phase 6: Staging\n\n**IMPORTANT**: Stage your changes, but **do not** commit any changes. Ask the user to review the changes.\n````\n\n\u003c/details\u003e\n\n## How to pull in updates from the upstream repository\n\nAsk your AI coding assistant to pull in updates from the upstream repository as mentioned in the [AGENTS.md](./AGENTS.md) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeerigon%2Ftemplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeerigon%2Ftemplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeerigon%2Ftemplate/lists"}