{"id":47700703,"url":"https://github.com/hmemcpy/toolkata","last_synced_at":"2026-04-02T17:09:10.218Z","repository":{"id":334011814,"uuid":"1139648923","full_name":"hmemcpy/toolkata","owner":"hmemcpy","description":"Interactive tutorials for learning developer tools - starting with jj (Jujutsu) for git users","archived":false,"fork":false,"pushed_at":"2026-02-27T23:33:00.000Z","size":2239,"stargazers_count":2,"open_issues_count":7,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-28T04:59:13.377Z","etag":null,"topics":["effect-ts","git","jujutsu","nextjs","tutorial","typescript"],"latest_commit_sha":null,"homepage":"https://toolkata.com","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/hmemcpy.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":"2026-01-22T08:29:04.000Z","updated_at":"2026-02-27T23:33:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hmemcpy/toolkata","commit_stats":null,"previous_names":["hmemcpy/toolkata"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hmemcpy/toolkata","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmemcpy%2Ftoolkata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmemcpy%2Ftoolkata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmemcpy%2Ftoolkata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmemcpy%2Ftoolkata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hmemcpy","download_url":"https://codeload.github.com/hmemcpy/toolkata/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmemcpy%2Ftoolkata/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31311240,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"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":["effect-ts","git","jujutsu","nextjs","tutorial","typescript"],"created_at":"2026-04-02T17:09:08.903Z","updated_at":"2026-04-02T17:09:10.199Z","avatar_url":"https://github.com/hmemcpy.png","language":"TypeScript","readme":"# toolkata\n\nInteractive tutorials for learning developer tools through hands-on practice.\n\n**Live site:** https://toolkata.com\n\n## Available Tutorials\n\n### jj (Jujutsu) for Git Users\n\nLearn [jj](https://github.com/martinvonz/jj), a modern version control system, by comparing it side-by-side with git commands you already know. The tutorial includes:\n\n- 12 progressive steps from basics to advanced workflows\n- Interactive terminal sandbox for hands-on practice\n- Command cheat sheet for quick reference\n\n## Project Structure\n\n```\ntoolkata/\n├── packages/\n│   ├── web/           # Next.js frontend (deployed to Vercel)\n│   └── sandbox-api/   # Docker sandbox API (self-hosted)\n└── ...\n```\n\n## Tech Stack\n\n- **Frontend:** Next.js 16, React 19, Tailwind CSS, MDX\n- **Backend:** Effect-TS, Bun\n- **Sandbox:** Docker containers with jj/git pre-installed\n\n## Development\n\n```bash\n# Install dependencies\nbun install\n\n# Run frontend dev server\nbun run --cwd packages/web dev\n\n# Run sandbox API (requires Docker)\nbun run --cwd packages/sandbox-api dev\n```\n\n## Admin Dashboard\n\nThe admin dashboard provides management interfaces for rate limits, containers, and system metrics.\n\n### Environment Variables\n\n**Frontend (Vercel):**\n- `NEXT_PUBLIC_ADMIN_API_KEY` — Admin API key for calling sandbox admin endpoints\n- `NEXT_PUBLIC_SANDBOX_URL` — Sandbox API URL (e.g., `https://sandbox.toolkata.com`)\n- `AUTH_GOOGLE_ID` — Google OAuth client ID for NextAuth authentication\n- `AUTH_GOOGLE_SECRET` — Google OAuth client secret\n- `AUTH_SECRET` — NextAuth secret for JWT signing (generate with `openssl rand -base64 32`)\n- `ADMIN_EMAILS` — Comma-separated list of authorized admin emails\n\n**Sandbox API (VPS):**\n- `ADMIN_API_KEY` — Admin API key (must match `NEXT_PUBLIC_ADMIN_API_KEY` from frontend)\n- `NODE_ENV` — Set to `production` for production builds (enforces security checks)\n\n### Accessing the Admin Dashboard\n\n1. Set up Google OAuth in [Google Cloud Console](https://console.cloud.google.com):\n   - Create OAuth 2.0 credentials\n   - Add authorized redirect URI: `https://toolkata.com/api/auth/callback/google`\n2. Configure environment variables in Vercel dashboard\n3. Navigate to `/admin` and sign in with Google\n4. Access is restricted to emails listed in `ADMIN_EMAILS`\n\n### Security\n\n- Admin API endpoints require `X-Admin-Key` header matching `ADMIN_API_KEY`\n- Admin UI requires authenticated Google account in `ADMIN_EMAILS` allowlist\n- Production deployments fail fast if `ADMIN_API_KEY` is not set\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmemcpy%2Ftoolkata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhmemcpy%2Ftoolkata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmemcpy%2Ftoolkata/lists"}