RedwoodGraphQL

_by Tom Preston-Werner, Peter Pistorius, Rob Cameron, David Price, and more than 250 amazing contributors (see end of file for a full list)._ **NOTE** > ⚡ **Big News** — We’ve launched **[RedwoodSDK](https://github.com/redwoodjs/sdk)**, a modern React framework for building full-stack web apps on Cloudflare. --- ## 🌲 RedwoodSDK — React on Cloudflare RedwoodSDK starts as a **Vite plugin** and unlocks: - **SSR** (Server-Side Rendering) - **React Server Components** - **Server Functions** - **Streaming + Realtime** - Local dev parity with **Miniflare** - First-class Cloudflare services: **Workers**, **D1**, **Durable Objects**, **R2**, **Queues**, and more All while keeping to **web standards** — you write with native `Request`/`Response` and the modern Web APIs you already know. --- ### 🚀 Try it in seconds ```bash npx create-rwsdk my-project-name cd my-project-name npm run dev ``` 📚 [Read the docs](https://docs.rwsdk.com) ⚡ [Quick Start Guide](https://docs.rwsdk.com/getting-started/quick-start) --- ## 🙌 How You Can Help We’d love for the Redwood community to be part of this from day one: 1. **Try it out** — Follow the Quick Start and build something small. 2. **Give feedback** — Tell us what works, what’s confusing, and what could be better. 3. **Spread the word** — Share RedwoodSDK with your friends, coworkers, and followers. 4. **Star the repo** — Stars help more developers discover RedwoodSDK. --- ## 📌 Links - ⭐ **Star RedwoodSDK**: [https://github.com/redwoodjs/sdk](https://github.com/redwoodjs/sdk) - 📚 Docs: [https://docs.rwsdk.com](https://docs.rwsdk.com) - 💬 Discord: [https://discord.gg/redwoodjs](https://discord.gg/redwoodjs) - 🌐 Website: [https://rwsdk.com](https://rwsdk.com) --- Thank you for being part of the Redwood journey — we can’t wait to see what you build with **RedwoodSDK**! ❤️ --- # RedwoodJS GraphQL ## Bighorn Epoch (current development epoch) > **NOTE:** This section of the Readme is aspirational for the current development > epoch we call Bighorn. Bighorn has not yet been released, but when it is, it will > fulfill the promises of what you read below. If you’d like to help us on this > journey, please say hi in the [Community Forums](https://redwoodjs.com/community)! **Redwood is a framework for quickly creating React-based web applications that provide an amazing end user experience.** Our goal is to be simple and approachable enough for use in prototypes and hackathons, but performant and comprehensive enough to evolve into your next startup. We accomplish this in two primary ways: 1. Redwood is opinionated and full-stack. We’ve chosen the best technologies in the JS/TS ecosystem and beautifully integrated them into a cohesive framework that lets you get things done instead of endlessly evaluating technology options. You can get started using Redwood without a backend, but the framework really shines when you’re building a data driven application. Our transparent data fetching and optional GraphQL API make building and growing your application easier than you expect! 2. Redwood’s declarative data fetching and simple form submission features are built on top of RSC + Server Actions and simplify common use cases so you can focus on your users’ experience. Creating the best, most responsive user interfaces requires reasoning about whether code should execute on the server or the client. Redwood makes it easy to choose the best execution context for your code by leveraging the power of React Server Components. The entire framework is built with TypeScript, so you get type safety from the router to the database and everywhere in-between. If you’d rather build your app with JavaScript, you can do that too, and still enjoy great code completion features in your favorite editor. > **TRY BIGHORN:** While Bighorn does not yet have a production release, we do > publish the latest code as canaries, and we welcome you to experiment with them! > The best way to get familiar with these canaries is to keep an eye on the [Redwood > Blog](https://redwoodjs.com/blog). ## Arapahoe Epoch (current stable release) **Redwood is an opinionated, full-stack, JavaScript/TypeScript web application framework designed to keep you moving fast as your app grows from side project to startup.** At the highest level, a Redwood app is a React frontend that talks to a custom GraphQL API. The API uses Prisma to operate on a database. Out of the box you get tightly integrated testing with Jest, logging with Pino, and a UI component catalog with Storybook. Setting up authentication (like Auth0) or CSS frameworks (like Tailwind CSS) are a single command line invocation away. And to top it off, Redwood's architecture allows you to deploy to either serverless providers (e.g. Netlify, Vercel) or traditional server and container providers (e.g. AWS, Render) with nearly no code changes between the two! By making a lot of decisions for you, Redwood lets you get to work on what makes your application special, instead of wasting cycles choosing and re-choosing various technologies and configurations. Plus, because Redwood is a proper framework, you benefit from continued performance and feature upgrades over time and with minimum effort. > **TUTORIAL:** The best way to get to know Redwood is by going through the > extensive [Redwood Tutorial](https://redwoodjs.com/docs/tutorial). Have fun! > **QUICK START:** You can install and run a full-stack Redwood application on > your machine with only a couple commands. Check out the [Quick > Start](https://redwoodjs.com/docs/quick-start) guide to get started. > **DOCS:** Visit the full [RedwoodJS > Documentation](https://redwoodjs.com/docs/introduction) for extensive reference > docs and guides. ## About Redwood is the latest open source project initiated by Tom Preston-Werner, cofounder of GitHub (most popular code host on the planet), creator of Jekyll (one of the first and most popular static site generators), creator of Gravatar (the most popular avatar service on the planet), author of the Semantic Versioning specification (powers the Node packaging ecosystem), and inventor of TOML (an obvious, minimal configuration language used by many projects). ## Technologies We are obsessed with developer experience and eliminating as much boilerplate as possible. Where existing libraries elegantly solve our problems, we use them; where they don't, we write our own solutions. The end result is a JavaScript development experience you can fall in love with! Here's a quick taste of the technologies a standard Redwood application will use: - [React](https://react.dev/) - [Vite](https://vitejs.dev/) - [Prisma](https://www.prisma.io/) - [Jest](https://jestjs.io/) - [Storybook](https://storybook.js.org/) - [Pino](https://getpino.io) If you'd like to use our optional built-in GraphQL API support, here's our stack: - [GraphQL](https://graphql.org/) - [GraphQL Yoga](https://www.graphql-yoga.com) - [Envelop](https://www.envelop.dev) - [Apollo Client](https://www.apollographql.com/docs/react) ## Roadmap A framework like Redwood has a lot of moving parts; the Roadmap is a great way to get a high-level overview of where the framework is relative to where we want it to be. And since we link to all of our GitHub project boards, it's also a great way to get involved! [Roadmap](https://redwoodjs.com/roadmap) ## Why is it called Redwood? _(A history, by Tom Preston-Werner)_ Where I live in Northern California there is a type of tree called a redwood. Redwoods are HUGE, the tallest in the world, some topping out at 115 meters (380 feet) in height. The eldest of the still-living redwoods sprouted from the ground an astonishing 3,200 years ago. To stand among them is transcendent. Sometimes, when I need to think or be creative, I will journey to my favorite grove of redwoods and walk among these giants, soaking myself in their silent grandeur. In addition, Redwoods have a few properties that I thought would be aspirational for my nascent web app framework. Namely: - **Redwoods are beautiful as saplings, and grow to be majestic.** What if you could feel that way about your web app? - **Redwood pinecones are dense and surprisingly small.** Can we allow you to get more done with less code? - **Redwood trees are resistant to fire.** Surprisingly robust to disaster scenarios, just like a great web framework should be! - **Redwoods appear complex from afar, but simple up close.** Their branching structure provides order and allows for emergent complexity within a simple framework. Can a web framework do the same? And there you have it. ## Contributors _A gigantic "Thank YOU!" to everyone below who has contributed to one or more Redwood projects: [Framework](https://github.com/redwoodjs/redwood), [Website](https://github.com/redwoodjs/sprout), [Docs](https://github.com/redwoodjs/redwood/tree/main/docs), and [Create-Redwood Template](https://github.com/redwoodjs/redwood/tree/main/packages/create-redwood-app/template). 🚀_ ### Core Team: Leadership

_{Amy Haywood Dutton}

_{David Price}

_{Tobbe Lundberg}

_{Tom Preston-Werner}

### Core Team: Maintainer and Community Leads

_{David Thyresson}
_maintainer

_{Daniel Choudhury}
_maintainer

_{Keith T Elliot}
_community

_{Barrett Burnworth}
_community

_{Josh GM Walker}
_maintainer

### Founders

_{Tom Preston-Werner}

_{Peter Pistorius}

_{Rob Cameron}

_{David Price}

### Core Team: Alumni

_{Aldo Bucchi}	_{Aditya Pandey}	_{Amanda Giannelli}	_{Alice Zhao}	_{Simon Gagnon}
_{Chris van der Merwe}	_{Ryan Lockard}	_{Peter Colapietro}	_noire.munich	_{Forrest Hayes}
_Robert	_{Anthony Campolo}	_{Claire Froelich}	_{Kim-Adeline Miguel}	_{Dominic Saadi}
_{Kris Coulson}

### All Contributors

_{Anton Moiseev}	_{Mohsen Azimi}	_{Christopher Burns}	_{Terris Kremer}	_{James George}
_{Brett Jackson}	_{Guilherme Pacheco}	_{Kasper Mikiewicz}	_{chris-hailstorm}	_Jai
_{Lachlan Campbell}	_{Satya Rohith}	_{Steven Normore}	_{Mads Rosenberg}	_{Ted Stoychev}
_eurobob	_Vikash	_{Adrian Mato}	_{Anirudh Nimmagadda}	_{Ben McCann}
_{Chris Ball}	_{Suvash Thapaliya}	_{Thieffen Delabaere}	_swyx	_{Max Leon}
_{Maxim Geerinck}	_{Niket Patel}	_0xflotus	_{Anthony Powell}	_{Aryan J}
_{Brian Ketelsen}	_{Dominic Chapman}	_{Evan Moncuso}	_{Georgy Petukhov}	_{Gianni Moschini}
_Giel	_{Jani Monoses}	_{Johan Eliasson}	_{Leonardo Elias}	_{Logan Houp}
_{Loren ☺️}	_{Mark Pollmann}	_{Matthew Leffler}	_{Michele Gerarduzzi}	_{Nick Gill}
_{Nicholas Joy Christ}	_{Olivier Lance}	_{Phuoc Do}	_{Rocky Meza}	_{Sharan Kumar S}
_{Simeon Griggs}	_{Taylor Milliman}	_{Zach Hammer}	_{Przemyslaw T}	_{Hemil Desai}
_{Alessio Montel}	_{Anthony Morris}	_Beto	_{Turadg Aleahmad}	_{Paul Karayan}
_Nikolas	_guledali	_{Yong Joseph Bakos}	_{Gerd Jungbluth}	_{James Highsmith}
_{Troy Rosenberg}	_{Amr Fahim}	_{dfundingsland}	_{Eduardo Reveles}	_{Jeffrey Horn}
_{matthewhembree}	_{Robert Bolender}	_{Shivam Chahar}	_{Aaron Sumner}	_{Alvin Crespo}
_{Chris Ellis}	_{Colin Ross}	_{Dennis Dang}	_{Derrick Pelletier}	_{Jeroen van Baarsen}
_{Matan Kushner}	_{Matthew Rathbone}	_{Michal Weisman}	_{Miguel Oller}	_{Mudassar Ali}
_{Nate Finch}	_{Paweł Kowalski}	_{Punit Makwana}	_{Scott Chacon}	_scott
_{Scott Walkinshaw}	_{Stephan van Diepen}	_bpenno	_{Tim Trautman}	_{Zachary McKenna}
_{Ryan Hayes}	_{Evan Weaver}	_cr1at0rs	_qooqu	_{Android Dev Notes}
_{Jeremy Kratz}	_{Monica Powell}	_{Ganesh Rane}	_{Ryan Doyle}	_{Matt Reetz}
_{Punit Makwana}	_shzmr	_esteban-url	_{Kurt Hutten}	_{António Meireles}
_{Brent Guffens}	_{Santhosh Laguduwa}	_{Marco Bucchi}	_{Johnny Choudhury-Lucas}	_{Steven Almeroth}
_lumenCodes	_{_robobunny}	_{Kevin Poston}	_{Davy Hausser}	_{Mohinder Saluja}
_Lamanda	_ryancwalsh	_{Nick Geerts}	_miku86	_Krisztiaan
_{Jonathan Derrough}	_Asdethprime	_{Brian Solon}	_{Chris Chapman}	_{Joël Galeran}
_Mariah	_{Tyler Scott Williams}	_{Vania Kucher}	_{Viren Bhagat}	_William
_{dcgoodwin2112}	_{Bennett Rogers}	_{Daniel O'Neill}	_{David Yu}	_{Adithya Sunil}
_{Edward Jiang}	_{Manuel Kallenbach}	_{Nick Schmitt}	_{Jon Meyers}	_{Matthew Bush}
_{Patrick Gallagher}	_{Himank Pathak}	_{Morgan Spencer}	_{Pedro Piñera Buendía}	_{Matt Sutkowski}
_{Justin Etheredge}	_{Zain Fathoni}	_{Shrill Shrestha}	_{Brent Anderson}	_{Vinaya Sathyanarayana}
_{Will Minshew}	_{Tawfik Yasser}	_{Sébastien Lorber}	_{Charlie Ray}	_{Kim, Jang-hwan}
_{TagawaHirotaka}	_{Andrew Lam}	_{Brandon DuRette}	_{Curtis Reimer}	_{Kevin Brown}
_{Nikolaj Ivancic}	_{Nuno Pato}	_{Renan Andrade}	_{Sai Deepesh}	_bl-ue
_{Sven Hanssen}	_{Mudassar Ali}	_{SangHee Kim}	_{Subhash Chandra}	_{KimSeonghyeon}
_{Zhihao Cui}	_{Kyle Corbitt}	_{Sean Doughty}	_{Zak Mandhro}	_bozdoz
_{Isaac Tait}	_Jace	_{Noah Bernsohn}	_{rene-demonsters}	_{Sergey Sharov}
_{Tim Pap}	_in-in	_mlabate	_{Pablo Dejuan}	_bugsfunny
_{Luís Pinto}	_{Leigh Halliday}	_{BlackHawkSigma}	_{Devin MacGillivray}	_{Francisco Jaramillo}
_{Orta Therox}	_{Tharshan Muthulingam}	_{Brian Liu}	_{allen joslin}	_{Ryan Wang}
_Vashiru	_{Ron Dyar}	_{Todd Pressley}	_{Zack Sheppard}	_AlbertGao
_vchoy	_{Daniel Macovei}	_{Peter Perlepes}	_{Benedict Adams}	_{Hampus Kraft}
_{Harun Kilic}	_{Mike Nikles}	_{Mohammad Shahbaz Alam}	_{Moulik Aggarwal}	_{Omar El-Domeiri}
_{Paul McKellar}	_{Sarthak Mohanty}	_{Justin Jurenka}	_{Jens Lindström}	_{Hampus Kraft}
_{Ryan Chenkie}	_{George Cameron}	_John	_{Shannon Smith}	_Bob
_facinick	_{Teodoro Villaneuva}	_{Sarvesh Limaye}	_{Shantanu Zadbuke}	_{Duke Manh}
_{Michael Marino}	_{Igor Savin}	_{Jacob Arriola}	_{Jingying Gu}	_{Tim Kolberger}
_nzdjb	_{Hannah Vivian Shaw}	_{usman kareemee}	_watway	_{Edward Mason}
_{Mateo Carriquí}	_kataqatsi	_{Jeff Schroeder}	_mnm	_BBurnworth
_Jonathan	_{Rishabh Poddar}	_{Vitalii Melnychuk}	_{Buck DeFore}	_{Kamarel Malanda}
_{Manuel Vila}	_{Arda TANRIKULU}	_{Tristan Lee}	_{Agustina Chaer}	_{Charles Tison}
_{Josema Sar}	_{Ken Greeff}	_{Wiktor Sienkiewicz}	_{Alejandro Frias}	_Aleksandra
_{Ian McPhail}	_{Kyle Stewart}	_{Laurin Quast}	_{Martin Juhasz}	_Odee
_{Stephen Handley}	_{Syeda Zainab}	_joriswill	_szainab	_twodotsmax
_{Michael Shilman}	_nickpdemarco	_{davidlcorbitt}	_ROZBEH	_{Anh Le (Andy)}
_IsaacHook	_{Matt Sears}	_MthBarber	_{Safi Nettah}	_dietler
_Guedis	_rkmitra1	_m3t	_{Brandon Bayer}	_{Matt Murphy}
_jessicard	_{Pete McCarthy}	_Philzen	_Vik	_{Carl Hallén Jansson}
_{Chen Liu}	_Manish	_{Zach Peters}	_{Benas Mandravickas}	_COCL2022
_Ella	_{Eric Kitaif}	_{Giuseppe Caruso}	_{Ian Walter}	_{Jedde Bowman}
_{Johan Eliasson}	_{Lee Staples}	_{Leo Thorp}	_{Matthieu Napoli}	_{Nik F P}
_Olyno	_{Robert Tirta}	_{The Ape Collector}	_ccnklc	_cremno
_dkmooers	_hbellahc	_{hello there}	_llmaboi	_{Changsoon Bok}
_{Kristoffer K.}	_{Justin Kuntz}	_{Paine Leffler}	_{Paul Venable}	_{Peter Chen}
_Yann	_{Andre Wruszczak}	_{Anton Mihaylov}	_{Miguel Parramón}	_{Fabio Lazzaroni}
_{Rushabh Javeri}	_{Anders Søgaard}	_kunalarya	_{Aleph Retamal}	_Alon
_{Bouzid Badreddine}	_{Charly POLY}	_{Guillaume Mantopoulos}	_{Jan Henning}	_{Jonas Oberschweiber}
_{Jordan Rolph}	_{Jorge Venegas}	_{Kolja Lampe}	_Leon	_Masvoras
_{Min ho Kim}	_{Pin Sern}	_{RUI OKAZAKI}	_{Syahrizal Ardana}	_craineum
_{hello there}	_{Matt Driscoll}	_paikwiki	_{Mark Wiemer}	_{Alex Hughes}
_{Erica Pisani}	_{Fatih Altinok}	_Kris	_{Krupali Makadiya}	_Malted
_{Michelle Greer}	_{Nikola Hristov}	_{Swarit Choudhari}	_Lina	_pwellner
_{Jay O'Conor}	_{Stan Duprey}	_{Victor Savkin}	_{Łukasz Sowa}	_{Andrew Lam}
_{Daniel Jalkut}	_Eli	_NoahC5	_{Tommy Marshall}	_{Zachary Vander Velden}
_pantheredeye	_{Kirby Douglas Ellingson}	_{Sergio Guzman}	_{Eric Howey}	_{Erik Guzman}
_{IRSHAD WANI}	_Niall	_{Nikola Hristov}	_{Rui Okazaki}	_{Sunjay Armstead}
_Justin	_{kam c.}	_makdeb	_payapula	_willks
_{Josh GM Walker}	_{Ari Mendelow}	_{Jake Zhao}	_psirus0588	_{Eric Rabinowitz}
_{Maximilian Raschle}	_{nikolaxhristov}	_{Alon Bukai}	_{Han Ke}	_{Matt Chapman}
_{Rowin Mol}	_{Christopher Burns}	_{Alex Lilly}	_dphuang2	_{Daniel Escoto}
_{James Hester}	_{Guillaume Mantopoulos}	_{Linus Timm}	_{Mina Abadir}	_{Tom Dickson}
_Tyler	_{Christian Bergschneider}	_{Emre Erdoğan}	_{Toshinori Tsugita}	_{Ajit Kumar Goel}
_{Tai Vo}	_{Sam Huang}	_{Stefanos Anagnostou}	_dennemark	_{Aaron Rackley (EverydayTinkerer)}
_{Brent Scheibelhut}	_{Cal Courtney}	_{Jai Srivastav}	_Tilmann	_cheddar
_{Bryan Clark}	_{Carl Lange}	_{Chris Davis}	_{David Kus}	_Flouse
_{Hannes Tiede}	_Lucas-Bide	_{Martin Váňa}	_{Chris Rogers}	_{Samanvay Karambhe}
_{alireza rais sattari}	_aslaker	_{zach-withcoherence}	_tuxcommunity	_Ted
_{Dalton Craven}	_{Drikus Roor}	_Eka	_ModupeD	_{Nemi Shah}
_{Rodrigo Medina}	_{Russell Anthony}	_{Jason Daniel}	_{ray hatfield}	_swyx.io
_BWizard06	_Bigood	_{Cristi Ciobanu}	_{Gilliard Macedo}	_{Lee Ravenberg}
_{Matthew Phillips}	_{Rui Lima}	_{Sheng Chou}	_yahhuh

Redwood projects _(mostly)_ follow the [all-contributions](https://allcontributors.org/) specification. Contributions of any kind are welcome.