Asveora Shell Client

Hello! AmzroSevca writing here, and welcome to the Asveora Shell Client repository!

This is a lightweight browser-style shell that lets you comfortably explore the Asveora Ecosystem from a single unified interface. Instead of jumping between tabs, bookmarks, or separate pages, everything lives inside one simple client window.

You can set your Asveora Profile Address (APA) and your preferred LandHub, and the shell will remember them locally on your device. It’s designed to feel like a small, focused dashboard for browsing Asveora in a cleaner and more organized way.

The entire shell experience is extremely lightweight (under 1 MB) and runs directly in your browser with no installation required.

Yes, I understand this is basically a mini-browser inside of a full-fledged browser, but it lays the foundation for what is to come in the future!

About the Licenses

This repository is dual-licensed under the GNU General Public License v3.0 (GPLv3) and the Asveora Commercial License Agreement (ACLA).

You may use, modify, and distribute this project under the terms of the GPLv3, or, if you are using this software in a commercial, closed-source, or non-GPL-compatible context, you may instead operate under the terms of the ACLA, subject to its separate conditions.

By using this software, you agree that your usage must comply with at least one of the applicable licenses, depending on how the software is used or distributed.

For full details, please refer to the LICENSE-GPLv3 and ACLA license files included in this repository.

So what does this actually do?

The Asveora Shell Client acts as a simple navigation layer for the Asveora Ecosystem.

It allows you to:

• Set and update your Asveora Profile Address
• Set and switch your preferred LandHub
• Browse Asveora content inside a single embedded window
• Open multiple tabs inside the shell interface
• Manage your session without relying on external bookmarks or multiple browser windows

Think of it as a GPS for Asveora, built right in your browser.

How to Use This Client

Getting started is very simple:

1. Download or clone this repository
2. Ensure you have a web browser that is up to date! All modern browsers are capable of rendering HTML5.
3. Open the index.html file in your browser or use the included desktop shortcut that will achieve the same thing.
4. Optionally make your own desktop shortcut to the index.html file and launch it. You'll only do this if you're on an operating system other than Windows.

That’s it! No complicated build steps, no software installs, and no dependencies.

First-Time Setup

When you open the shell for the first time (or after a reset), you will be prompted to:

1. Enter your Asveora Profile Address
2. Enter your preferred LandHub Address

These are stored locally in your browser so you don’t have to enter them every time.

You can update them later using the Switch Profile or Switch LandHub options in the dropdown menu.

What You Can Look Forward To

• Clean browser-shell interface
• Built-in tab system (add/remove tabs freely)
• Native UX modal instead of browser popups (they got out of hand after awhile)
• Simple navigation between Profile and LandHub
• Lightweight local storage (nothing is sent to a server)
• Fast startup with zero dependencies (truly lightning fast)

Privacy Notice

All data (Profile and LandHub settings) is stored locally in your browser only.

Nothing is uploaded, tracked, or shared externally.

If you clear your browser storage or click reset, all saved data will be removed.

If someone is telling you to paste something in the DevTools console or telling you to visit some external website to enter your "credentials" ignore them and report them immediately.

You do NOT enter any credentials into this client. Asveora has no native "login" service anywhere in its Framework or Ecosystem. All you're inputting are web addresses that you want to use which are just your Asveora Profile Address and the address of your preferred LandHub.

Why was this shell client made?

This shell client was made because this is what I (AmzroSevca) am capable of building right now. This project is intentionally lightweight and experimental since I am not a full-fledged app developer by any means.

It is designed to be:

• Easy to understand
• Easy to modify
• Easy to extend in the future

It is not a full operating system or PWA framework. It is just meant to be a clean and simple browser shell for navigation.

Why not make a real client?

That is the goal someday! However I currently do not possess the skillset or knowledge to build a feature-rich client and have a lot going on. I am maintaining the entire Asveora Framework along with the Asveora Ecosystem, RFC stack, and a lot of other moving parts. So this is the best that I could come up with for the time being. I imagine native clients for desktop and mobile devices will come in due time when more developers join the Asveora project.