![](\"https://images.clerk.com/static/logo-dark-mode-400x400.png\"){kind=logo}
\n \n
\n \n Clerk helps developers build user management. We provide streamlined user experiences for your users to sign up, sign in, and manage their profile.\n \n
\n\n[](https://clerk.com/discord)\n[](https://clerk.com/docs)\n[](https://twitter.com/intent/follow?screen_name=ClerkDev)\n\n---\n\n**Clerk is Hiring!**\n\nWould you like to work on Open Source software and help maintain this repository? [Apply today!](https://jobs.ashbyhq.com/clerk)\n\n---\n\n## Introduction\nEnjoy a more readable API with `header()` and `cookie()` - no more juggling intermediate variables or extra parentheses when handling `await`.\nPlus, a way to use `headers` and `cookies` as variable names without renaming the NextJS APIs upon import.\n\nThis lightweight package provides drop-in replacements and handy utilities that not only let you reclaim those variable names but also offer a more readable API.\n\n## Why EZHeaders?\n\nBecause naming things is hard enough without your tools getting in the way. With `ezheaders`, you can keep your code intuitive and your variable names straightforward.\n\n- **Simplified Async Access:** With `header()` and `cookie()`, you can access specific headers and cookies directly, without intermediate variables or extra `await` parentheses. This makes your asynchronous code cleaner and more readable.\n- **No More Awkward Names:** Stop settling for `headerStore` or `cookieJar`.\n- **Cleaner Code:** Write code that's easy to read and maintain.\n- **Zero Configuration:** Just install and import. It's that easy!\n- **Tree-shakable:** Only import what you need. No more bloated bundles.\n\n## Installation\n\n```bash\nnpm install ezheaders\n```\n\n## Usage examples\n\n### Using `header()`\n\nWith the new async nature of `headers` in Next.js, accessing a specific header often requires extra steps. `header()` simplifies this by allowing you to retrieve a header value directly, without intermediate variables or extra parentheses.\n\n```jsx\nimport { header } from 'ezheaders';\n\nconst contentType = await header('Content-Type');\n```\n\n### Using `cookie()`\n\nSimilarly, `cookie()` lets you access a specific cookie directly, making your code cleaner and more readable.\n\n```jsx\nimport { cookie } from 'ezheaders';\n\nconst sessionId = await cookie('sessionId');\n```\n\nIf you need to set a cookie, simply pass a value as the second argument.\n\n```jsx\nimport { cookie } from 'ezheaders';\nawait cookie('sessionId', 'abc123')\n```\n\n### Using `getHeaders()`\n\nIf you prefer working with the entire headers object, `getHeaders()` lets you use `headers` as a variable name without conflicts.\n\n```jsx\nimport { getHeaders } from 'ezheaders';\n\nconst headers = await getHeaders();\nconst contentType = headers.get('Content-Type');\n```\n\n### Using `getCookies()`\n\nLikewise, `getCookies()` lets you use `cookies` as a variable name, keeping your code intuitive.\n\n```jsx\nimport { getCookies } from 'ezheaders';\n\nconst cookies = await getCookies();\nconst theme = cookies.get('theme');\n```\n\n## API Reference\n\nFor detailed information on each function, refer to the inline documentation.\n\n## Contributing\n\nContributions are welcome! If you have ideas for improvements or new features, feel free to open an issue or submit a pull request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/my-awesome-feature`)\n3. Commit your changes (`git commit -am 'Add my awesome feature'`)\n4. Push to the branch (`git push origin feature/my-awesome-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License.\n","readmeFilename":"README.md"}