Documentation
Product Navigation
Astral’s signed-in experience centers on Terminal, Explore, and Dashboard. The app menu adds profile, affiliate, notification, broker, settings, theme, and sign-out actions according to account state and enabled features.
Primary routes
| Route | Purpose |
|---|---|
| /terminal | Start or resume a chat-driven research and strategy session. |
| /terminal/[sessionId] | Open a specific persisted terminal session. |
| /explore | Browse the community home, strategies, indicators, following, and saved content. |
| /dashboard | Monitor widgets and connected account state. |
| /dashboard/accounts/[accountId] | Review an individual account’s summary, activity, orders, positions, and balance history. |
| /u/[handle] | View a public profile and its published work. |
Desktop navigation
The app menu links to Terminal, Dashboard, and Explore. When authenticated it also exposes your public profile, creator or affiliate area, notifications, broker settings when enabled, account settings, theme, and sign out.
Terminal adds a right-side rail for contextual tools. Depending on viewport, account, and enabled features, it can open watchlist, alerts, strategies, portfolio, orders, broker connections, notifications, suggestions, reporting, and settings-related surfaces.
Mobile navigation
On supported mobile app routes, a floating bottom navigation switches among Chat, Explore, and Dashboard. The app menu exposes trading panels such as Alerts, Portfolio, Watchlist, and Orders. Terminal uses mobile-specific drawers and panels rather than reproducing the full desktop grid.
Some dense chart, analysis, replay, and multi-panel workflows remain easier on a larger screen, but mobile is an intentional product surface rather than a desktop redirect.
Sessions and deep links
Terminal sessions preserve the conversation and associated workspace state. Links from saved strategies, Explore details, notifications, and public items can open a specific asset or import path. Check the active session, chart, strategy, symbol, and account after following a deep link.
The Terminal message box grows with your draft, then scrolls within the input when it reaches its height limit. A slim scrollbar appears on hover or while scrolling in desktop and compact web layouts. Shift+Enter adds a new line; Enter sends the message.
Public and account routes
Documentation, announcements, pricing, brokerages, MCP setup, security, privacy, terms, and help are public resources. Saving, copying, publishing, following, account monitoring, and trading actions require authentication, and some require a specific entitlement.
How context moves between surfaces
Astral is not a collection of isolated pages. Most routes hand context to another surface:
- An Explore item can open in Terminal with its strategy or indicator context.
- A Terminal result can become a private saved strategy, a public publication, or a deployment.
- A notification can lead back to an alert, strategy, order, or account state.
- A Dashboard strategy or broker widget can open a deeper detail view without changing the underlying record.
- A public profile links to publications, while private strategy and broker records remain in authenticated surfaces.
When a route opens from a card or notification, verify the breadcrumb, selected symbol, active strategy, account scope, and execution mode. The visual transition does not merge records or change ownership.
Choosing the right starting point
| If you want to… | Start in | Why |
|---|---|---|
| Research or build an idea | Terminal | Chat, charts, code, and backtests share one session context. |
| Discover community work | Explore | Public strategies, indicators, profiles, comments, and saved public items live here. |
| Monitor ongoing state | Dashboard | Widgets keep accounts, strategies, charts, and notifications visible together. |
| Inspect a connected account | Dashboard account detail | Balances, positions, orders, activity, and history are scoped to one account. |
| Manage identity or access | Settings | Subscription, notifications, connections, and account controls are account-level. |
Navigation recovery
If you are unsure where an action took you, return to the app menu and reopen the canonical surface. Opening the same saved strategy in a new Terminal session does not delete the earlier session. Likewise, navigating away from a preview does not cancel an already-submitted broker order or stop an active deployment.
Switch between Classic and Onchain
When your account can use both products, the account menu has a Product section listing Astral Onchain and Astral Classic, with a check next to the one you're in. Choose the other one: a short Opening Astral Classic… (or Opening Astral Onchain…) screen covers the move, and the other website opens on its Terminal, already signed in to the same account. The Product section is missing when your account has access to one product, access couldn't be checked, or switching isn't turned on in that release. Switch product shows the same choice as a page, with your access to each product.
Both products use the same Astral account within an environment. If the other website can't confirm the switch (for example after a very slow page load), it asks you to sign in instead. After switching, each website keeps its own sign-in: signing out of one doesn't sign you out of the other. Dev and production remain separate. A switch saves your choice and opens the other website; it doesn't move funds, convert saved work, transfer a running strategy, or switch Paper / Real money mode. Manage existing work in the product where it was created. The account menu's Switch account list (staff managed accounts) is separate and isn't carried to the other website.
Not available for your account means access has not been granted or the product is disabled. New trades and deployments are paused means new deployment/trade requests and agent turns are restricted; it does not confirm that existing strategies stopped. If switching fails, choose the product again, use Retry on the page, or return to the original product. For recovery that is unavailable there, contact Help.
An explicit Product agent access is paused chat error means that new turn was refused, not queued for later processing. Keep a copy of your message and retry only after access is restored; changing product or Paper / Real money mode does not bypass the pause. Existing execution, monitoring and recovery remain with the original product. This applies to desktop and mobile web; installed native releases require their own qualification.
The Product section and the page adapt to desktop and mobile web widths. Native-app switching requires release-specific qualification; do not assume an installed native client has this control. The main website's default product can change independently of your running execution.
Administrators can grant Classic only, Onchain only, or both. Permissions follow the named product when the main and alternate domains are reassigned. Opening a restricted workspace directly returns you to the chooser. On a product that isn't available to you, Manage existing execution opens that product's recovery dashboard. On Onchain's isn't available for your account page, Go to Astral Classic switches you to Classic signed in, and Manage existing Onchain execution opens Onchain's recovery dashboard. Recovery does not grant new execution permission; contact Help if a required recovery control is unavailable.
After a domain change, an already-open page may say This domain now serves another product. That website request was refused. Use Reopen your original product before retrying; check the original product's order/strategy status first because other requests and running execution are independent. You may need to sign in again. Keep product-specific bookmarks on the stable product website: an old bookmark on a reassigned domain follows that domain's current product. Domain-router release and installed native behavior require separate qualification.