Pages & Routing

Declare pages with canonical paths, navigation actions, and nested visual components.

page Showcase "/showcase":
    show heading "Project Showcase"
    button "Launch 3D Lab" -> open "/showcase/3d"

Cards & Media Blocks

Cards accept titles, text, badges, code snippets, and action buttons.

show card "Product Card":
    badge is "Featured"
    text is "High performance PBR renderer"
    button "Inspect" -> open "/docs/3d"

Readable English Keywords

Natural keywords like 'make a website', 'show heading', 'button', 'database', 'when clicked' replace complex boilerplate.

High-Performance Rust Backend

TechScript compiles through a Rust lexer, parser, and semantic analyzer, emitting optimized bytecode or native web bundles.

Install & Add Packages

$ webforge add std_canvas
✓ Added 'std_canvas' v2.0.0 to webforge.toml

List & Inspect Installed Packages

$ webforge list
Dependencies:
  ├── std_web v2.0.0 (built-in)
  └── std_sqlite v2.0.0 (embedded)

Quantum Processor Chip

Silicon substrate wafer, 4 gold coplanar microwave waveguides, 25 transmon qubit nodes, and 16 cryogenic edge connector pins.

Gravitational Singularity

Dark event horizon sphere enveloped by a warped relativistic accretion disk and bipolar relativistic plasma jet beacons.

Parametric Möbius Strip

Continuous topological ribbon with 96 radial segments executing a half-twist in 3D Euclidean space with smooth vertex normal computation.

Dyson Swarm Megastructure

Segmented equatorial energy conduit mega-ring framing a radiant stellar core, orbited by 10 hexagonal photovoltaic solar arrays.

Quantum Gyroscope

Three concentric orthogonal orbital rings rotating around independent celestial axes, framing a central faceted energy sphere with dynamic specular reflections.

4D Tesseract Matrix

A 4-dimensional hypercube projected into 3D Euclidean space: 12 outer cube struts, 12 inner cube struts, and 8 diagonal vertex connectors.

DNA Double Helix

Intertwining dual-strand helical backbone with 28 perpendicular nucleotide base-pair rungs and spherical junction atoms.

Deep Space Satellite

Hexagonal payload bus flanked by dual photovoltaic solar array wings with structural grid frames and an articulated parabolic communication dish.

Harmonic Ripple Torus

Parametric toroidal surface modulated by high-frequency 5-pole sine waves, simulating energy conduits and plasma containment fields.

12-Point Stellated Star

An icosahedral core whose 20 triangular faces are extruded outward into sharp stellated pyramid spikes pointing in all 3D spherical vectors.

Sci-Fi Reactor Core

Complex central core with orbital magnetic confinement rings, capacitive corner nodes, and pulsating rim lighting.

Mechanical Spire Tower

Multi-tier structural spire featuring stepped cooling fins, power conduit rings, and an orbital telemetry antenna mast.

Quantum Trefoil Knot

Continuous mathematical knot with 120 radial segments and 24 tubular segments providing continuous curvature under specular highlights.

Prism Crystal Gem

Diamond-cut multi-facet crystal geometry designed to showcase hard specular reflections, normal perturbation, and internal light refraction.

Geodesic Ico Grid

Equilateral triangular geodesic tessellation providing uniform surface normal distribution for wireframe and matrix simulations.

Product Monolith

Beveled chamfer monolith device demonstrating subtle micro-roughness, metallic highlights, and industrial product rendering.

10 Calibrated Hardware Palettes

Switch seamlessly between Cyber Cyan, Neon Teal, Quantum Violet, Crimson Core, Solar Amber, Matrix Emerald, Ice Blue, Titanium Silver, Amber Glow, and Galactic Pink.

5 Real-Time Shading Styles

Cycle between: ✨ PBR Specular Metallic, ⚡ Cyber Rim Hologram, 🔮 Normal Vector Map, 🌈 Dual-Tone Vertical Gradient, and 🛸 Cyber Scanlines Grid.

Dynamic Orbital Physics

Switch between standard Y-axis orbit, dual-axis tumbling, and sine-wave floating wobble. Adjust speed from 0.5x to 3.5x or reverse rotation direction.

Full Precision Orbit Controls

Direct pointer drag rotates camera along both azimuth and elevation with inertia dampening. Mouse wheel or HUD zoom buttons adjust camera distance from 2.0 to 8.5.

Declare 3D Scenes in .txs

# Short, Clean TechScript 3D Syntax
show 3D "QuantumCore":
    color is "cyan"
    speed is 1.8
end

# Or 1-line shorthand:
# show 3D "QuantumCore": color is "cyan", speed is 1.8

Dynamic Color & Wireframe Control

# TechScript WebForge runtime automatically binds
# hardware WebGL 2.0 with custom PBR shaders.
# Zero npm packages, zero external CDNs.

let scene = WebForge3D.mount("QuantumCore", {
    geo: "gyroscope",
    color: "cyan",
    speed: 1.4
})

Two-Way Synchronization

Edits made visually in the 3D viewport immediately update the TechScript source code. Typing or editing .txs declarations compiles in real-time and renders updated Three.js geometry.

Real CSG Boolean Engine

Constructive Solid Geometry modifies the underlying mesh buffers via binary space partitioning (BSP), splitting faces and capping cut interiors for real machining and hollowing.

Universal 3D Interoperability

Export your custom models directly to GLTF/GLB for web deployment, Wavefront OBJ for 3D modeling pipelines, STL for 3D printing, or pure .txs for TechScript codebases.

Scaffold New Project

Create a fullstack application template with pages, scenes, server, and configuration:

$ webforge new fullstack my-portal
$ cd my-portal
$ ls
  webforge.toml  src/main.txs  src/pages/  src/server/  src/scenes/

Start Development Server

Launch the WebForge HTTP server with live reloading and SQLite initialization:

$ webforge dev --port 8085
🚀 TechScript WebForge running on http://localhost:8085

Build for Production

Compile your TechScript project into standalone static and server assets in dist/:

$ webforge build web --release
✓ WebForge Production Build Complete!
  Output: dist/ (index.html, styles.css, app.js, 404.html)

Automated Test Runner

Execute unit and integration tests across your codebase:

$ webforge test
Running 14 test suites... 14 passed; 0 failed

Environment Doctor

Verify compiler dependencies, Rust toolchain, and port availability:

$ webforge doctor
✓ Compiler: OK
✓ SQLite: OK
✓ Network: OK

Declarative Database Schema

Declare tables and column types directly in your .txs server configuration:

database Store:
    table products:
        column title as text
        column price as float
        column stock as int

Automatic CRUD Operations

WebForge automatically binds HTTP POST and GET methods to declared tables with SQL injection protection:

POST /api/products
Body: { "title": "Developer Laptop", "price": 1499.00 }

GET /api/products
Response: 200 OK [ ... ]

Two-Way Visual & Code Synchronization

Every visual manipulation in the 3D viewport (adding parts, moving, scaling, rotating, recoloring, cutting) generates clean TechScript code in real time. Editing the code immediately recompiles and updates the Three.js viewport.

Universal 3D Export Pipelines

Export finished creations directly to web-ready GLTF/GLB, Wavefront OBJ, STL for 3D printing, or pure TechScript (.txs) source code.

WebForge CLI

Manage project lifecycles with simple commands: webforge new, webforge dev, webforge build web --release, and webforge test.

$ webforge build web --release
✓ WebForge Production Build Complete!
  - dist/index.html (34 KB)
  - dist/styles.css (8 KB)
  - dist/app.js (12 KB)

Real-Time 3D Laboratory

Hardware-accelerated 3D viewport powered by Three.js with PBR material editing, directional lighting control, and interactive camera orbits.

Enterprise Security Architecture

Built-in protection against SSRF, XSS, and SQL injection. Automated security headers: nosniff, SAMEORIGIN, strict-origin-when-cross-origin, and isolated sandboxing.

Automatic Breadcrumbs

Nested routes automatically display breadcrumb navigation (e.g., Home / Docs / Syntax) with clickable history links.

// Nested route automatically renders breadcrumb navigation
page ApiGuide "/docs/api":
    show heading "Backend API Reference"

Button Route Triggers

Buttons can trigger declarative route transitions using the 'open <route>' action keyword.

button "Go to 3D Lab":
    action is "open /showcase/3d"

22 Compiled Routes

The complete 22-page site compiles from a single main.txs entry point into an optimized multi-route SPA in under 100ms. Zero build config required.

Zero Dependencies

WebForge3D engine, SQLite layer, SPA router, and notification system are all native Rust and embedded JS. No npm, no CDN, no external scripts.

WebGL 2.0 Native

Six procedural 3D geometries with PBR shaders, real-time FPS telemetry, orbit drag, and scroll-wheel zoom — entirely without Three.js or any external library.

SQLite Full-Stack

Every WebForge application ships with embedded SQLite. Declare tables in .txs syntax and instantly get REST API endpoints and a live records viewer.

TechScript (Language)

TechScript is a statically-typed, memory-safe programming language with natural English keywords. Features: strong typing, pattern matching, async coroutines, modular namespaces.

let greeting = "Hello, World!"
print greeting

function calculateTax(subtotal: Float) -> Float:
    return subtotal * 0.08

# Pattern matching
match status:
    case "ok" -> print "All good!"
    case "error" -> print "Something went wrong"

WebForge (Framework)

WebForge is the official full-stack framework for TechScript. Declarative DOM lowering, client-side routing, SQLite integration, and native WebGL 3D — zero CDN dependencies.

make a website called MyPortal

page Dashboard "/":
    show heading "Analytics Overview"
    show scene3d CoreVisualizer

    show section:
        title is "Platform Stats"
        show card "Users": text is "12,450 active"
        show card "Uptime": text is "99.97% SLA"

Compiler & AST Lowering

Rust 2021 Edition. Lexer, recursive descent parser, and semantic analyzer transform declarative DSL trees into optimized execution graphs.

Embedded SQLite Persistence

Server routes interact with SQLite via parameterized queries, transactional guarantees, and instant REST API emission. No ORM or migration tool needed.

Native WebGL 3D Engine

Native WebGL 2.0/1.0 with custom PBR shaders, 6 procedural geometries, wireframe mode, orbit controls, and live FPS measurement — all built-in.

SPA Client Router

Client-side route switching with history.pushState, animated page transitions, breadcrumb generation, and active link highlighting. No server round-trips.

Declarative Interactivity

Declare button handlers, API submissions, and toast notifications directly in .txs syntax. The compiler lowers them to optimized vanilla JavaScript event listeners.

Production Build Pipeline

webforge build web compiles all routes to dist/ with a single index.html, bundled CSS, embedded JavaScript runtime, and SQLite database. Works on any static host.

Zero-Config Production Build

Compile your entire multi-route application with embedded SQLite, native 3D engine, and client-side SPA routing into an optimized single binary or static web bundle.

Fullstack SQLite Demo

Live REST APIs at /api/health and /api/examples. Submit forms, persist records to SQLite, and see the database viewer update instantly.

Interactive Playground

Experiment with live TechScript WebForge syntax in your browser. Real-time UI preview, instant feedback, and syntax highlighting — no install needed.

1. Install Toolchain

# Install from source (Rust 1.78+ required)
cargo install --path cli

# Verify installation
webforge --version
techscript --version

2. Create Project

webforge new fullstack my-app
cd my-app

# Project structure:
# my-app/
#   src/main.txs    <- entry point
#   src/pages/      <- page modules
#   src/server/     <- API routes
#   webforge.db     <- SQLite auto-created

3. Run Dev Server

webforge dev --port 8085

# Opens http://localhost:8085
# All routes served from single binary
# Edit .txs files -> server rebuilds live