{"id":13808015,"url":"https://github.com/grip-framework/grip","last_synced_at":"2025-05-16T12:10:54.020Z","repository":{"id":44603091,"uuid":"229540500","full_name":"grip-framework/grip","owner":"grip-framework","description":"The microframework for writing powerful web applications.","archived":false,"fork":false,"pushed_at":"2025-04-08T05:49:22.000Z","size":1164,"stargazers_count":281,"open_issues_count":0,"forks_count":17,"subscribers_count":14,"default_branch":"core","last_synced_at":"2025-04-09T10:03:34.848Z","etag":null,"topics":["crystal","grip","kemal","microframework","phoenix","router","routing","web-framework","websocket"],"latest_commit_sha":null,"homepage":"https://grip-framework.github.io/docs/","language":"Crystal","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/grip-framework.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-12-22T08:42:30.000Z","updated_at":"2025-04-06T09:08:17.000Z","dependencies_parsed_at":"2023-11-22T22:31:59.818Z","dependency_job_id":"0a72c6c1-6fde-4ec4-974d-dbe3c31f824d","html_url":"https://github.com/grip-framework/grip","commit_stats":{"total_commits":416,"total_committers":16,"mean_commits":26.0,"dds":0.3798076923076923,"last_synced_commit":"e993efb6d0855a19168efb46eb32ec1773b8a17d"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grip-framework%2Fgrip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grip-framework%2Fgrip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grip-framework%2Fgrip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grip-framework%2Fgrip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grip-framework","download_url":"https://codeload.github.com/grip-framework/grip/tar.gz/refs/heads/core","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254527099,"owners_count":22085919,"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":["crystal","grip","kemal","microframework","phoenix","router","routing","web-framework","websocket"],"created_at":"2024-08-04T01:01:33.768Z","updated_at":"2025-05-16T12:10:54.001Z","avatar_url":"https://github.com/grip-framework.png","language":"Crystal","readme":"\u003cp align=\"center\" width=\"100%\"\u003e\n    \u003cimg src=\"https://github.com/grip-framework/medias/blob/master/framework.svg\" height=\"250\" href=\"https://github.com/grip-framework/grip\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    The microframework for writing \u003cins\u003epowerful web applications\u003c/ins\u003e.\u003cbr\u003e\u003cbr\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/grip-framework/grip/actions\"\u003e\u003cimg alt=\"Actions Status\" src=\"https://img.shields.io/github/actions/workflow/status/grip-framework/grip/crystal.yml?branch=core\u0026label=actions\u0026style=flat-square\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://www.techempower.com/benchmarks/#section=data-r19\u0026hw=ph\u0026test=plaintext\u0026l=zdk8an-1r\"\u003e\u003cimg alt=\"TechEmpower Benchmark\" src=\"https://img.shields.io/badge/benchmark-1%2C663%2C946-brightgreen?style=flat-square\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://grip-framework.github.io/docs/\"\u003e\u003cimg alt=\"Docs CI Status\" src=\"https://img.shields.io/github/actions/workflow/status/grip-framework/docs/ci.yml?branch=master\u0026label=docs\u0026style=flat-square\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://gitter.im/grip-framework/grip?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\"\u003e\u003cimg alt=\"Chat on Gitter\" src=\"https://img.shields.io/gitter/room/grip-framework/grip?style=flat-square\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nGrip is a microframework for building RESTful web applications. It is designed to be modular and easy to use, with the ability to scale up to the limits of the Crystal programming language. It offers extensibility and has integrated middleware called \"pipes\". Pipes can alter parts of the request/response context and then get passed to the actual endpoint. Grip's router is very similar to the router of the [Phoenix framework](https://github.com/phoenixframework/phoenix). And most of all: Grip is fast.\n\n## Motivation\n\nThis project exists due to the fact that Kemal lacks one crucial part of a framework, a structure. An example for the absence of a structure can be found [here](https://github.com/iv-org/invidious/blob/5d8de5fde2dee11ee8feb63f0bce74d373eec56f/src/invidious.cr).\n\n## Features\n\n- HTTP 1.1 support.\n- WebSocket RFC 6455 support.\n- Built-in exceptions support.\n- Parameter handling support.\n- JSON serialization and deserialization support (fastest framework with JSON in Crystal).\n- Middleware support.\n- Request/Response context, inspired by [expressjs](https://github.com/expressjs/express).\n- Advanced routing support.\n\n## Code example\n\nAdd this to your application's `application.cr`:\n\n```crystal\nrequire \"grip\"\n\nclass IndexController\n  include Grip::Controllers::HTTP\n\n  def get(context : Context) : Context\n    context\n      .put_status(200) # Assign the status code as 200 OK.\n      .json({\"id\" =\u003e 1}) # Respond with JSON content.\n      .halt # Close the connection.\n  end\n\n  def index(context : Context) : Context\n    id =\n      context\n        .fetch_path_params\n        .[\"id\"]\n\n    # An optional secondary argument gives a custom `Content-Type` header to the response.\n    context\n      .json(content: {\"id\" =\u003e id}, content_type: \"application/json; charset=us-ascii\")\n      .halt\n  end\nend\n\nclass Application \u003c Grip::Application\n  def initialize\n    # By default the environment is set to \"development\".\n    super(\n      environment: ENV[\"ENVIRONMENT\"]? || \"production\"\n      handlers: [\n        Grip::Handlers::Log.new,\n        Grip::Handlers::HTTP.new\n      ] of HTTP::Handler\n    )\n\n    routes()\n  end\n\n  def routes()\n    scope \"/api\" do\n      scope \"/v1\" do\n        get \"/\", IndexController\n        get \"/:id\", IndexController, as: :index\n      end\n    end\n  end\nend\n\napp = Application.new\napp.run\n```\n\n## Installation\n\nAdd this to your application's `shard.yml`:\n\n```yaml\ndependencies:\n  grip:\n    github: grip-framework/grip\n```\n\nAnd run this command in your terminal:\n\n```bash\nshards install\n```\n\n## API Reference\n\nDocumentation can be found on the [official website of the Grip framework](https://grip-framework.github.io/docs/) or\nthe [CrystalDoc website](https://crystaldoc.info/github/grip-framework/grip/v4.0.0/index.html).\n\n## Contribute\n\nSee our [contribution guidelines](https://github.com/grip-framework/grip/blob/master/CONTRIBUTING.md) and read the [code of conduct](https://github.com/grip-framework/grip/blob/master/CODE_OF_CONDUCT.md).\n","funding_links":[],"categories":["\u003ca name=\"Crystal\"\u003e\u003c/a\u003eCrystal","Web Frameworks"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrip-framework%2Fgrip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrip-framework%2Fgrip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrip-framework%2Fgrip/lists"}