Funkophile

The _func_tional file processor.

Funkophile is a lightweight, functional build tool that processes files using Redux selectors. It can operate in both build and watch modes, making it perfect for static site generation, asset pipelines, and other file transformation tasks.

Key Features

• Functional Architecture: Uses Redux for state management and Reselect for efficient memoized computations
• File Watching: Automatically rebuilds when input files change
• Development Server: Built-in HTTP server for previewing output
• Flexible Input/Output: Define input patterns and output transformations using pure functions
• No Plugins Needed: Everything is configured through code using familiar Redux patterns

How It Works

1. Inputs: Define glob patterns to watch for input files
2. Processing: Files are read into the Redux store
3. Transformation: Custom selector functions process the file contents
4. Output: Results are written to the output directory

Example Usage

import funkophile from 'funkophile';
import { contentsOfFiles } from './funkophileHelpers';

const config = {
  mode: 'watch', // or 'build'
  initialState: {},
  options: {
    inFolder: 'src',
    outFolder: 'dist',
    port: 8080
  },
  encodings: {
    'utf8': ['html', 'css', 'js', 'txt', 'md'],
    'binary': ['png', 'jpg', 'jpeg', 'gif', 'ico']
  },
  inputs: {
    html: '**/*.html',
    css: '**/*.css',
    images: '**/*.{png,jpg,jpeg,gif}'
  },
  outputs: ({ html, css, images }) => ({
    // Output processed HTML files
    'index.html': contentsOfFiles(html),
    // Bundle all CSS into one file
    'styles.css': contentsOfFiles(css),
    // Copy images as-is
    ...Object.keys(images).reduce((acc, key) => ({
      ...acc,
      [key.replace('src/', '')]: images[key]
    }), {})
  })
};