redwoodjs / redwood

The App Framework for Startups
https://redwoodjs.com
MIT License
17.34k stars 997 forks source link
apollo graphql hacktoberfest jamstack prisma react

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:

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

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:

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.