zephyr

module
v0.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 30, 2021 License: MIT

README

Zephyr

Zephyr is a reactive frontend Go framework based on core ideas from React and Vue 3. The purpose of this project is to provide an easy to use WebAssembly reactive framework API, to further test the technologies features and capabilities. Some experienced Gophers may have more technical questions, and to them I extend an invitation to read the FAQ on the Zephyr website.

This package uses the unsafe and syscall/js APIs, both of which are subject to change. All part of the library that use

This document is a WIP, I'll be getting er done as the features get done. The checklist is up to date though.

Acknowledgements

Design Philosophies and Goals

  • Beginner-friendly - Easy for people coming over from JS and beginners alike
  • Accessible and responsive first - Default APIs provide size breakpoints,
  • Make it Go - The Zephyr templating language is meant to be written in a way that mimics how Go code is written. There are a few abstractions to make frontend development easier, but for the most part, just write Go as you normally would. The entire templating language and build process is optional, if you prefer to use just Go, go ahead!
  • Robust tooling
  • Intuitive abstractions

Documentation


Installation

To install Zephyr, just go get it: go get -u github.com/zaviermiller/zephyr && go install zephyr. This will install the zephyr package and then install the Zephyr CLI tool.

There are two main ways to develop an app with Zephyr: pure Go and the Zephyr dev environment.

Benchmarks


Features and Roadmap

These are the concrete features currently offered and planned by the Zephyr API:

  • Reactive data API
  • Component API
  • Asynchronous runtime
  • One-way data flow between components as props
  • TinyGo support
  • Vue-based DOM updates (initial pass)
  • Two-way data flow with DOM and Component Events
  • Conditional and iterative rendering
  • Lifecycle hooks (OnInit, OnMount, OnRerender, OnDeactivate, On)
  • Zephyr CLI tool (create, dev, build, test)
  • Width breakpoint APIs
  • Testing framework
  • Zephyr dev environment
  • Vue-based .zefr compiler
  • Vue-based slots
  • Accessible-only build
  • Easy Dockerization
  • Support using any Go package in Components
  • Plugins
  • Routing plugin (separate import)
  • GraphQL plugin (seperate import)
  • JS adapter plugin (for interacting with data in JS)
  • Content plugin (seperate import, requires SSG)
  • Very simple Material UI plugin (separate import)
  • Support build targets: SSR, SPA, SSG
  • Easy integration with existing Go server frameworks (Confetti, Gin, Chi, etc...)
  • Chrome dev tools
    • Component inspector
    • State manager
    • More
  • Better tree-diffing
  • Remove vDOM?

Issues

Directories

Path Synopsis
examples
pkg
core
This file is responsible for implementing the bulk of the so-called "virtual DOM".
This file is responsible for implementing the bulk of the so-called "virtual DOM".

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL