Initial commit

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: RustForWeb
+open_collective: rustforweb

.github/labels.yml

@@ -0,0 +1,15 @@
+- name: 'type: bug'
+  description: 'Bug'
+  color: '3e63dd'
+- name: 'type: documentation'
+  description: 'Documentation'
+  color: '3e63dd'
+- name: 'type: feature'
+  description: 'Feature'
+  color: '3e63dd'
+- name: 'type: maintenance'
+  description: 'Maintenance'
+  color: '3e63dd'
+- name: 'type: question'
+  description: 'Question'
+  color: '3e63dd'

.github/renovate.json

@@ -0,0 +1,3 @@
+{
+    "extends": ["config:recommended", "schedule:weekly", ":prConcurrentLimitNone", ":prHourlyLimitNone"]
+}

.github/workflows/ci.yml

@@ -0,0 +1,54 @@
+name: CI
+
+on:
+    pull_request: {}
+    push:
+        branches:
+            - main
+
+env:
+    RUSTFLAGS: '-Dwarnings'
+
+jobs:
+    lint:
+        name: Lint
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Set up Rust toolchain
+              run: rustup toolchain install stable --no-self-update --profile default --target wasm32-unknown-unknown
+
+            - name: Set up Rust cache
+              uses: swatinem/rust-cache@v2
+              with:
+                  cache-on-failure: true
+                  save-if: ${{ github.ref == 'refs/heads/main' }}
+
+            - name: Check formatting
+              run: cargo fmt --all --check
+
+            - name: Lint
+              run: cargo clippy --all-features
+
+    test:
+        name: Test
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Set up Rust toolchain
+              run: rustup toolchain install stable --no-self-update --profile default --target wasm32-unknown-unknown
+
+            - name: Set up Rust cache
+              uses: swatinem/rust-cache@v2
+              with:
+                  cache-on-failure: true
+                  save-if: ${{ github.ref == 'refs/heads/main' }}
+
+            - name: Test
+              run: cargo test --all-features

.github/workflows/labels.yml

@@ -0,0 +1,17 @@
+name: Labels
+
+on:
+    workflow_dispatch:
+
+jobs:
+    sync-labels:
+        name: Sync Labels
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+              with:
+                  sparse-checkout: .github/labels.yml
+
+            - uses: EndBug/label-sync@v2
+              with:
+                  config-file: .github/labels.yml

.github/workflows/website.yml

@@ -0,0 +1,111 @@
+name: Website
+on:
+    pull_request: {}
+    push:
+        branches:
+            - main
+
+concurrency:
+    group: ${{ github.workflow }}-${{ github.ref }}
+    cancel-in-progress: false
+
+jobs:
+    book-test:
+        name: Test Book
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+
+            - name: Set up Rust toolchain
+              run: |
+                  rustup toolchain install stable --no-self-update --profile minimal
+                  rustup target add wasm32-unknown-unknown
+
+            - name: Set up Rust cache
+              uses: swatinem/rust-cache@v2
+              with:
+                  cache-on-failure: true
+                  save-if: ${{ github.ref == 'refs/heads/main' }}
+
+            - name: Install Cargo Binary Install
+              uses: cargo-bins/cargo-binstall@main
+
+            - name: Install mdBook
+              run: cargo binstall --force -y mdbook mdbook-tabs
+
+            - name: Run tests
+              run: mdbook test
+              working-directory: book
+
+    book-build:
+        name: Build Book
+        needs: book-test
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+
+            - name: Set up Rust toolchain
+              run: |
+                  rustup toolchain install stable --no-self-update --profile minimal
+                  rustup target add wasm32-unknown-unknown
+
+            - name: Set up Rust cache
+              uses: swatinem/rust-cache@v2
+              with:
+                  cache-on-failure: true
+                  save-if: ${{ github.ref == 'refs/heads/main' }}
+
+            - name: Install Cargo Binary Install
+              uses: cargo-bins/cargo-binstall@main
+
+            - name: Install mdBook
+              run: cargo binstall --force -y mdbook mdbook-tabs
+
+            - name: Install Node.js dependencies
+              run: npm install
+
+            - name: Build Book
+              run: mdbook build
+              working-directory: book
+
+            - name: Upload artifact
+              uses: actions/upload-artifact@v4
+              with:
+                  name: book
+                  path: book/book
+                  retention-days: 1
+                  if-no-files-found: error
+
+    deploy:
+        name: Deploy
+        needs: book-build
+        if: github.ref == 'refs/heads/main'
+        runs-on: ubuntu-latest
+        permissions:
+            contents: read
+            pages: write
+            id-token: write
+        steps:
+            - uses: actions/checkout@v4
+              with:
+                  fetch-depth: 0
+
+            - name: Download artifacts
+              uses: actions/download-artifact@v4
+              with:
+                  path: dist
+                  merge-multiple: true
+
+            - name: Setup Pages
+              uses: actions/configure-pages@v5
+
+            - name: Upload artifact
+              uses: actions/upload-pages-artifact@v3
+              with:
+                  path: dist
+
+            - name: Deploy to GitHub Pages
+              id: deployment
+              uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,166 @@
+# Created by https://www.toptal.com/developers/gitignore/api/rust,node
+# Edit at https://www.toptal.com/developers/gitignore?templates=rust,node
+
+### Node ###
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+### Node Patch ###
+# Serverless Webpack directories
+.webpack/
+
+# Optional stylelint cache
+
+# SvelteKit build / generate output
+.svelte-kit
+
+### Rust ###
+# Generated by Cargo
+# will have compiled files and executables
+debug/
+target/
+
+# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
+# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
+# Cargo.lock
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these, which store debugging information
+*.pdb
+
+# End of https://www.toptal.com/developers/gitignore/api/rust,node
+
+# mdBook
+book/book/
+
+# Tailwind CSS ouput
+tailwind.output.css

.pre-commit-config.yaml

@@ -0,0 +1,12 @@
+repos:
+    - repo: https://github.com/pre-commit/mirrors-prettier
+      rev: v3.1.0
+      hooks:
+          - id: prettier
+            additional_dependencies:
+                - prettier@^3.4.2
+    - repo: https://github.com/doublify/pre-commit-rust
+      rev: v1.0
+      hooks:
+          - id: fmt
+          - id: clippy

.prettierignore

@@ -0,0 +1 @@
+target/

.prettierrc.json

@@ -0,0 +1,7 @@
+{
+    "bracketSpacing": false,
+    "printWidth": 120,
+    "singleQuote": true,
+    "tabWidth": 4,
+    "trailingComma": "none"
+}