Need a general troubleshooting section to list some solutions to common issues (especially around NPM) that people are having.

See for example: frctl/fractal#85

Make the documentation searchable.

Swap string concatenation for path.join in all places.

Hi,

I've ran gulp fractal:start and gulp fractal:build and both times I am getting an error with this cachebust.json.

I've looked in your repo and can't find this file, is this something that needs to be installed independently?

Hi All I have a js file that is getting all of its content through the import function via modules.

It looks something like this

/**

• App Entry Point
  */

/* global $ */

// Load site fonts
import './libs/fonts';

// import js libaries that require global scope such as jQuery, jQuery-Migrate, Foundation, etc
import './libs/global-includes';

// import the Module Controller and instantiate it
import ModuleController from './modules/module-controller';
const MC = new ModuleController();

$(document).ready(() => {
MC.loadModules($('html'));
});

However when I try and load this file into the fractal preview I get the unexpected token error import error. Is this a known issue? Is there a work around for people who have set up their projects this way ?

A good deal of the component functionality relies on JS

Currently uses Clearleft's internal Elf tool for deployment. Would be nice to:

1. automate deployment when the repo is updated
2. do so using open source, non-proprietary tools if possible.

Hi @allmarkedup

I'm just getting started with my first opportunity to use Fractal on a real project. Noticed a slight typo/issue in these docs.

Line 128 or 132 must be incorrect of this file: 08-docs/01-index.md. Is it a 'slash' or an 'underscore' that will escape expressions?

My second question, is that true for Nunjucks expressions as well? (assuming so). Not had chance to test yet.

In your using the api example, the result of this line:

const options = Array.from(arguments).pop();

Is a string which is the full path to my fractal instance. So, when it tries to use options.fn() in this line:
ret = ret + "<li>" + options.fn(component.toJSON()) + "</li>";
options.fn is undefined

is the example code still valid?

Hi, I blew away my project and recloned it. When running gulp fractal:build I get the same error for all components

"✘ Error loading data file C:\xampp\htdocs\stsci-frontend\build\src\panini\partials\components\side-nav.config.yml: Cannot read property 'toLowerCase' of undefined"

The configs are on the same level as their html counterparts and they look like:
accordion.config.yml

context:
accordion:
-
accordion-title: "Collapsed Drawer Tab"
id: "Test"
sections:
-
section:
content: "Some Stuff"
etc.

The build finished and has all the components in the web ui but there is no context data, rendered html, notes

How can I resolve this error this was working before.

Currently documentation for the following is still required:

• Living documentation
• Production integration
• Test tool integrations?
• Using a file other than fractal.js
• Assets....
• All API docs!!