{"id":24373280,"url":"https://github.com/kao-xiang/mantou","last_synced_at":"2025-08-20T04:22:59.382Z","repository":{"id":269742674,"uuid":"908331060","full_name":"kao-xiang/mantou","owner":"kao-xiang","description":"Fullstack React Web Framework Powered By Bun","archived":false,"fork":false,"pushed_at":"2025-02-22T14:30:03.000Z","size":2461,"stargazers_count":22,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2025-03-23T03:48:32.778Z","etag":null,"topics":["bun","filebasedrouting","fullstack","nextjs","openapi","react","swagger"],"latest_commit_sha":null,"homepage":"https://mantou.gitbook.io/docs","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kao-xiang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-12-25T18:59:48.000Z","updated_at":"2025-03-22T23:06:39.000Z","dependencies_parsed_at":"2024-12-25T20:19:00.675Z","dependency_job_id":"5b30b87d-820f-456e-8557-d31d76b09d47","html_url":"https://github.com/kao-xiang/mantou","commit_stats":null,"previous_names":["ppenter/mantou","kao-xiang/mantou"],"tags_count":75,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kao-xiang%2Fmantou","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kao-xiang%2Fmantou/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kao-xiang%2Fmantou/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kao-xiang%2Fmantou/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kao-xiang","download_url":"https://codeload.github.com/kao-xiang/mantou/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248271631,"owners_count":21075800,"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":["bun","filebasedrouting","fullstack","nextjs","openapi","react","swagger"],"created_at":"2025-01-19T05:10:30.861Z","updated_at":"2025-04-10T18:31:42.792Z","avatar_url":"https://github.com/kao-xiang.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MANTOU 🍞\n\n*The Next Generation Web Framework Powered by Bun*\n\n![preview](/images/mantou-preview.png)\n\u003ci style=\"display:flex;width: 100%; justify-content: center;\"\u003eEffortless Fullstack: Typesafe \u0026 Documented.\u003c/i\u003e\n\n[![license](https://img.shields.io/github/license/ppenter/mantou?style=default\u0026logo=opensourceinitiative\u0026logoColor=white\u0026color=ffca7f)](LICENSE)\n[![last-commit](https://img.shields.io/github/last-commit/ppenter/mantou?style=default\u0026logo=git\u0026logoColor=white\u0026color=ffca7f)](https://github.com/ppenter/mantou/commits/master)\n[![repo-top-language](https://img.shields.io/github/languages/top/ppenter/mantou?style=default\u0026color=ffca7f)](https://github.com/ppenter/mantou/search?l=typescript)\n\n[![Discord](https://img.shields.io/discord/1329129791483416596?color=7289da\u0026label=discord\u0026logo=discord\u0026logoColor=white)](https://discord.gg/nhJgvxUTpp)\n[![Reddit](https://img.shields.io/reddit/subreddit-subscribers/mantoubun?style=social)](https://www.reddit.com/r/mantoubun/)\n\n## 🌟 Overview\n\nMANTOU (馒头) is a delightfully simple yet powerful web framework that brings together the best of Next.js patterns with Bun's blazing speed. Like its namesake - the fluffy Chinese steamed bun - MANTOU is light, satisfying, and gets the job done without unnecessary complexity.\n\n## ⚡️ Key Features\n\n- **0ms Cold Start**: Powered by Bun's lightning-fast runtime\n- **Type Safety Without Tears**: Automatic type inference that just works\n- **File-Based Magic**: Next.js-style routing you already know and love\n- **API Docs That Write Themselves**: Automatic Swagger generation\n- **Hot Like 🔥**: Ultra-fast hot module replacement\n- **Zero Config**: Sensible defaults with full customization when you need it\n\n## 🚀 Quick Start\n\n```bash\n# Create your next amazing project\nbun create mantou-app@latest\n\n# Jump into the action\ncd my-app\nbun install\nbun run dev\n```\nLater in [Documentation](https://kao-xiang.github.io/mantou/)\n\n## 🎯 Roadmap\n\n### Phase 1\n- [x] File-based routing system\n- [x] Basic SSR implementation\n- [x] Type-safe API routes\n- [ ] Production build optimization\n- [ ] Websocket Integration\n- [ ] Plugins\n\n## 🎨 Why Choose MANTOU?\n\n### Simple Yet Powerful\nLike a steamed bun, MANTOU is simple on the outside but packed with goodness inside. We eliminate complexity while keeping the power you need.\n\n### Performance First\nBuilt on Bun, MANTOU is designed for speed:\n- Sub-millisecond cold starts\n- Lightning-fast HMR\n- Optimized build output\n- Minimal runtime overhead\n\n## 🛠 Configuration\n\n```typescript\n// mantou.config.ts\nexport default {\n  swagger: {\n    path: '/docs',\n    documentation: {\n      info: {\n        title: 'Mantou Example',\n        description: 'Mantou Example API',\n        version: '1.0.0',\n      },\n      security: [{ JwtAuth: [] }],\n      components: {\n        securitySchemes: {\n          JwtAuth: {\n            type: \"http\",\n            scheme: \"bearer\",\n            bearerFormat: \"JWT\",\n            description: \"Enter JWT Bearer token **_only_**\",\n          },\n        },\n      },\n    }\n  }\n}\n```\n\n## 🤝 Contributing\n\nWe love contributions! Here's how you can help:\n\n1. Fork the repo\n2. Create your feature branch\n3. Make your changes\n4. Submit a PR\n\nSee our [Contributing Guide](CONTRIBUTING.md) for more details.\n\n## 📘 Documentation\n\nVisit [this](https://mantou.gitbook.io/docs) for full documentation.\n\n## 💬 Community\n\n- 📫 [GitHub Discussions](https://github.com/ppenter/mantou/discussions)\n- 🐛 [Issue Tracker](https://github.com/ppenter/mantou/issues)\n- 🌟 [GitHub Stars](https://github.com/ppenter/mantou/stargazers)\n\n## 📄 License\n\n[MIT License](LICENSE) - feel free to use and modify!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkao-xiang%2Fmantou","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkao-xiang%2Fmantou","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkao-xiang%2Fmantou/lists"}