Customer documentation

Understand the Mozaic public beta.

This compact guide covers the current hosted product: organization-owned projects, Git contribution, exact-revision review, isolated .NET checks, NuGet publication, work, and durable knowledge.

Git-first.NET and NuGet firstPublic beta
01 / Start here

Set up an explicit project home.

Mozaic does not create a hidden personal workspace. Organizations are the tenant and ownership boundary; projects, repositories, forks, work, and releases belong to an explicitly named organization.

  1. Create and verify your account.Use a verified email address and a password of at least 15 characters. Common and breached passwords are blocked.
  2. Secure privileged actions.Enroll a passkey or security key, or configure a TOTP authenticator. Save the generated single-use recovery codes.
  3. Name the organization.Choose an explicit owner for the project’s repositories, work, packages, and knowledge. New resources begin non-public.
  4. Create the first project.Add a project summary, then create a repository or import an existing Git repository from a reachable source.
Create a beta account
02 / Workspace model

Organization, project, resource.

Those three scopes keep ownership and navigation visible. A user can belong to organizations; each organization contains projects; each project connects its source, reviews, pipelines, work, packages, knowledge, calendar, and activity.

ORGANIZATION

Tenant and governance boundary

Membership, teams, roles, invitations, publication posture, and stewardship begin here.

PROJECT

Shared engineering context

Source, work, releases, documentation, and public presentation meet around one project identity.

RESOURCE

Stable identity

Repositories, revisions, proposals, runs, packages, work items, and pages keep stable references.

VISIBILITY

Deliberate publication

Private is the default. Public visibility requires an authorized, explicit action at the necessary scopes.

Publication is never inferred.

A public child resource does not silently make a private ancestor public, and missing authorization never becomes public access.

03 / Git repositories

Create, import, browse, and contribute.

The public beta’s production version-control adapter is Git. It supports smart HTTP clone, fetch, and push, plus Git LFS transfer and locking. The web workspace exposes branches, tags, commits, files, history, blame, comparisons, and browser editing.

Repository visibility

  • New and imported repositories begin organization-only.
  • An explicitly public repository can be browsed and cloned without authentication.
  • Publishing a repository also requires its organization and project to be explicitly public.

Transport support

Use the HTTPS clone URL shown in the repository view. SSH Git transport is not part of the current public beta.

Import is intentionally one-time.

Mozaic preserves the source repository’s history, while ongoing mirroring remains outside the current product path.

04 / Contribution and review

Accept outside work without hidden membership.

A contributor does not need membership in the target organization. They authenticate, create or select an organization they control, fork the public repository into a project there, and open a proposal against the target.

  1. Fork into a named organization.The source remains visibly owned by the contributor’s organization, including a single-member organization.
  2. Open a pull request.Mozaic pins the exact source and target revisions into an immutable proposal snapshot.
  3. Discuss and review the snapshot.Line threads, general conversations, review decisions, and check results remain associated with the exact proposal.
  4. Grant execution when needed.External-contributor code runs only after an authorized maintainer grants the exact revision and resolved pipeline plan.
  5. Merge under policy.Mozaic re-evaluates required reviews, checks, signatures, and merge strategy before atomically updating the protected target.
A changed revision is new evidence.

Updating the proposal invalidates prior execution grants and prevents old check or approval evidence from silently applying to different code.

05 / Pipelines

Resolve a plan from the exact revision.

Pipeline configuration lives at .mozaic/pipeline.yml in the repository. Mozaic reads it from the selected revision, validates it, resolves image digests and other inputs, and records an immutable canonical plan before scheduling jobs.

.mozaic/pipeline.ymlillustrative structure
version: 1
triggers:
  - pull_request
  - manual
jobs:
  verify:
    image: mcr.microsoft.com/dotnet/sdk@sha256:…
    steps:
      - run: dotnet restore
      - run: dotnet build --no-restore
      - run: dotnet test --no-build --no-restore

The image shown above is deliberately abbreviated; use a supported image pinned to its complete digest. The beta supports repository and manual triggers, dependent jobs, simple run steps, declared services, logs, cancellation, immutable attempts, test results, artifacts, and trusted tag publication paths.

Untrusted contribution jobs

  • Run in ephemeral rootless Podman job pods outside the application container.
  • Receive bounded CPU, memory, temporary storage, duration, and network policy.
  • Do not receive protected secrets, privileged mode, host mounts, deployment authority, publication authority, or trusted cache writes.
  • Are not silently rescheduled after possible execution; runner loss can produce an indeterminate result.
06 / NuGet packages

Publish immutable versions with context.

Mozaic provides NuGet v3 discovery, restore, search, autocomplete, push, symbols, listing, deprecation, and lifecycle operations. Feeds can be private or deliberately public, and standard NuGet clients use the feed URL shown in the Packages workspace.

NuGet v3 service indexreplace the feed identifier
https://{organization-slug}.mozaic.space/nuget/{feed-id}/v3/index.json

Verified release provenance

A verified tag release binds one immutable package archive entry to one exact successful trusted pipeline attempt. Its receipt retains the repository revision, canonical plan, check, artifact identity, size, digest, symbol relationship, signature evidence, and short-lived publication credential.

Version bytes do not drift.

Unlisting and deprecation change lifecycle metadata. Elevated purge is separate and retains a tombstone rather than allowing a different package to reuse the same identity unnoticed.

07 / Work and knowledge

Keep decisions beside delivery.

Work

Starter Bug, Feature, and Task types use governed workflows. Teams can assign work, relate it to other resources, organize boards and milestones, and follow a project activity stream. Public projects can accept public issues and private security reports from authenticated contributors.

Knowledge

Project knowledge supports hierarchical pages, collaborative editing, continuously acknowledged durable operations, history, comments, attachments, structured Markdown, and stable references to engineering resources.

WORKING

Collaborate continuously

The current page can keep changing while the editor reports truthful save, reconnect, and failure state.

PUBLISHED

Release a stable checkpoint

Public readers see only a deliberately published immutable knowledge revision, not an unfinished working draft.

08 / Public projects

Make a project useful without an account.

An explicitly published project home can present the project summary, published knowledge, public repositories, verified builds, public NuGet releases, milestones, visible work, and project activity. Visitors can browse and evaluate; authenticated contributors can submit public work or private security reports and follow the fork-and-proposal path.

Public read is not public write.

Publication exposes only the explicitly permitted view. Creating issues, reports, forks, or proposals still passes through authentication and the relevant authorization policy.

09 / Identity and access

Secure people, roles, and privileged actions.

  • Email-verified accounts use opaque server sessions and local password screening.
  • WebAuthn/FIDO2 passkeys and security keys, TOTP, and single-use recovery codes are supported.
  • Teams, versioned additive roles, scoped assignments, invitations, and stewardship rules govern organization access.
  • Fresh strong authentication is required for selected privileged actions.
  • Security-relevant changes produce governance and audit evidence.

Read the security and trust page for the isolation model and vulnerability-reporting guidance.

10 / Public-beta scope

Current means current.

The beta is an operated hosted service with one complete Git-to-NuGet-and-knowledge path. The following table is intentionally explicit so roadmap ideas are not mistaken for available product behavior.

AreaStatusPublic-beta statement
Version controlCurrentGit smart HTTP and Git LFS; no SSH Git or second production VCS.
ExecutionCurrentIsolated .NET-focused pipeline jobs; no general deployment environments.
PackagesCurrentNuGet v3; no OCI registry or second production package protocol.
CollaborationCurrentWork, knowledge, activity, notifications, and minimal calendar coordination.
Native chat and mediaNot currentNo native chat, direct messages, provider-created meetings, audio, or video.
Distribution and scaleNot currentNo supported self-hosted distribution, multi-node topology, or dedicated tenant infrastructure.
Pre-release support posture.

Mozaic does not yet publish a stable support window. Treat the public beta as pre-release software and preserve independent copies of data you cannot replace.