{"id":27055291,"url":"https://github.com/bernabedev/bunxyz","last_synced_at":"2026-02-17T18:04:56.904Z","repository":{"id":286253125,"uuid":"958140209","full_name":"bernabedev/bunxyz","owner":"bernabedev","description":"Minimalist, fast, file-system based routing framework for Bun","archived":false,"fork":false,"pushed_at":"2025-08-25T22:08:22.000Z","size":159,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-19T16:13:34.508Z","etag":null,"topics":["api","bun","framework","router","web"],"latest_commit_sha":null,"homepage":"https://github.com/bernabedev/bunxyz#readme","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/bernabedev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2025-03-31T17:55:19.000Z","updated_at":"2025-08-25T22:08:26.000Z","dependencies_parsed_at":"2025-04-05T09:35:14.161Z","dependency_job_id":null,"html_url":"https://github.com/bernabedev/bunxyz","commit_stats":null,"previous_names":["bernabedev/bunxyz"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/bernabedev/bunxyz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernabedev%2Fbunxyz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernabedev%2Fbunxyz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernabedev%2Fbunxyz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernabedev%2Fbunxyz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bernabedev","download_url":"https://codeload.github.com/bernabedev/bunxyz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernabedev%2Fbunxyz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29552260,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-17T17:56:56.811Z","status":"ssl_error","status_checked_at":"2026-02-17T17:56:55.544Z","response_time":100,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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","bun","framework","router","web"],"created_at":"2025-04-05T09:19:51.920Z","updated_at":"2026-02-17T18:04:56.890Z","avatar_url":"https://github.com/bernabedev.png","language":"TypeScript","readme":"# 🦊 Bunxyz\n\nA minimalist, fast, file-system based routing framework for **Bun**, inspired by Express and Next.js/Remix. Leverage Bun's incredible speed with a familiar and intuitive development experience.\n\n[![Made with Bun](https://img.shields.io/badge/Made%20with-Bun-yellow.svg)](https://bun.sh)\n[![NPM Version - Framework](https://img.shields.io/npm/v/bunxyz.svg)](https://www.npmjs.com/package/bunxyz) \u003c!-- Placeholder --\u003e\n[![NPM Version - CLI](https://img.shields.io/npm/v/bunxyz-cli.svg)](https://www.npmjs.com/package/bunxyz-cli) \u003c!-- Placeholder --\u003e\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) \u003c!-- Adjust if needed --\u003e\n\nThis repository contains the source code for the **Bunxyz framework** and its command-line interface (**Bunxyz CLI**). Bunxyz aims to be a fast, lightweight, and developer-friendly web framework built specifically for the [Bun](https://bun.sh/) runtime.\n\nThis is a monorepo managed using **Bun Workspaces**.\n\n## Packages\n\n- **`packages/bunxyz`**: The core framework package. It exports the main `App` class, `BunxyzRequest`, `BunxyzResponse`, type definitions, and other core functionalities.\n- **`packages/bunxyz-cli`**: The CLI tool, published as `bunxyz-cli` (or your chosen name). Provides the `bunxyz` command for scaffolding new projects (`bunxyz create \u003cproject-name\u003e`) and potentially other development tasks in the future.\n\n## Getting Started (Development)\n\nTo set up the monorepo for local development:\n\n1.  **Prerequisites:**\n\n    - [Bun](https://bun.sh/docs/installation) (v1.x or later recommended)\n    - Git\n\n2.  **Clone the repository:**\n\n    ```bash\n    git clone https://github.com/bernabedev/bunxyz.git\n    cd bunxyz\n    ```\n\n3.  **Install dependencies:**\n    This command installs dependencies for _all_ packages within the workspace and links local packages together (e.g., `bunxyz-cli` will use the local `bunxyz` package).\n    ```bash\n    bun install\n    ```\n\n## Development Workflow \u0026 Scripts\n\nCommon development tasks can be run from the **root** of the monorepo:\n\n- **Build all packages:**\n\n  ```bash\n  bun run build\n  ```\n\n  _(This executes the `build` script defined in each package's `package.json`)_\n\n- **Build a specific package:**\n\n  ```bash\n  # Build only the framework\n  bun run build:framework\n  # Or using filter\n  bun run --filter bunxyz build\n\n  # Build only the CLI\n  bun run build:cli\n  # Or using filter\n  bun run --filter bunxyz-cli build\n  ```\n\n- **Clean build artifacts and dependencies:**\n\n  ```bash\n  bun run clean\n  ```\n\n- **(Add scripts for testing, linting, formatting etc. to the root `package.json` as needed)**\n  ```bash\n  # Example placeholders\n  bun run test\n  bun run lint\n  bun run format\n  ```\n\n## Using the CLI Locally During Development\n\nTo test the `bunxyz-cli` package while developing it:\n\n1.  **Build the CLI:** Make sure you have compiled the CLI code.\n\n    ```bash\n    bun run build:cli\n    ```\n\n2.  **Link the CLI globally:** Navigate to the CLI package directory and use `bun link`.\n\n    ```bash\n    cd packages/bunxyz-cli\n    bun link\n    cd ../.. # Go back to the monorepo root or another directory\n    ```\n\n3.  **Use the linked CLI:** Now you can use the `bunxyz` command globally, and it will point to your local build.\n\n    ```bash\n    # Create a test project OUTSIDE the monorepo structure\n    cd /path/to/your/test/area\n    bunxyz create my-test-project\n    ```\n\n    - **Note:** Changes made to the **CLI source code** (`packages/bunxyz-cli/src`) require rebuilding (`bun run build:cli`) for the linked command to reflect them.\n    - **Note:** Changes made to the **framework source code** (`packages/bunxyz/src`) should be reflected automatically when you run the CLI or a test project (due to workspace linking), although you might need to restart any running processes (like a dev server).\n\n## Contributing\n\nContributions are welcome! Please see `CONTRIBUTING.md` (you'll need to create this file) for guidelines on reporting issues, submitting pull requests, and the development process.\n\n## License\n\nThis project is licensed under the MIT License - see the `LICENSE` file (you'll need to create this file) for details.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbernabedev%2Fbunxyz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbernabedev%2Fbunxyz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbernabedev%2Fbunxyz/lists"}