Getting Started

Run from Source

To get started with the Assembler Programming Learning Environment, follow these steps:

1. Clone the Repository: Clone this repository to your local machine using git clone https://github.com/Blocksembler/blocksembler-frontend.git.

2. Install Dependencies: Navigate to the project directory and install the necessary dependencies by running npm install.

3. Run the Development Server: Start the development server by running npm run dev. This will launch the application locally, and you can access it in your web browser at http://localhost:5173.

4. Explore and Learn: Start exploring the block-based programming environment and dive into learning assembler programming with ease!

Run from Docker Image

Blocksembler is also available on Docker Hub. To get started, follow these steps:

1. Pull Docker Image: Pull the blocksembler/blocksembler-frontend image docker pull blocksembler/blocksembler-frontend:latest

2. Run the Container: Start up a new container instance that runs the blocksembler application docker run blocksembler/blocksembler-frontend:latest -p 80:80 -d. This will launch the application locally, and you can access it in your web browser at http://localhost.

3. Explore and Learn: Start exploring the block-based programming environment and dive into learning assembler programming with ease!

Environment Variables

Name	Default	Description
BLOCKSEMBLER_SERVER_NAME	localhost	The server name used by the nginx configuration.
BLOCKSEMBLER_BACKEND_DISABLED	false	When true, the application disables all backend requests.
BLOCKSEMBLER_DEFAULT_ARCHITECTURE	anna	Name of the architecture plugin to load.
BLOCKSEMBLER_BACKEND_API_URL	http://localhost	Base URL of the backend API.
BLOCKSEMBLER_LOG_SYNC_BATCH_SIZE	1000	Maximum number of log entries to sync in a single batch.
BLOCKSEMBLER_LOG_SYNC_INTERVAL	10000	Interval (in milliseconds) between log sync operations.
BLOCKSEMBLER_RESOURCE_LINKS	[]	A list of additional resource links displayed in the Blocksembler navigation. Each item of this list needs must provide the properties name and url.

Contributing

Contributions to this project are welcome! If you have ideas for new features, improvements, or bug fixes, feel free to open an issue or submit a pull request.

Contact

Florian Wörister | Universität Wien