next-parade

🚩 Parade!

Lightweight UI component stories and documentation showcase for Next.js.

⚠️ Pre-alpha: This is a proof-of-concept. You will be disappointed!

Why?
It's easy and fast.
No additional steps in CI/CD.
No need to align webpack config.

Usage

npm install next-parade
yarn add next-parade

Configure and render it on a page:

// ./pages/index.js
import parade from 'next-parade'
import withStaticProps from 'next-parade/props'

const context = require.context('../src/components', true, /\.js/) // relative path and regex
export default parade(context)
export const getStaticProps = withStaticProps(context, 'src/components') // context and "absolute" path

By convention React Component should be the default export from a file.

Prior art

• Storybook - runs on top of 'create-react-app'
• Docz - runs on Gatsby. It's where I copied lib/docgen from
• Styleguidist - looks slim and promising. I did not have the opportunity use it nor to dive in it's code yet.

Idea behind this project is to prove that something simillar can be done running on Next.js

Advanced example

// ./pages/showcase.tsx
import { GetStaticProps } from 'next'
import parade from 'next-parade'
import withStaticProps from 'next-parade/props'
import styles from '../styles/Home.module.css'

const context = require.context('../components', true, /\/[A-Z]\w\.tsx/)
const ComponentsParade = parade(context)

const Home = ({ ...props }) => (
  <div className={styles.container}>
    <ComponentsParade
      {...props}
      title="Styleguide"
      style={{ maxWidth: '600px' }}
    />
  </div>
)

export default Home

export const getStaticProps: GetStaticProps = async (context) => {
  const output = withStaticProps(context, 'components')
  return {
    ...output,
    props: {
      ...output.props,
      // additional props and overrides
    },
  }
}

Development

npm run dev
yarn dev

Open http://localhost:3000 with your browser to see the result.

This project is using itself for creating it's documentation.

Roadmap

• live edit props
• parse markdown
• order of elements (sort)
• add "last build" to website