redwood

Redwood

by Tom Preston-Werner, Peter Pistorius, Rob Cameron, David Price, and more than 250 amazing contributors (see end of file for a full list).

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!

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.

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. 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 guide to get started.

DOCS: Visit the full RedwoodJS Documentation 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
• Vite
• Prisma
• Jest
• Storybook
• Pino

If you'd like to use our optional built-in GraphQL API support, here's our stack:

• GraphQL
• GraphQL Yoga
• Envelop
• Apollo Client

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

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, Website, Docs, and Create-Redwood 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 specification. Contributions of any kind are welcome.