A Fable app that provides helpful tracking and reference aids for Car Wars, by Steve Jackson Games. Fable Car Wars is not affiliated with Steve Jackson Games in any way, and uses the Car Wars trademark without permission.
F# JavaScript CSS HTML
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.paket
.vscode
css
public
src
.editorconfig
.gitignore
CarWars.fsproj
NuGet.Config
README.md
package.json
paket.dependencies
paket.lock
paket.references
webpack.config.js
yarn.lock

README.md

Dev environment and tools

Dotnet

You'll be using the dotnet command to build and run this project, so it's essential. Make sure not to use dotnet 2.x, because it's so new that it can't build this month old project. I'm running dotnet 1.1.0 (although dotnet --version says it's 1.0.3, because dotnet versioning is a goddamn nightmare).

Yarn

Yarn is a package manager for JavaScript. By default, Fable 1.0 uses it for package management. I don't think version matters here, just use the latest.

Code + Ionide

This one isn't actually required, but I've put some work into the setup to make using Visual Studio Code and the Ionide plugin a nice workflow. If you're using Code and Ionide you get tooltip support, Intellisense, Code Lens, and you can start the watch server by just pressing Ctrl + Shift + B (after doing package restoration, see following section).

However, if you decide to work without using Code, you can still build by following the directions below.

Build and running the app

  1. Install npm dependencies: yarn install
    • fsevents might fail to install. That's normal and fine.
  2. Install dotnet dependencies: dotnet restore
  3. Start Fable server and Webpack dev server: dotnet fable npm-run start
    • This step does have a fairly long startup time, so don't be worried if it seems like it might be hung for a few minutes.
  4. In your browser, open: http://localhost:8080/

Any modification you do to the F# code will be reflected in the web page after saving.

Technologies in use

F#

There's a great F# tutorial available at F# for fun and profit.

Fable

Fable is the transpiler this project uses to convert F# into JavaScript. We're using the 1.0 beta, but the documentation at the website is still good enough.

Fable-elmish

Fable-elmish is a front end framework written for Fable and based off the Elm architecture (which honestly doesn't seem important enough to warrant its own name, since it's basically MVC). I like it because it lets you define your app view using F# that directly maps to HTML, so you can type check it and shit. The official documentation at their Github seems nice, but I haven't read it yet. This tutorial I found here was a decent tutorial, but they made their Fable setup by scratch and I hydrated mine from a template, so there are some differences (like their files being .fsx files and mine being .fs files).

To-do list

  • In the active game, don't make car modifications live until the Next Phase button is clicked.
    • Maybe. There are reasons to modify these stats immediately.
  • Everything should probably be collapsible.