feat: Initialize project with Fable, Vite, and Tailwind CSS setup

- Added package.json with necessary scripts and dependencies for development.
- Created Docs.fsproj for F# project structure.
- Implemented multiple pages for documentation including BorderRadius, BoxShadow, FontSize, Install, JustifyContent, JustifyItems, TextAlign, and Use.
- Added index.css for styling with Tailwind and FontAwesome.
- Created index.html as the entry point for the application.
- Configured Vite for building and serving the application with React and Tailwind CSS support.

Author: Tim Forkmann

.github/workflows/docs.yml

@@ -1,30 +1,49 @@
-name: Release docs
+name: Docs
 
 on:
+  workflow_dispatch:
   push:
-    tags:
-    - '*'
-
+    branches: [ main ]
+    paths:
+      - 'src/Docs/**'
+      - '.github/workflows/Docs.yml'
 jobs:
   build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v2
+
+      - name: Setup .NET 9 SDK
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 9.0.201
+
+      - name: Install Tools
+        run: dotnet tool restore
+
+      - name: Build
+        run: dotnet run -- PublishDocs
 
-    runs-on: windows-latest
+      - name: Publish Docs
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs
+          path: publish/docs
 
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
     steps:
-    - name: Checkout
-      uses: actions/checkout@v2
-    - name: Setup .NET Core
-      uses: actions/setup-dotnet@v1
-      with:
-        dotnet-version: 9.0.203
-    - name: Restore tools
-      run: dotnet tool restore
-    - name: Run Fornax
-      run: dotnet run -- PublishDocs
-    - name: Deploy
-      uses: peaceiris/actions-gh-pages@v3
-      with:
-        personal_token: ${{ secrets.GITHUB_TOKEN }}
-        publish_dir: ./docs/_public
-        publish_branch: gh-pages
-        force_orphan: true
+      - name: Download app artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: docs
+          path: docs
+      - name: Deploy
+        uses: JamesIves/github-pages-deploy-action@3.7.1
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          BRANCH: gh-pages
+          FOLDER: docs
+          CLEAN: true

Build.fs

@@ -10,6 +10,10 @@ open Fake.IO.FileSystemOperators
 open Fake.IO.Globbing.Operators
 open Fake.Tools
 open Helpers
+
+open BuildHelpers
+open BuildTools
+
 initializeContext()
 
 //-----------------------------------------------
@@ -219,20 +223,12 @@ Target.create "Push" (fun _ -> pushPackage [] )
 let docsSrcPath = Path.getFullName "./src/docs"
 let docsDeployPath = "docs"
 
-Target.create "InstallDocs" (fun _ ->
-
-    runTool yarnTool "install --frozen-lockfile" docsSrcPath
-    runDotNet "restore" docsSrcPath )
-
 Target.create "PublishDocs" (fun _ ->
-    let docsDeployLocalPath = (docsSrcPath </> "deploy")
-    [ docsDeployPath; docsDeployLocalPath] |> Shell.cleanDirs
-    runTool yarnTool"webpack-cli -p" docsSrcPath
-    Shell.copyDir docsDeployPath docsDeployLocalPath FileFilter.allFiles
+    Tools.npm "run build" ""
 )
 
-
-Target.create "RunDocs" (fun _ -> runTool npmTool "webpack-dev-server" docsSrcPath)
+Target.create "RunDocs" (fun _ ->
+    Tools.npm "run start" "")
 
 Target.runOrDefault "Build"
 

Build.fsproj

@@ -4,7 +4,8 @@
     <TargetFramework>net9.0</TargetFramework>
   </PropertyGroup>
   <ItemGroup>
-    <Compile Include="Helpers.fs" />
+    <Compile Include="BuildHelpers.fs" />
+    <Compile Include="BuildTools.fs" />
     <Compile Include="Build.fs" />
   </ItemGroup>
   <Import Project=".paket\Paket.Restore.targets" />

Helpers.fs BuildHelpers.fsHelpers.fs renamed to BuildHelpers.fs

@@ -1,6 +1,7 @@
-module Helpers
+module BuildHelpers
 
 open Fake.Core
+open Fake.DotNet
 
 let initializeContext () =
     let execContext = Context.FakeExecutionContext.Create false "build.fsx" [ ]
@@ -71,29 +72,6 @@ let createProcess exe arg dir =
     |> CreateProcess.withWorkingDirectory dir
     |> CreateProcess.ensureExitCode
 
-let dotnet = createProcess "dotnet"
-let npm =
-    let npmPath =
-        match ProcessUtils.tryFindFileOnPath "npm" with
-        | Some path -> path
-        | None ->
-            "npm was not found in path. Please install it and make sure it's available from your path. " +
-            "See https://safe-stack.github.io/docs/quickstart/#install-pre-requisites for more info"
-            |> failwith
-
-    createProcess npmPath
-
-let yarn =
-    let yarnPath =
-        match ProcessUtils.tryFindFileOnPath "yarn" with
-        | Some path -> path
-        | None ->
-            "npm was not found in path. Please install it and make sure it's available from your path. " +
-            "See https://safe-stack.github.io/docs/quickstart/#install-pre-requisites for more info"
-            |> failwith
-
-    createProcess yarnPath
-
 let run proc arg dir =
     proc arg dir
     |> Proc.run
@@ -104,11 +82,11 @@ let runParallel processes =
     |> Proc.Parallel.run
     |> ignore
 
-let runOrDefault args =
+let runOrDefault defTarget args =
     try
         match args with
         | [| target |] -> Target.runOrDefault target
-        | _ -> Target.runOrDefault "Run"
+        | _ -> Target.runOrDefault defTarget
         0
     with e ->
         printfn "%A" e

BuildTools.fs

@@ -0,0 +1,34 @@
+module BuildTools
+
+open Fake.Core
+open Fake.DotNet
+
+module Tools =
+    let private findTool tool winTool =
+        let tool = if Environment.isUnix then tool else winTool
+        match ProcessUtils.tryFindFileOnPath tool with
+        | Some t -> t
+        | _ ->
+            let errorMsg =
+                tool + " was not found in path. " +
+                "Please install it and make sure it's available from your path. "
+            failwith errorMsg
+
+    let private runTool (cmd:string) args workingDir =
+        let arguments = args |> String.split ' ' |> Arguments.OfArgs
+        Command.RawCommand (cmd, arguments)
+        |> CreateProcess.fromCommand
+        |> CreateProcess.withWorkingDirectory workingDir
+        |> CreateProcess.ensureExitCode
+        |> Proc.run
+        |> ignore
+
+    let dotnet cmd workingDir =
+        let result =
+            DotNet.exec (DotNet.Options.withWorkingDirectory workingDir) cmd ""
+        if result.ExitCode <> 0 then failwithf "'dotnet %s' failed in %s" cmd workingDir
+
+    let femto = runTool "femto"
+    let node = runTool (findTool "node" "node.exe")
+    let yarn = runTool (findTool "yarn" "yarn.cmd")
+    let npm = runTool (findTool "npm" "npm.cmd")

Fumble.sln

@@ -10,21 +10,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{ACBEE43C
 EndProject
 Project("{6EC3EE1D-3C4E-46DD-8F32-0CC8E7565705}") = "Fumble.Tests", "tests\Fumble.Tests\FumbleTests.fsproj", "{1CA2E092-2320-451D-A4F0-9ED7C7C528CA}"
 EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{7594D4D1-487B-4686-83B0-BC0955E5B677}"
-	ProjectSection(SolutionItems) = preProject
-		.gitattributes = .gitattributes
-		.gitignore = .gitignore
-		.travis.yml = .travis.yml
-		appveyor.yml = appveyor.yml
-		build.cmd = build.cmd
-		build.fsx = build.fsx
-		build.sh = build.sh
-		LICENSE.md = LICENSE.md
-		paket.dependencies = paket.dependencies
-		paket.lock = paket.lock
-		README.md = README.md
-		RELEASE_NOTES.md = RELEASE_NOTES.md
-	EndProjectSection
+Project("{F2A71F9B-5D33-465A-A702-920D77279786}") = "Docs", "src\Docs\Docs.fsproj", "{63297B98-5CED-492C-A5B7-A5B4F73CF142}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
@@ -36,6 +22,10 @@ Global
 		Release|x86 = Release|x86
 	EndGlobalSection
 	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{63297B98-5CED-492C-A5B7-A5B4F73CF142}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{63297B98-5CED-492C-A5B7-A5B4F73CF142}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{63297B98-5CED-492C-A5B7-A5B4F73CF142}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{63297B98-5CED-492C-A5B7-A5B4F73CF142}.Release|Any CPU.Build.0 = Release|Any CPU
 		{5D30E174-2538-47AC-8443-318C8C5DC2C9}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{5D30E174-2538-47AC-8443-318C8C5DC2C9}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{5D30E174-2538-47AC-8443-318C8C5DC2C9}.Debug|x64.ActiveCfg = Debug|Any CPU