remix-easy-mode2
TypeScript icon, indicating that this package has built-in type declarations

0.1.0-beta.0 • Public • Published

remix-easy-mode

Description

Opinionated toolkit for developing highly interactive, typesafe Remix apps. Built with zod, and inspired by the TRPC / React Query DX (type-safety + react-query style "on settled" mutation callbacks), plus a few extra goodies (such as typesafe form helpers with automatic client-side validations).

Features

  • Automatic form validations (client-side and server-side)
  • Typesafe form inputs and data responses via helper components / hooks
  • Typesafe session middleware support (via "bouncer" pattern)
  • Typesafe session and input values passed to server-side callbacks
  • Automatic error handling and error message display
  • Component helpers are unstyled, so you can style them however you want

Installation

npm i remix-easy-mode zod

Video Tutorial

https://www.youtube.com/watch?v=CxrtfHbXKuM

Usage

Example resource route:

import type { DataFunctionArgs } from "@remix-run/server-runtime"
import { dataFunctionHelper, useAction } from "remix-easy-mode"
import { z } from "zod"

const schema = z.object({
  someUserInput: z.string(),
})

export const action = (ctx: DataFunctionArgs) => {
  return dataFunctionHelper({
    ctx,
    schema,
    bouncer: async ({ ctx, csrfToken }) => {
      // do whatever you want here
      // throw an error if something is wrong
    },
    fn: async ({ input, session }) => {
      // do whatever you want here
      return "Wow, that was easy!" as const
    },
  })
}

// return hook from your resource route to use on client
export const useExampleHook = () => {
  return useAction<typeof action, typeof schema>({
    path: "/resource-route",
    schema,
    onSuccess: (data) => console.log(data),
  })
}

Example client-side form:

import { useExampleHook } from "./resource-route"

export default function Index() {
  const { Form, fields, submit, result } = useExampleHook()

  return (
    <div>
      <Form onSubmit={({ input }) => submit({ input })}>
        <input name={fields.someUserInput.name} />
        <button type="submit">Submit</button>
      </Form>

      <pre>{JSON.stringify(result, null, 2)}</pre>
    </div>
  )
}

Example App

To run the example app:

pnpm install
cd packages/example
pnpm run dev

Then visit localhost:3000.

License

MIT

Caveats

  • This is a work in progress. It's not yet battle-tested, and the API may change without notice. If you want to use this in production, set your dependency to a specific version.

Package Sidebar

Install

npm i remix-easy-mode2

Weekly Downloads

0

Version

0.1.0-beta.0

License

MIT

Unpacked Size

27.1 kB

Total Files

6

Last publish

Collaborators

  • sjc5