====== WvdS FPC RAD Studio for VS Code ======

//Professional Pascal development in Visual Studio Code//

===== What is WvdS FPC RAD Studio? =====

WvdS FPC RAD Studio is an integrated development environment for Free Pascal, implemented as an extension suite for Visual Studio Code. The suite enables development of:

  * **Desktop Applications** - Native GUI and console applications with FPC
  * **Web Applications** - Browser-based apps via pas2js transpiler
  * **Terminal UI** - Text-based interfaces for servers and CLI tools
  * **VSCode Extensions** - Pascal-based extensions for VS Code itself

===== Why WvdS FPC RAD Studio? =====

^ Challenge ^ Solution ^
| Pascal development requires Lazarus IDE | Complete development directly in VS Code |
| No visual designer in VS Code | PXAML designer with live preview |
| Complex build configuration | One-click build with automatic tool detection |
| Missing IntelliSense for UI | Component registry with auto-completion |

===== Extensions in the Suite =====

The suite consists of seven specialized extensions:

^ Extension ^ Function ^ Dependencies ^
| [[.:core|Core]] | Central infrastructure, toolchain configuration | - |
| [[.:build|Build]] | Compilation with FPC and pas2js | Core |
| [[.:projects|Projects]] | Project management and templates | Core |
| [[.:designer|UI Designer]] | Visual PXAML editor | Core |
| [[.:meta|UI Meta]] | Component registry, IntelliSense | Core |
| [[.:preview|UI Preview]] | Live preview for PXAML | Core, Designer |
| [[.:packaging|Packaging]] | VSIX creation and publishing | Core, Build |

===== Quick Start =====

==== 1. Installation ====

Install the extensions via the VS Code Marketplace:

<code>
code --install-extension wvds.wvds-vscode-core
code --install-extension wvds.wvds-vscode-build
code --install-extension wvds.wvds-vscode-projects
</code>

Alternatively: Search for "WvdS FPC" in the VS Code extension browser.

==== 2. Configure Toolchain ====

After installation:

  - Open the Command Palette (''Ctrl+Shift+P'')
  - Run ''WvdS: Toolchain Configuration...''
  - The suite automatically detects installed compilers
  - Manually adjust paths if needed

==== 3. Create First Project ====

  - ''Ctrl+Shift+P'' -> ''WvdS Projects: New Project from Template...''
  - Choose a template:
    * **Desktop Console** - Simple console application
    * **Desktop GUI** - LCL-based GUI application
    * **Web PWA** - Progressive Web App with pas2js
    * **TUI App** - Terminal UI application
    * **VSCode Extension** - Pascal-based extension
  - Enter project name and location
  - The project is created and opened

==== 4. Compile and Run ====

  - ''Ctrl+Shift+P'' -> ''WvdS: Build Project''
  - Or: ''Ctrl+Shift+B'' for the build task
  - Output appears in the Terminal panel
  - Errors are shown in the Problems panel

===== System Requirements =====

^ Component ^ Minimum ^ Recommended ^
| VS Code | 1.85.0 | Latest version |
| Free Pascal | 3.2.0 | 3.2.2 or 3.3.1 |
| pas2js | 2.0.0 | 2.2.0 |
| Operating System | Windows 10, Linux, macOS | Windows 11, Ubuntu 22.04+ |

===== Supported Project Types =====

^ Type ^ Compiler ^ Output ^ Use Case ^
| Desktop Console | FPC | Native .exe/.bin | CLI tools, services, batch processing |
| Desktop GUI | FPC + LCL | Native .exe/.bin | Desktop applications with windows |
| Desktop Library | FPC | .dll/.so | Shared libraries, plugins |
| Web PWA | pas2js | JavaScript | Browser applications, SPAs |
| TUI App | FPC | Native .exe/.bin | Terminal interfaces, server admin |
| VSCode Extension | pas2js | JavaScript | VS Code extensions |
| Installer | Inno Setup | .exe | Windows installation packages |

===== Next Steps =====

  * [[.:installation|Detailed Installation Guide]]
  * [[.:core|Core Extension - Setting Up the Toolchain]]
  * [[.:build|Build Extension - Compilation Options]]
  * [[.:projects|Projects Extension - Using Templates]]
  * [[.:designer|UI Designer - Designing PXAML Interfaces]]
  * [[.:controls|UI Controls - Available Components (108)]]
  * [[.:controls-installation|Installing Controls]]
  * [[.:faq|Frequently Asked Questions]]
  * [[.:qualitaetssicherung|Quality Standards]]
  * [[.:beitragen|Contributing]]

===== Support and Community =====

  * **GitHub Issues**: [[https://github.com/ArmandoFilho/WvdS.FPC/issues|Bug Reports and Feature Requests]]
  * **Documentation**: These wiki pages
  * **License**: MIT License - free for commercial and private use