{"id":38243270,"url":"https://github.com/ilkereroglu/uuidify","last_synced_at":"2026-01-17T01:19:43.378Z","repository":{"id":322149344,"uuid":"1088353120","full_name":"ilkereroglu/uuidify","owner":"ilkereroglu","description":"Blazing-fast public UUID generator API — built with Go and deployed globally via Cloudflare Workers.","archived":false,"fork":false,"pushed_at":"2025-11-19T22:40:18.000Z","size":628,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-20T00:19:29.590Z","etag":null,"topics":["api","cloudflare-workers","go","golang","opensource","serverless","uuid"],"latest_commit_sha":null,"homepage":"https://uuidify.io","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/ilkereroglu.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-11-02T20:00:20.000Z","updated_at":"2025-11-19T22:40:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ilkereroglu/uuidify","commit_stats":null,"previous_names":["ilkereroglu/uuidify"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ilkereroglu/uuidify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilkereroglu%2Fuuidify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilkereroglu%2Fuuidify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilkereroglu%2Fuuidify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilkereroglu%2Fuuidify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ilkereroglu","download_url":"https://codeload.github.com/ilkereroglu/uuidify/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ilkereroglu%2Fuuidify/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28491392,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T00:50:05.742Z","status":"ssl_error","status_checked_at":"2026-01-17T00:43:11.982Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["api","cloudflare-workers","go","golang","opensource","serverless","uuid"],"created_at":"2026-01-17T01:19:43.292Z","updated_at":"2026-01-17T01:19:43.368Z","avatar_url":"https://github.com/ilkereroglu.png","language":"TypeScript","readme":"\u003ch1\u003e\n  \u003cimg src=\"./docs/assets/uuidify-icon.png\" width=\"64\" valign=\"middle\" alt=\"UUIDify logo\" style=\"vertical-align:middle; margin-right:10px;\" /\u003e\n  UUIDify\n\u003c/h1\u003e\n\n\u003cp\u003e\n  Ultra-fast UUID \u0026 ULID generation API — powered by Go and deployed globally on Cloudflare Workers.\n\u003c/p\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://go.dev/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Go-1.22-blue?logo=go\" alt=\"Go\"\u003e\u003c/a\u003e\n  \u003ca href=\"./LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://api.uuidify.io/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Deployed%20on-Cloudflare%20Workers-orange?logo=cloudflare\" alt=\"Cloudflare\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://hub.docker.com/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Docker-ready-blue?logo=docker\" alt=\"Docker\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://status.uuidify.io\"\u003e\u003cimg src=\"https://img.shields.io/badge/Uptime-99.9%25-success\" alt=\"Uptime\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n### Live Endpoints\n\n- **Website:** [uuidify.io](https://uuidify.io) — Project Home ([Source](https://github.com/ilkereroglu/uuidify-web))\n- **API:** [api.uuidify.io](https://api.uuidify.io) — UUID/ULID generation\n- **Dashboard:** [dashboard.uuidify.io](https://dashboard.uuidify.io) — real-time telemetry\n- **Status:** [status.uuidify.io](https://status.uuidify.io) — uptime + health snapshots\n\n## Quick Start\n\n```bash\n# Default UUID v4\ncurl https://api.uuidify.io\n# → {\"uuid\":\"550e8400-e29b-41d4-a716-446655440000\"}\n\n# UUID v7 batch\ncurl \"https://api.uuidify.io?version=v7\u0026count=3\"\n# → {\"uuids\":[\"01234567-89ab-7def-0123-456789abcdef\", ...]}\n\n# ULID generation (thanks @colbee1 / PR #3)\ncurl \"https://api.uuidify.io?version=ulid\u0026count=2\"\n# → {\"ulids\":[\"01HX7D9PMV4NQVP3J8B1R6R6FZ\",\"01HX7D9PMV4NQVP3J8B1R6R6GA\"]}\n```\n\n---\n\n## Parameters\n\n| Param       | Type   | Default | Description |\n|-------------|--------|---------|-------------|\n| `algorithm` | string | `uuid`  | Generator algorithm (`uuid` or `ulid`) |\n| `version`   | string | `v4`    | UUID version (`v1`, `v4`, or `v7`) |\n| `count`     | int    | `1`     | Number of identifiers to generate (1–1000) |\n| `format`    | string | `json`  | Response format: `json` or `text` |\n\n---\n\n## Response Format\n\n- `count = 1` and UUID algorithm ⇒ `{\"uuid\":\"550e...\"}`\n- `count \u003e 1` and UUID algorithm ⇒ `{\"uuids\":[\"550e...\",\"6ba7...\"]}`\n- `count = 1` and ULID algorithm/version ⇒ `{\"ulid\":\"01HX...\"}`\n- `count \u003e 1` and ULID algorithm/version ⇒ `{\"ulids\":[\"01HX...\",\"01HX...\"]}`\n\n\u003e `format=text` still streams newline-delimited identifiers.\n\n---\n\n## Examples\n\n```bash\n# Generate a UUID v1 frame\ncurl \"https://api.uuidify.io?version=v1\"\n\n# Request newline UUIDs\ncurl \"https://api.uuidify.io?format=text\u0026count=3\"\n\n# Stream ULIDs as text\ncurl \"https://api.uuidify.io?version=ulid\u0026format=text\u0026count=2\"\n```\n\n---\n\n## Monitoring \u0026 Observability\n\n- **Live Dashboard:** [dashboard.uuidify.io](https://dashboard.uuidify.io) shows health, latency (~40 ms observed), and throughput over time.\n- **Status Page:** [status.uuidify.io](https://status.uuidify.io) exposes cron-backed health pings, keeping publicly verifiable uptime (99.9% target).\n\nBoth surfaces pull metrics from the Cloudflare Worker and Go backend, so you can validate deployments in real time.\n\n---\n\n## Local Development\n\n```bash\n# Run Go backend\nmake dev\n# Visit → http://localhost:8080\n\n# Test UUID generation\ncurl http://localhost:8080/\n# → {\"uuid\":\"550e8400-e29b-41d4-a716-446655440000\"}\n\n# Test ULID generation\ncurl \"http://localhost:8080/?version=ulid\u0026count=2\"\n# → {\"ulids\":[\"01K9N48W4SVAN58GRTTVX2FF5J\",\"01K9N48W4SVAN58GRTTX2CZ8N4\"]}\n\n# Test worker locally\nmake worker-dev\n# Visit → http://localhost:8787\n\n# Run tests\nmake test\n\n# Coverage report\nmake test-coverage\n\n# Run test script\n./test.sh\n```\n\nFor detailed testing and deployment guide, see [TESTING.md](./TESTING.md).\n\n---\n\n## Docker\n\n```bash\ndocker build -t uuidify:latest .\ndocker run -p 8080:8080 uuidify:latest\n```\n\n---\n\n## Makefile Commands\n\n| Command | Description |\n|---------|-------------|\n| `make dev` | Run locally with Go |\n| `make build` | Build the binary |\n| `make docker` | Build Docker image |\n| `make lint` | Run static analysis |\n| `make test` | Run all tests |\n\n---\n\n## Deployment\n\n### Cloudflare Workers Deploy\n\n```bash\n# Wrangler login (first time)\nwrangler login\n\n# Test worker locally\nmake worker-dev\n\n# Deploy to production\nmake worker-deploy\n```\n\nDeployed via **Cloudflare Workers** with automatic builds from **GitHub → main** branch.\n\n- **Worker:** [uuidify](https://uuidify.uuidify.workers.dev/)\n- **Custom Domain:** [api.uuidify.io](https://api.uuidify.io/)\n- **Zone:** `uuidify.io`\n\n**For detailed deployment guide, see [TESTING.md](./TESTING.md).**\n\n---\n\n## Roadmap\n\n- ✅ Deploy via Cloudflare Workers (`api.uuidify.io`)\n- ✅ Add ULID support (PR #3 by [@colbee1](https://github.com/colbee1))\n- ✅ Stand up uptime + analytics dashboards (`dashboard.uuidify.io`, `status.uuidify.io`)\n- 🔜 Publish SDKs (Go, Node.js, Python)\n- 🔜 Generate OpenAPI Spec + Postman Collection\n\n### SDK Rollout\n\n| Language | Repository | Status |\n|----------|------------|--------|\n| Go       | [`uuidify-go`](https://github.com/ilkereroglu/uuidify-go) | ✅ Released |\n| Python   | [`uuidify-python`](https://github.com/ilkereroglu/uuidify-python) | ✅ Released |\n| Node.js  | `uuidify-js` (TBD) | 🔜 In development |\n\n---\n\n## Contributing\n\nWe welcome PRs! ❤️  \nFollow [Conventional Commits](https://www.conventionalcommits.org/) and open an issue first for new features.\n\n---\n\n## License\n\nMIT © 2025 [İlker Eroğlu](https://github.com/ilkereroglu) \u0026 contributors.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filkereroglu%2Fuuidify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Filkereroglu%2Fuuidify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Filkereroglu%2Fuuidify/lists"}