FormSharp
This is very much work in progress - here be killer bunnies, but they're quickly being pacified
FormSharp aims to take the drudgery out of creating data entry forms in F# by taking care of all the plumbing and presentation and hiding it behind a DSL. I've found myself in a couple of situations where I've had to build broad data entry systems and writing and maintaining this code manually will kill a small team.
The aim is to allow forms to be defined using a fairly simple and abstract DSL:
That can then be executed in different runtimes / environments using an appropriate renderer / executer:
Keeping a few goals in mind as I work on it:
- Support for multiple runtimes initially React, plain JavaScript and Spectre (console).
- Support for multiple and custom renderers.
- Easy to use - its supposed to save effort, not create effort.
The code is emerging from a production system and a poc and so is of varying quality and is definitely subject to significant change.
If you want to take a look at how it works best place to start is with the Fable.React.Tailwind.Sample app.
Docs to follow as I build it out.
I was really tempted to call it Phorm but their are some Phorm-esque things in PHP land.
Tests
Running the tests requires the installation of Playwright for .NET.
Things to do
In a rough order.
Order is wherever fun takes me!
- Documentation
- GitHub Action for package release and initial package publish
- Token injection for API calls (skeleton is their)
- Additional components - radio buttons, text areas
- Add a Bootstrap renderer to the React package
- Add a Bulma renderer to the React package
- Add a vanilla HTML (no React) package (Tailwind and Bootstrap)
- Bring the Spectre support into the public repo from my poc
Request for features, help and bug fixes
Sure. Go ahead. Issues and discussions are open. But I may ask for money in return. Releasing OSS doesn't come with any obligation and although some people seem to live in a world where money isn't needed most of us have a mortgage and bills to pay.
Contributing
Best to speak to me first as I'm changing things a lot at the moment.
License
Available under MIT. See the LICENSE file.