close
The Wayback Machine - https://web.archive.org/web/20201021100327/https://github.com/blitz-js/blitz
Skip to content
canary
Go to file
Code

Latest commit

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com> (meta)
005edc0

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
Sep 18, 2020
Oct 16, 2020
Feb 17, 2020
Oct 16, 2020

README.md

Blitz.js

Image Image Image Image


The Fullstack React Framework

"Zero-API" Data Layer — Built on Next.js — Inspired by Ruby on Rails

Makes you far more productive than you ever dreamed was possible 😉

Read the Documentation


“Zero-API” data layer lets you import server code directly into your React components instead of having to manually add API endpoints and do client-side fetching and caching.

Includes everything you need for production apps. Everything end-to-end from the database to the frontend.

Blitz brings back the simplicity and conventions of server-rendered frameworks like Ruby on Rails while preserving everything we love about React and client-side rendering!


Quick Start

You need Node.js 12 or newer

Install Blitz

Run npm install -g blitz or yarn global add blitz

You can alternatively use npx

Create a New App

  1. blitz new myAppName
  2. cd myAppName
  3. blitz start
  4. View your baby app at http://localhost:3000



Architecture diagram



Features:
⚡️ Built on Next.js
⚡️ Don't have to build an API for client-side rendering
⚡️ Client-side rendering, Server-side rendering, and fully static pages all in the same app
⚡️ Full Typescript support with static, end-to-end typing (no code generation step needed like with GraphQL)
⚡️ React Concurrent Mode enabled
⚡️ Database/ORM agnostic, but Prisma 2 is default
⚡️ CLI with code scaffolding, Rails-style console REPL, etc
⚡️ GraphQL Ready
⚡️ Deploy serverless or serverful
⚡️ Highly secure authentication
⚡️ Authorization you can use on both server and client
⚡️ Recipes for easily adding libraries like Tailwind, CSS-in-JS, etc.

Other key features coming:
⚡️ Model validation you can use on both server and client
⚡️ React native support
⚡️ GUI so you don't have to use the CLI


The Foundational Principles

  1. Fullstack & Monolithic
  2. API Not Required
  3. Convention over Configuration
  4. Loose Opinions
  5. Easy to Start, Easy to Scale
  6. Stability
  7. Community over Code

The Blitz Manifesto explains these principles in detail.


What is Blitz Designed For?

Blitz is designed for tiny to large database-backed applications that have one or more graphical user interfaces.

While we currently only support web, we are pursuing the dream of a single monolithic application that runs on web and mobile with maximum code sharing and minimal boilerplate.


Welcome to the Blitz Community 👋

The Blitz community is warm, safe, diverse, inclusive, and fun! LGBTQ+, women, and minorities are especially welcome. Please read our Code of Conduct.

Join our Slack Community where we help each other build Blitz apps. It's also where we collaborate on building Blitz itself.

For questions and longer form discussions, post in our forum.

There's still a lot of work to do, so you are especially invited to join us in building Blitz! A good place to start is The Contributing Guide.


Financial Contributors

Your financial contributions help ensure Blitz continues to be developed and maintained! We have monthly sponsorship options starting at $5/month.

👉 View options and contribute at GitHub Sponsors, PayPal, or Open Collective

🌱 Seedling Sponsors

Image

🥉 Bronze Sponsors

Image

🥈 Silver Sponsors

Image

🏆 Gold Sponsors

Image

💎 Diamond Sponsors

Image

Core Team

Image
Brandon Bayer

Creator
Image
Rudi Yardley

Node.js Wizard
Image
Dylan Brookes

Friendly Generalist

Maintainers (Level 2)

Code ownership, pull request approvals and merging, etc (see MAINTAINERS.md)

Image
Adam Markon

CLI
Image
Robert Rosenberg

Website/Docs
Image
Simon Knott

SuperJSON

Maintainers (Level 1)

Issue triage, pull request triage, community encouragement and moderation, etc (see MAINTAINERS.md)

Image
Lori Karikari
Image
Corey Brown
Image
Jeremy Liberman
Image
Jaga Santagostino
Image
Satoshi Nitawaki
Image
Alexandru Stratulat
Image
Patrick Engelkes
Image
Jamie Davenport

Contributors

Thanks to these wonderful people (emoji key):

Image
Brandon Bayer

💻 🖋 🤔 👀
Image
Rudi Yardley

💻 🤔 👀 ⚠️
Image
Dylan Brookes

💻 🤔 👀 ⚠️ 📖
Image
Adam Markon

💻 🤔 👀 ⚠️ 🚧
Image
Corey Brown

💻 👀 🚧
Image
Lori Karikari

💻 👀 🚧 📖
Image
Elias Johansson

💻 👀 🚧
Image
Michael Edelman

🚇 💻
Image
Todd Geist

💵 💻
Image
Robert Rosenberg

💻 🚧 📖
Image
Beata Obrok

💻
Image
Tahir Awan

💻
Image
Camilo Gonzalez

💻
Image
Daniel Kempner

💻
Image
Giel

💻
Image
Jeremy Liberman

💻 🚧 ⚠️
Image
Jim Cummins

💻
Image
Kristina Matuška

🎨
Image
Jason Blalock

💻
Image
aej11a

💻
Image
marcoseoane

🤔
Image
Rishabh Poddar

🤔
Image
Lorenzo Rapetti

💻
Image
Justin Hall

💻 📖
Image
Sajjad Hashemian

💻
Image
Eduardo Lopes

💻
Image
Matthew Leffler

📖
Image
Matt

📖
Image
Sonny

📖
Image
Fran Zekan

💻 📖
Image
Jan Baykara

📖
Image
Mike Perry Y Attara

📖
Image
Devan

📖
Image
Jack Clancy

💻 🚧
Image
Nicolas Torres

⚠️ 💻 👀
Image
Simon Knott

💻 ⚠️ 🚧
Image
Jaga Santagostino

💻 📖 🚧
Image
João Portela

💻
Image
Da-Jin Chu

💻
Image
Shinobu Hayashi

💻
Image
Karan Kiri

💻
Image
Alan Long

📖
Image
codingsh

💻
Image
Rafael Nunes

👀 💻
Image
Simon Debbarma

🎨 🚧 📖
Image
0xflotus

💻 📖
Image
tmns

💻 📖
Image
Jru Harris

📖
Image
Ivan Medina

💻 🚧
Image
Dwight Watson

💻 📖
Image
Horie Issei

💻
Image
Nhat Khanh

💻
Image
Abu Uzayr

💻
Image
Nabiullah elham

💻
Image
Lachlan Campbell

💻
Image
Enzo Ferey

💻
Image
Pierre Grimaud

💻
Image
Andreas Adam

💻
Image
Kevin Tovar

💻
Image
Ante Primorac

💻 📖
Image
Mykal Machon

💻
Image
Jamie Davenport

💻 🚧
Image
GaneshMani

💻
Image
reymon359

💻
Image
gvasquez11

💻
Image
José Miguel Ochoa

💻
Image
Oscar Sirvent

💻 📖
Image
Daniel Molnar

📖 💻
Image
Kevin Wu Won

📖
Image
John Duong

💻
Image
Noah Fleischmann

💻
Image
Matsumoto Toshi

💻 📖
Image
Simon Edelmann

💻
Image
Shaun Church

📖 💻
Image
Steven

📖
Image
Sigurd Moland Wahl

💻
Image
Brian Andrews

📖
Image
Garrison Snelling

📖
Image
Ty Lange-Smith

💻
Image
Rubén Moya

💻 ⚠️
Image
robertgrzonka

💻 🚇
Image
Alex Orr

💻
Image
Chris Tse

💻
Image
Netto Farah

💻
Image
Rohan Julka

🚇
Image
Ivan Santos

💻
Image
Soumyajit Pathak

💻
Image
Sebastian Kurpiel

📖
Image
Steffan

💻 📖 💵
Image
Kristóf Poduszló

💻
Image
Weilbyte

💻 📖
Image
Ricardo Trejos

💻 📖
Image
George Karagkiaouris

💻 📖
Image
Brady Pascoe

💻
Image
Jirka Svoboda

💻
Image
Alan Alickovic

💻 📖
Image
Yngve Høiseth

📖
Image
Bruno Crosier

📖
Image
Johan Schepmans

💻
Image
Dillon Raphael

💻
Image
Cody G

💻 ⚠️
Image
madflow

📖
Image
Satoshi Nitawaki

💻 🚧 💬 📖
Image
sirmyron

📖 💻
Image
engelkes-finstreet

📖 💻 🚧
Image
Denis Radin

👀 💻 📖
Image
Michael Li

💻
Image
yuta0801

💻
Image
Obadja Ris

📖
Image
Jose Felix

💻
Image
John Cantrell

💻
Image
Kwuang Tang

💻
Image
John Letey

💻
Image
Juan Di Toro

💻
Image
Taylor Johnson

💻 📖
Image
Sriram Thiagarajan

📖
Image
Sergio Xalambrí

📖
Image
Patrick G

💻
Image
अभिनाश (Avinash)

💻
Image
Enrico Schaaf

💻
Image
Kitze

🤔
Image
Mohamed Shaban

💻
Image
Joris

💻
Image
Valentin Funk

📖
Image
Luke Bennett

💻
Image
Haseeb Majid

💻
Image
Phillipp Schmedt

💻
Image
Piotr Monwid-Olechnowicz

💻
Image
Kotaro Chikuba

💻 ⚠️
Image
Konrad Kalemba

💻
Image
Alucard17

💻
Image
Domantas Mauruča

⚠️ 💻
Image
Stratulat Alexandru

💻 🚧
Image
André Ericson

💻 📖
Image
Carlos Fernández

📖
Image
Kevin Østerkilde

📖
Image
aaronfulkerson

💻 💬
Image
Alexandru Naiman

💻
Image
David Ezekiel Lutta

💻
Image
wanjuntham

💻
Image
Victor Nahuel Chaves

💻
Image
Peter Shih

💻
Image
Seweryn Kalemba

💻
Image
Nikhil Saraf

💻
Image
Zane

📖
Image
Dulce Hernández

💻
Image
Mark Hähnel

💻

This project follows the all-contributors specification. Contributions of any kind welcome!

You can’t perform that action at this time.