{"id":18962340,"url":"https://github.com/iamcorey/devtoolset","last_synced_at":"2025-05-16T10:07:10.583Z","repository":{"id":253151558,"uuid":"842552328","full_name":"iAmCorey/devtoolset","owner":"iAmCorey","description":"Open-source \u0026 database-free \u0026 server-free developer tools navigator / 无需数据库无需服务器的开源开发者工具导航站","archived":false,"fork":false,"pushed_at":"2025-04-28T07:20:20.000Z","size":654,"stargazers_count":326,"open_issues_count":1,"forks_count":96,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-28T08:28:17.631Z","etag":null,"topics":["cms","database-free","directory","navigator","open-source","tools","tools-directory"],"latest_commit_sha":null,"homepage":"https://DevToolset.net","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/iAmCorey.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"iamcorey","patreon":null,"open_collective":null,"ko_fi":"coreychiu","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2024-08-14T15:25:45.000Z","updated_at":"2025-04-28T07:20:27.000Z","dependencies_parsed_at":"2024-11-09T03:26:35.746Z","dependency_job_id":"f5f68503-a77e-4741-85f9-a4d715ae80af","html_url":"https://github.com/iAmCorey/devtoolset","commit_stats":null,"previous_names":["iamcorey/devtoolset"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iAmCorey%2Fdevtoolset","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iAmCorey%2Fdevtoolset/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iAmCorey%2Fdevtoolset/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iAmCorey%2Fdevtoolset/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iAmCorey","download_url":"https://codeload.github.com/iAmCorey/devtoolset/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254509476,"owners_count":22082891,"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","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":["cms","database-free","directory","navigator","open-source","tools","tools-directory"],"created_at":"2024-11-08T14:16:02.780Z","updated_at":"2025-05-16T10:07:05.572Z","avatar_url":"https://github.com/iAmCorey.png","language":"TypeScript","funding_links":["https://github.com/sponsors/iamcorey","https://ko-fi.com/coreychiu","https://ko-fi.com/X8X2WF1V8'"],"categories":[],"sub_categories":[],"readme":"🌍 *[English](README.md) ∙ [简体中文](README.zh.md)*\n\n# DevToolset\n\n[DevToolset](https://DevToolset.net/) is an open-source database-free developer tools navigator\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=iamcorey/devtoolset\u0026type=Date)](https://star-history.com/#iamcorey/devtoolset\u0026Date)\n\n\n## Preview\n\n![DevToolset](https://img.magicbox.tools/screenshot_img/devtoolset.png?version=081702)\n\n## Features\n\n- **Database-free Architecture**: Utilizes GitHub for content storage and management.\n- **Dynamic Content**: Renders content dynamically using Next.js server-side rendering.\n- **Markdown Support**: Write your content in Markdown format for easy editing and version control.\n- **Admin Interface**: Built-in admin panel for content management.\n- **Responsive Design**: Fully responsive design using Tailwind CSS.\n- **SEO Friendly**: Optimized for search engines with dynamic metadata.\n- **Easy Deployment**: Simple deployment process to Vercel.\n- **Built-in Analytics Support**: Integrated analytics support scripts, compatible with Google Analytics and Plausible Analytics.\n- **i18n**: Support multiple languages and can be easily extended to support more languages.\n- **Dark Mode**: Support dark mode and can be easily extended to support more themes.\n- **Ads Support**: Support Google Adsense and can be easily extended to support more ads.\n\n### Tech Stack\n- Next.js - Framework\n- Tailwind CSS - CSS Framework\n- Shadcn/UI - Component Library\n- Vercel - Deployment\n- Next-Intl - Internationalization\n- Analytics - Google Analytics \u0026 Plausible Analytics \u0026 ...\n- Ads - Google Adsense \u0026 ...\n\n---\n\n\n## Adding New Developer Tools to DevToolset\n\nWanna add your site to DevToolset? \n\n### Two ways to submit your site\n1. Submit your site via [GitHub Issues](https://github.com/iamcorey/devtoolset/issues) for a free dofollow link.\n\n2. Or you can also submit your site by change the jsonc file in the `data/json/[locale]` folder and create a pull request.\n(Please read our [Submission Guide](/data/md/add-new-developer-tools.md) for details on how to request inclusion)\n\n### Submit format\n\nFollow the format below:\n- [ ] **name**: Provide a brief title describing the tool or data you added.\n- [ ] **description**: Clearly state what tool or data was added and in which category.\n- [ ] **url**: Provide the url of the tool.\n- [ ] **category**: Provide the category of the tool.\n- [ ] **tags**: Provide serval tags of the tool. (3 tags at most)\n- [ ] **icon_url**: Provide the url of the icon of the tool. (Optional) If not provided, the icon will be generated automatically.\n\n\n### Additional Notes\n- **Developer Tools Only**: Please do not submit tools unrelated to development.\n- **No Affiliate Links**: Do not include affiliate links.\n- **No Spam**: Do not include spam.\n- **Accessible URL**: Ensure the url is accessible.\n\n\n\n## Deploy your own DevToolset\n\n### Deploy on Vercel\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FiAmCorey%2Fdevtoolset\u0026project-name=devtoolset\u0026repository-name=devtoolset\u0026external-id=https%3A%2F%2Fgithub.com%2FiAmCoreye%2Fdevtoolset%2Ftree%2Fmain)\n\n\n\n## Prerequisites\n\n- Node.js (version 14 or later)\n- npm/pnpm/yarn (comes with Node.js)\n- Git\n- GitHub account\n- Vercel account (for deployment)\n\n## Installation\n\n1. Clone the repository:\n   ```\n   git clone https://github.com/iAmCorey/devtoolset\n   cd devtoolset\n   ```\n\n2. Install dependencies:\n   ```\n   npm install\n   pnpm install\n   yarn\n   ```\n\n3. Create a `.env.local` file in the root directory and add the following:\n   ```\n   GITHUB_TOKEN=your_github_personal_access_token(Optional)\n   GITHUB_OWNER=your_github_username(Optional)\n   GITHUB_REPO=your_repo_name(Optional)\n   ACCESS_PASSWORD=your_secure_access_password(Optional)\n   JWT_SECRET=your_secret_key_here(Optional)\n   NEXT_PUBLIC_GOOGLE_ANALYTICS_ID=your_google_analytics(G-xxx)(Optional)\n   NEXT_PUBLIC_PLAUSIBLE_URL=your_plausible_data_domain(Optional)\n   NEXT_PUBLIC_GOOGLE_ADSENSE_ID=your_google_adsense_id(Optional)\n   DOMAIN=your_domain(localhost / YOUR_DOMAIN.tld)\n   ```\n\n4. Set up your GitHub repository:\n   - Create a new repository on GitHub\n   - Create two folders in the repository: `data/json/[locale]` and `data/md`\n   - In `data/json/[locale]`, create related jsonc file with an empty array: `[]`\n\n5. Run the development server:\n   ```\n   npm run dev\n   pnpm dev\n   yarn run dev\n   ```\n\nVisit `http://localhost:3000` to see your DevToolset instance running locally.\n\n## Deployment\n\n1. Push your code to GitHub.\n2. Log in to Vercel and create a new project from your GitHub repository.\n3. Configure the environment variables in Vercel:\n   - `GITHUB_TOKEN`(Optional)\n   - `GITHUB_OWNER`(Optional)\n   - `GITHUB_REPO`(Optional)\n   - `ACCESS_PASSWORD`(Optional)\n   - `JWT_SECRET`(Optional)\n   - `NEXT_PUBLIC_GOOGLE_ANALYTICS_ID`(Optional)\n   - `NEXT_PUBLIC_PLAUSIBLE_URL`(Optional)\n   - `NEXT_PUBLIC_GOOGLE_ADSENSE_ID`(Optional)\n   - `DOMAIN`(localhost / YOUR_DOMAIN.tld)\n4. Deploy the project.\n\nFor a detailed deployment guide, please refer to our [Installation and Deployment Guide](/data/md/deploy-own-devtoolset.md).\n\n## Usage\n### Mannually\n- Tools: Change the jsonc file in the `data/json/[locale]` folder.\n- Articles: Change the markdown file in the `data/md` folder.\n\n### By The Admin Panel\n(Need to configure the GITHUB related environment variables.)\n- Access the admin panel by navigating to `/admin` and using your `ACCESS_PASSWORD`.\n- Create and edit articles through the admin interface.\n- Manage resources in the admin panel.\n- All changes are automatically synced with your GitHub repository.\n\n\n---\n\n\n## Changelog\nSee [CHANGELOG.md](./CHANGELOG.md) for a detailed list of changes.\n\n## Contributing\n\nWe welcome contributions to DevToolset! Please read our [Contributing Guide](/data/md/add-new-developer-tools.md) for details on our code of conduct and the process for submitting pull requests.\n\n## License\n\nDevToolset is open-source software licensed under the [MIT license](./LICENSE).\n\n\n## Acknowledgements\n\nDevToolset is built with the following tools and libraries:\n- [GitBase](https://gitbase.app/) \n- [Favicon Stealer](https://github.com/iAmCorey/favicon-stealer) \n- [Next.js](https://nextjs.org/)\n- [Tailwind CSS](https://tailwindcss.com/)\n- [Shadcn/UI](https://ui.shadcn.com/)\n\nWe are grateful to the maintainers and contributors of these projects.\n\n## Contact Us\n\nIf you want a secondary development, want to customize this project or want to collaborate with us, please contact us.\n\nFeel free to reach out if you have any questions or suggestions:\n\n- **Email:** [iamcoreychiu+devtoolset@gmail.com](mailto:iamcoreychiu+devtoolset@gmail.com)\n- **GitHub:** [iamcorey](https://github.com/iamcorey)\n- **jike:** `阿邱很行` [阿邱很行](https://okjk.co/mFe3NR)\n- **Wechat:** `iAmCor3y`(Please add a note when sending a friend request)\n\u003cimg src=\"https://img.magicbox.tools/screenshot_img/iamcoreywechat.jpg\" alt=\"加我为好友\" style=\"height: 200px; width: 200px\"\u003e\n\n\n## Support \n\nIf you find this project helpful, please consider giving it a ⭐ on GitHub!\n\nIf you want to donate or sponsor this project, it will be greatly appreciated.\n\n\u003ca href='https://ko-fi.com/X8X2WF1V8' target='_blank'\u003e\u003cimg height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi1.png?v=3' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\n\u003cimg src=\"./public/buymeacoffee.jpg\" alt=\"请阿邱喝咖啡\" style=\"height: 200px; width: 200px\"\u003e\n\nThank you for your support!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamcorey%2Fdevtoolset","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiamcorey%2Fdevtoolset","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamcorey%2Fdevtoolset/lists"}