yepyep v0.0.2

npm i hypr -g

This project is alpha, so I don't recommend using it in production yet. I welcome all ideas, critiques, and PRs :)

features

• static page generation
• server side rendering
• client-side application bundle
• css compilation w/ PostCSS
• routing
• state management
• builds to lambda function
• "hello world" 50kb gzipped
• pick and choose build type
  • client + static
  • static + SSR
  • SSR + API
  • SSR + client
  • static
  • etc

beta roadmap

• production server for non lambda envs
• prefetch route API
• plugins
  • think like better css-in-js support, sass, babel config, etc
• named 404.html support

usage

hypr build

hypr watch

setup

routes/Home.js

import React from 'react'

export const pathname = '/'
export function view () {
  return <h1>Hello World</h1>
}

routes.js

import React from 'react'
import Home from '@routes/Home.js'

export default [ Home ]

client.js

import React from 'react'
import { client } from 'hypr'
import routes from '@routes.js'

client(routes, { title: 'hello world' })(document.getElementById('root'))

server.js

import React from 'react'
import { server } from 'hypr'
import routes from '@routes.js'

export default server(routes, { title: 'hello world' })

static

To render a route statically, define a config() for biti.

routes/Home.js

import React from 'react'

export const pathname = '/'
export function config () {
  return {
    state: { title: 'homepage' }
  }
}
export function view ({ state }) {
  return <h1>{state.title}</h1>
}

data loading

A load() export will be resolved on both the server and client before rendering the view. The returned object should match biti API as well. Any props on the state object returned will be merged with application state.

During a static render, load is not called.

routes/Home.js

import React from 'react'

export const pathname = '/'
export function config () {
  return load()
}
export function load (state, req) {
  return {
    state: { title: 'loaded title' }
  }
}
export function view ({ state }) {
  return <h1>{state.title}</h1>
}

routing

hypr comes with routing built in. Use the Link export to navigate throughout your app.

routes/Home.js

import React from 'react'
import { Link } from 'hypr'

export const pathname = '/'
export function config () {
  return load()
}
export function load (state, req) {
  return {
    state: { title: 'loaded title' }
  }
}
export function view ({ state }) {
  return (
    <>
      <h1>{state.title}</h1>

      <nav>
        <Link href='/'>home</Link>
        <Link href='/about'>about</Link>
      </nav>
    </>
  )
}

state

hypr comes with state management built in also. Use the withState export to pass state to individual components. Refer to the picostate docs for more info.

components/ChangeTitle.js

import React from 'react'
import { withState } from 'hypr'

export default withState(state => ({
  myTitle: state.title
}))(
  function ChangeTitle ({ myTitle, hydrate }) {
    return (
      <button onClick={() => {
        hydrate({ title: 'new title' })()
      }}>update title</button>
    )
  }
)

routes/Home.js

import React from 'react'
import { Link, withState } from 'hypr'
import ChangeTitle from '@/components/ChangeTitle.js'

export const pathname = '/'
export function config () {
  return load()
}
export function load (state, req) {
  return {
    state: { title: 'loaded title' }
  }
}
export function view ({ state }) {
  return (
    <>
      <h1>{state.myTitle}</h1>

      <ChangeTitle />

      <nav>
        <Link href='/'>home</Link>
        <Link href='/about'>about</Link>
      </nav>
    </>
  )
}

motivation

This will be a blog post, but think Next plus Gatsby.

contributing

Wowee would I welcome some help :)

the name

Massive thanks to idmitriev for passing on the name, very kind of them :)

license

MIT © 2019 Eric Bailey