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_DEFAULT_ARCHITECTURE	anna	Name of the architecture plugin to load.
BLOCKSEMBLER_BACKEND_API_URL	/api/v1/	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.

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