{"id":28684050,"url":"https://github.com/ozeanjs/ozean","last_synced_at":"2025-12-25T19:56:34.615Z","repository":{"id":297808054,"uuid":"997449314","full_name":"ozeanjs/ozean","owner":"ozeanjs","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-08T15:38:20.000Z","size":244,"stargazers_count":0,"open_issues_count":4,"forks_count":1,"subscribers_count":0,"default_branch":"develop","last_synced_at":"2025-06-08T16:24:48.940Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/ozeanjs.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":["mrthiti"]}},"created_at":"2025-06-06T14:44:29.000Z","updated_at":"2025-06-08T15:21:43.000Z","dependencies_parsed_at":"2025-06-08T16:24:52.970Z","dependency_job_id":null,"html_url":"https://github.com/ozeanjs/ozean","commit_stats":null,"previous_names":["ozean-js/ozean.js","ozeanjs/ozean"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/ozeanjs/ozean","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozeanjs%2Fozean","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozeanjs%2Fozean/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozeanjs%2Fozean/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozeanjs%2Fozean/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ozeanjs","download_url":"https://codeload.github.com/ozeanjs/ozean/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ozeanjs%2Fozean/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259641946,"owners_count":22888966,"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":[],"created_at":"2025-06-14T03:01:19.986Z","updated_at":"2025-12-25T19:56:34.608Z","avatar_url":"https://github.com/ozeanjs.png","language":"TypeScript","funding_links":["https://github.com/sponsors/mrthiti"],"categories":["Angular-Inspired Solutions"],"sub_categories":["Wrappers"],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://ozeanjs.com\"\u003e\n    \u003cimg src=\"./docs/docs/public/logo.svg\" alt=\"OzeanJs\" width=\"150\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003eA progressive \u003ca href=\"https://ozeanjs.com\"\u003eOzeanJs\u003c/a\u003e framework for crafting efficient and scalable server-side applications.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/npm/v/ozean\" alt=\"npm version\"\u003e\n  \u003cimg src=\"https://img.shields.io/npm/dm/ozean\" alt=\"npm download\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/bun-compatible-brightgreen\" alt=\"bun compatible\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/ozeanjs/ozean\" alt=\"License\"\u003e\n\u003c/p\u003e\n\n# OzeanJs 🌊\n\nWelcome to [**OzeanJs**](https://ozeanjs.com)!\n\nTired of complex setups and repetitive boilerplate? OceanJs is your answer.\n\nOceanJs is a modern, simple, and high-performance web framework built on the Bun runtime. It aims to provide a fast and enjoyable development experience, helping you build scalable and maintainable server-side applications with ease.\n\nWe've adapted the robust and well-regarded architecture of Angular for the back-end world, allowing you to organize your code systematically while leveraging the full performance of the Bun runtime.\n\n### Why Choose OceanJs?\n\nWe didn't just build another framework; we built a tool to help you focus on creating excellent business logic without worrying about complex infrastructure.\n\n### 🚀 Built for Speed\n\nOceanJs is built on Bun, which means you benefit from the fastest runtime speed, dependency installation, and test execution available today, accelerating your entire development cycle.\n\n### ✨ Organized \u0026 Scalable Architecture\n\nWith a system of Modules, Controllers, and Services inspired by Angular, your code is naturally organized, making it easy to understand, test, and scale your project into the future without chaos.\n\n### 💉 Powerful Dependency Injection\n\nSay goodbye to complex `require` or `import` statements. Our built-in DI system automatically creates and injects the services you need. Simply declare them in the `constructor`, resulting in cleaner, loosely coupled code.\n\n### 👩‍💻 Excellent Developer Experience\n\nWe believe coding should be fun. With an intuitive Decorator-based API that's easy to read, a CLI that helps scaffold projects and files, and minimal initial setup, you can start your project and see results in minutes.\n\nSpend less time on configuration and more time building amazing things.\nDive into OceanJs today!\n\n# Quick Start\n\nthe fastest way to create and run your first OzeanJs project using the **Ozean CLI**.\n\n### Prerequisites\n\nEnsure you have **Bun** installed on your machine.\n\n---\n\n### Step 1: Create a New Project with the CLI\n\nYou don't need to install our CLI beforehand. You can use the `bunx` command to download and run it immediately.\n\nOpen your terminal and run the command:\n\n```bash\nbunx ozean-cli new my-awesome-app\n```\n\n**What does this command do?**\n\n- **`bunx`**: Downloads and runs `ozean-cli` temporarily without a global installation.\n- **`new my-awesome-app`**: Instructs the CLI to create a new project in a folder named `my-awesome-app` and automatically install all necessary dependencies.\n\nOnce the command is finished, navigate into your project folder:\n\n```bash\ncd my-awesome-app\n```\n\n---\n\n### Step 2: Run the Development Server\n\nRun your application in development mode with the command:\n\n```bash\nbun run index\n```\n\n(This script is already defined in the `package.json` of the generated project.)\n\nYou should see a message in your terminal indicating that your application is running on `http://localhost:3000`.\n\n---\n\n### Step 3: Test the Application\n\nOpen another terminal and use `curl` to test if the server is working correctly:\n\n```bash\ncurl http://localhost:3000/cats\n```\n\n**Expected Result:**\n\n```\nHello cat.\n```\n\nThat's it! In just 3 simple steps, your first OceanJs project is ready to go. Try opening the project in your favorite editor and start modifying the code in the `src` folder!\n\nHappy coding with OzeanJs!\n\n[npm-url]: https://www.npmjs.com/package/ozean\n[npm-version-image]: https://img.shields.io/npm/v/ozean.svg?style=flat\n[npm-downloads-image]: https://img.shields.io/npm/dm/ozean.svg?style=flat\n[npm-downloads-url]: https://npmcharts.com/compare/ozean?minimal=true\n[license-image]: https://img.shields.io/badge/license-MIT-blue.svg?style=flat\n[license-url]: LICENSE\n[bun-compatible]: https://img.shields.io/badge/bun-compatible-brightgreen\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fozeanjs%2Fozean","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fozeanjs%2Fozean","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fozeanjs%2Fozean/lists"}