Getting started

RayCraft Free comes from nuget.org. RayCraft Complete comes from a private NuGet feed and needs an active license and an access token.

1. RayCraft Free

dotnet add package RayCraft.Blazor

2. RayCraft Complete

The feed is https://nuget.raycraft.dev/v3/index.json, the user name is rcf and the password is your token (it starts with rcf_).

• 1
  Create a token

  Sign in at auth.raycraft.dev, open Package access and create a token. It is shown only once, so copy it right away. You can have up to 10 tokens per license; a revoked token stops working immediately.

• 2
  Add the feed on your machine

  The command stores the source in your user-level nuget.config, not in the project.

dotnet nuget add source https://nuget.raycraft.dev/v3/index.json --name RayCraft --username rcf --password <YOUR_TOKEN> --store-password-in-clear-text

--store-password-in-clear-text is needed on Linux, macOS and build agents. On Windows you can omit it and the password is encrypted for your user.

Build server

Commit a nuget.config that reads the token from a variable, and set RAYCRAFT_FEED_TOKEN as a secret in your build system.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="RayCraft" value="https://nuget.raycraft.dev/v3/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <RayCraft>
      <add key="Username" value="rcf" />
      <add key="ClearTextPassword" value="%RAYCRAFT_FEED_TOKEN%" />
    </RayCraft>
  </packageSourceCredentials>
</configuration>

Install the packages

dotnet add package RayCraft.Blazor.Complete --source RayCraft
dotnet restore

Register and use

In Program.cs (for WebAssembly and Auto, also in the client project):

using RayCraft.Blazor;
using RayCraft.Blazor.Office;

builder.Services.AddRayCraft();
builder.Services.AddRayCraftOffice();

In Components/App.razor set the theme on html and add the files:

<html lang="en" data-raycraft-theme="light">
<head>
    <link rel="stylesheet" href="_content/RayCraft.Blazor/css/raycraft.css" />
    <link rel="stylesheet" href="_content/RayCraft.Blazor.Office/css/raycraft-office.css" />
</head>
<body>
    <Routes @rendermode="InteractiveServer" />
    <script src="_content/RayCraft.Blazor/raycraft.js"></script>
    <script src="_framework/blazor.web.js"></script>
</body>
</html>

In Components/_Imports.razor:

@using RayCraft.Blazor
@using RayCraft.Blazor.Components

The controls can then be used directly, for example <ThemeMenu />, <DialogHost /> and <SnackbarHost />. The AddRayCraftOffice line and the Office stylesheet are only needed with the Office package.

Check access

Without a token the feed answers 401, which shows that the address is right and access is protected. With a token, a read-only check:

curl -s -u rcf:$RAYCRAFT_FEED_TOKEN https://nuget.raycraft.dev/v3/index.json

Expected: JSON with version and a list of resources.

Common problems

For anything else write to support@raycraft.dev with the package name and version, platform, .NET version and the feed lines from dotnet restore -v d (without the token).