{"id":30619083,"url":"https://github.com/is-a-software/is-a-software","last_synced_at":"2025-08-30T12:17:05.670Z","repository":{"id":312036934,"uuid":"1040260500","full_name":"is-a-software/is-a-software","owner":"is-a-software","description":"Free .is-a.software subdomain for developers","archived":false,"fork":false,"pushed_at":"2025-08-28T05:29:15.000Z","size":32,"stargazers_count":11,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-28T12:04:56.301Z","etag":null,"topics":["cloudflare","developers","dns","domain","free-domain","gh-pages","hacktoberfest","hacktoberfest-accepted","software","subdomain","vercel"],"latest_commit_sha":null,"homepage":"https://is-a.software","language":"JavaScript","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/is-a-software.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-18T17:43:28.000Z","updated_at":"2025-08-28T05:29:46.000Z","dependencies_parsed_at":"2025-08-28T12:15:00.017Z","dependency_job_id":null,"html_url":"https://github.com/is-a-software/is-a-software","commit_stats":null,"previous_names":["is-a-software/is-a-software"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/is-a-software/is-a-software","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/is-a-software%2Fis-a-software","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/is-a-software%2Fis-a-software/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/is-a-software%2Fis-a-software/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/is-a-software%2Fis-a-software/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/is-a-software","download_url":"https://codeload.github.com/is-a-software/is-a-software/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/is-a-software%2Fis-a-software/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272847489,"owners_count":25003208,"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","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"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":["cloudflare","developers","dns","domain","free-domain","gh-pages","hacktoberfest","hacktoberfest-accepted","software","subdomain","vercel"],"created_at":"2025-08-30T12:17:04.244Z","updated_at":"2025-08-30T12:17:05.663Z","avatar_url":"https://github.com/is-a-software.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eis-a.software\u003c/h1\u003e\n  \u003cp\u003e\u003cb\u003eFree subdomains for developers.\u003c/b\u003e\u003c/p\u003e\n  \u003cp\u003e\n    \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/is-a-software/is-a-software?style=for-the-badge\" alt=\"GitHub Stars\"\u003e\u003c/a\u003e\n    \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/github/directory-file-count/is-a-software/is-a-software/domains?style=for-the-badge\u0026label=domains\" alt=\"Domains\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://discord.com/invite/AeAjegXn6D\"\u003e\u003cimg src=\"https://img.shields.io/discord/855711432581316639?color=5865F2\u0026logo=discord\u0026logoColor=white\u0026style=for-the-badge\" alt=\"Discord Server\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n## 🚀 How to Register Your Subdomain\n\nFollow these simple steps to get your free subdomain.\n\n### 1. 🍴  Fork the Repository\nFirst, [fork this repository](https://github.com/is-a-software/is-a-software/fork) to your own GitHub account.\n\n### 2. 📝 Create Your Record File\nNavigate to the `domains/` folder and create a new JSON file. The name of this file will be your subdomain.\n\n\u003e **For example:** To register `example.is-a-software`, you must create a file named `example.json`.\n\n### 3. ⚙️ Add Your DNS Records\nOpen your new JSON file and add the required information. You must include an `owner` section and a `record` section.\n\n* **`owner`**: Your GitHub username.\n* **`record`**: The DNS records you want. We support `A`, `AAAA`, and `CNAME`.\n* **`proxy`** (Optional): Set to `true` to enable Cloudflare's proxy (orange cloud) or `false` to disable it (DNS only). Defaults to `false`.\n\n#### **JSON File Examples**\n\n**Using a CNAME record (for services like GitHub Pages, Vercel, etc.):**\n```json\n{\n  \"owner\": {\n    \"github\": \"your-username\"\n  },\n  \"record\": {\n    \"CNAME\": \"your-username.github.io\"\n  },\n  \"proxy\": false\n}\n```\n\n### 4. 🚀 Create a Pull Request\nOnce you've created and saved your file, create a Pull Request from your fork back to this main repository.  all checks pass,then it will be automatically merged.\n\nYour subdomain should be live within a few minutes!\n\n\u003e [!NOTE]\n\u003e **Make sure to add a good commit message and a good PR title**\u003cbr\u003e\n\u003e example: `Register: example.is-a.software`\u003cbr\u003e\n\n---\n\n## ✨ Features\n\n-   ✅ **Fully Automated:** Just create a Pull Request, and our GitHub Actions handle the rest.\n-   ✅ **Fast \u0026 Reliable:** Your subdomain is powered by Cloudflare's robust DNS infrastructure.\n-   ✅ **Developer-Friendly:** Supports `A`, `AAAA`, and `CNAME` records to point to any service.\n-   ✅ **Community Driven:** An open-source project that you can contribute to and help improve.\n\n---\n\n## ⚙️ How It Works: The Automated Workflow\n\nThe magic behind `is-a.software` is its fully automated, Git-based workflow. Here’s a visual representation of the process:\n\n```mermaid\ngraph TD\n    A[You: Create a PR with a new domain.json file] --\u003e B{GitHub Action: Validate PR};\n    B --\u003e|Valid| C[Action: Auto-merge to main];\n    B --\u003e|Invalid| D[Action: Comment on PR with error];\n    C --\u003e E{GitHub Action: Sync DNS};\n    E --\u003e F[Cloudflare: Create/Update DNS Record];\n    F --\u003e G[Your Subdomain is Live! ✨];\n```\n\n---\n\n## 🤝 Contributing\n\nThis is a community project, and we welcome contributions! Whether it's improving the scripts, updating the documentation, or fixing a bug, your help is appreciated.\n\n1.  **Fork the repository** and create a new branch.\n2.  Make your changes.\n3.  Open a **Pull Request** with a clear description of what you've done.\n\n## 💬 Need Help?\n\nJoin our official Discord server for support, questions, or just to chat with the community.\n\n\u003ca href=\"https://discord.com/invite/AeAjegXn6D\"\u003e\n  \u003cimg src=\"https://invidget.switchblade.xyz/AeAjegXn6D\" alt=\"Discord Server Invite\"\u003e\n\u003c/a\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003eLicensed under the \u003ca href=\"LICENSE\"\u003eMIT License\u003c/a\u003e.\u003c/p\u003e\n  \u003cp\u003eDon't forget to ⭐ the repository if you find it useful!\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fis-a-software%2Fis-a-software","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fis-a-software%2Fis-a-software","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fis-a-software%2Fis-a-software/lists"}