gitbook-docs/quick-start
2021-10-05 15:43:18 +00:00
..
1.-browser-to-browser-1.md GitBook: [2.0.0] 23 pages modified 2021-08-15 16:25:50 +00:00
2.-hosted-services.md GitBook: [2.0.0] 23 pages modified 2021-09-03 23:23:02 +00:00
3.-browser-to-service.md GitBook: [2.0.0] 30 pages and 8 assets modified 2021-10-01 14:33:42 +00:00
4.-service-composition-and-reuse-with-aqua.md GitBook: [2.0.0] 3 pages and 6 assets modified 2021-10-01 15:33:56 +00:00
README.md GitBook: [2.0.0] 31 pages and 4 assets modified 2021-10-05 15:43:18 +00:00

Quick Start

Welcome to our quick-start tutorials which guide you through the necessary steps to

  1. Create a browser-to-browser messaging web application
  2. Create and deploy a hosted service
  3. Enhance a browser-to-browser application with a network-hosted service

For your development convenience, Fluence provides a docker-based development environment that comes with the necessary dependencies, tooling and quick-start code pre-installed.

Fluence Devcontainer

Fluence's devcontainer is a ready to use dockerized development environment with VSCode integration containing the following tools:

  • aqua to compile Aqua to AIR or wrapped in Typescript
  • fldist to manage services and optionally execute compiled Aqua from the command line
  • marine to compile services developed in Rust to the wasm32-wasi target
  • mrepl to run, test and debug WebAssembly Wasm services locally

How to install

Docker and optionally VSCode need to be available on your system. For Docker installation, follow the Get Docker instructions for your OS. For VSCode, see VSCode for instructions.

With Docker and VSCode in place:

  • Install Remote-Containers extension in VSCode

Install Remote - Containers in VSCode

  • Run Remote-Containers: Clone Repository in Container Volume... via the command palette F1 or Cmd-Shift-P

Select Remote Container Clone Repository

  • Enter fluencelabs/devcontainer

Select \`fluencelabs/devcontainer\`

  • When asked for branch, press enter main
  • When asked for volume, press enter unique
  • Open Terminal in VSCode ctrl-\`

Installed And Ready Devcontainer in VSCode

Congratulations, you now have a fully functional Fluence development environment. For a variety of container management options, click on the Dev Container: Fluence button in the lower left of your tool bar:

Container Management Option Menu

If you encounter any problems or have suggestions, please open an issue or submit a PR. You can also reach out in Discord or Telegram. For more detailed reference resources, see the Fluence documentation and Aqua book.

All right, now we are ready to proceed to the first application on Fluence.