The Unified General-Purpose Programming Language, Webforge & Appforge Cross-Platform Toolchain
- 📖 TechScript Language Reference: Full syntax, grammar, primitives, collections, control flow, functions, classes, error handling, standard library, and support matrix.
- 🛠️ Frameworks & Unified CLI Handbook: Complete guide to
tsc, Webforge web development, Appforge cross-platform Android & Windows workflows, and native module integration. - 🔒 Development & Security Guide: Compiler pipeline architecture, 21-crate inventory, threat models, capability sandboxing, and quality gates.
Create hello.txs:
do main()
say "Hello, World from TechScript 2.0!"
end
Run it:
tsc run hello.txsScaffold and launch a production-ready website:
tsc web create my-website
cd my-website
tsc web dev # Launches live dev server on http://localhost:3000
tsc web build # Compiles static HTML/CSS/JS to dist/Create, build, and deploy an Android application:
tsc app create my-app
cd my-app
tsc app doctor # Verifies JDK, Android SDK, Gradle, ADB
tsc app build android # Generates debug APK (build/artifacts/android/app-debug.apk)
tsc app run android # Installs and launches on attached phone/emulator via ADB
tsc app build windows # Compiles native Windows executable| Platform / Target | Status | Verification Evidence |
|---|---|---|
| Android APK (Debug) | Tier 1 (Verified) | Built via Gradle 8.7 & AGP 8.6.0; installed and launched on live Android 16 device (10ME8DF1CT0001Z) |
| Android AAB (Release) | Tier 1 (Verified) | Validated ZIP structure and manifest (3.85 MB) |
| Windows Desktop (.exe) | Tier 1 (Verified) | Executable generation and execution verified on Windows 11 |
| Webforge (Static Web) | Tier 1 (Verified) | Compiles to semantic HTML, modular CSS, and runtime JS in dist/ |
| Web-to-Native Container | Tier 1 (Verified) | tsc app wrap web --platform android packages Webforge site into 6.77 MB APK |
| macOS & iOS | Tier 3 (Host Bound) | Scaffolding implemented; native compilation requires macOS with Xcode |
| Linux (AppImage/DEB) | Tier 3 (Host Bound) | Scaffolding implemented; native compilation requires Linux host |
The official TechScript AppForge companion application (examples/appforge/techscript-appforge/) is built 100% in pure TechScript (.txs) using AppForge. It features multi-tab routing, reactive project management, an interactive code workspace, language & CLI documentation, build diagnostics, and live Android device hardware bridge communication:
Appforge (Mobile & Desktop)
tsc app create <name> Scaffold a new Appforge application
tsc app build <platform> Compile application (android, windows) [--release] [--aab]
tsc app run <platform> Build, install, and run on device or desktop host
tsc app doctor Audit mobile and desktop development toolchains
tsc app wrap web Containerize Webforge website into a native APK/app
tsc app clean Clean build outputs and caches
Webforge (Web Framework)
tsc web create <name> Scaffold a new Webforge website
tsc web dev Start live development server with hot-reload
tsc web build Compile Webforge project to static dist/
tsc web test Execute web unit & component tests
Native & Language Interoperability
tsc native add <lang> Scaffold native module (kotlin, swift, rust, cpp, c, java)
Development & Compiler
tsc run <file> Run a TechScript file or project
tsc check <file> Perform semantic check without compiling
tsc test Run test suites (*_test.txs)
tsc fmt [paths...] Format source files
tsc lint [paths...] Run linter and suggest fixes
tsc logs Inspect centralized build and Gradle task logs
tsc report Generate comprehensive system diagnostics report
On Windows, download the latest pre-compiled tsc.exe from GitHub Releases and place it in your PATH. Alternatively, clone this repository and run cargo build --release -p techscript_cli.
Create a file named main.txs with do main() say "Hello!" end and execute tsc run main.txs.
Run tsc web create my-site. This generates a full Webforge project with app.txs, routing, and assets. Run tsc web dev to preview on http://localhost:3000.
In Webforge projects, write standard CSS rules inside the styles: block or link custom stylesheets. Client-side JavaScript/TypeScript files can be placed in assets/ and referenced directly.
Run tsc app create my-app. This sets up the TechScript entry point, appforge.toml, and native Android Gradle host code.
- Debug APK:
tsc app build android - Release APK:
tsc app build android --release - Google Play App Bundle:
tsc app build android --aab
Connect your phone with USB debugging enabled, then execute tsc app run android. tsc will automatically compile the APK, deploy it with adb install -r, and launch MainActivity.
Inside an Appforge project, execute tsc app build windows. The output executable is placed in build/artifacts/windows/<app-name>.exe.
Run tsc native add kotlin or tsc native add rust. Appforge sets up the appropriate Gradle or Cargo module under native/.
Declare dependencies in techscript.toml or webforge.toml, then run tsc install. tsc resolves versions with SemVer, verifies cryptographic checksums, and enforces capability sandboxes.
Run tsc logs to inspect the raw stdout and stderr logs of compiler and Gradle operations. Run tsc report to generate a diagnostic report of your environment.
On Windows 11, you can natively build:
- Android APK & AAB (requires JDK and Android SDK)
- Windows Executables (
.exe) - Webforge Production Websites (
dist/) - Webforge-to-Android native containers
Native iOS (.ipa) and macOS (.dmg) compilation require an Apple macOS host with Xcode installed. Direct Google Play Store API uploading requires user-supplied production keystores and credentials.
TechScript is open-source software licensed under the Apache License 2.0.