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.
- Create and verify your account.Use a verified email address and a password of at least 15 characters. Common and breached passwords are blocked.
- Secure privileged actions.Enroll a passkey or security key, or configure a TOTP authenticator. Save the generated single-use recovery codes.
- Name the organization.Choose an explicit owner for the project’s repositories, work, packages, and knowledge. New resources begin non-public.
- Create the first project.Add a project summary, then create a repository or import an existing Git repository from a reachable source.
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.
Tenant and governance boundary
Membership, teams, roles, invitations, publication posture, and stewardship begin here.
Shared engineering context
Source, work, releases, documentation, and public presentation meet around one project identity.
Stable identity
Repositories, revisions, proposals, runs, packages, work items, and pages keep stable references.
Deliberate publication
Private is the default. Public visibility requires an authorized, explicit action at the necessary scopes.
A public child resource does not silently make a private ancestor public, and missing authorization never becomes public access.
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.
Mozaic preserves the source repository’s history, while ongoing mirroring remains outside the current product path.
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.
- Fork into a named organization.The source remains visibly owned by the contributor’s organization, including a single-member organization.
- Open a pull request.Mozaic pins the exact source and target revisions into an immutable proposal snapshot.
- Discuss and review the snapshot.Line threads, general conversations, review decisions, and check results remain associated with the exact proposal.
- Grant execution when needed.External-contributor code runs only after an authorized maintainer grants the exact revision and resolved pipeline plan.
- Merge under policy.Mozaic re-evaluates required reviews, checks, signatures, and merge strategy before atomically updating the protected target.
Updating the proposal invalidates prior execution grants and prevents old check or approval evidence from silently applying to different code.
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.
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.
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.
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.
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.
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.
Collaborate continuously
The current page can keep changing while the editor reports truthful save, reconnect, and failure state.
Release a stable checkpoint
Public readers see only a deliberately published immutable knowledge revision, not an unfinished working draft.
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.
Publication exposes only the explicitly permitted view. Creating issues, reports, forks, or proposals still passes through authentication and the relevant authorization policy.
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.
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.
| Area | Status | Public-beta statement |
|---|---|---|
| Version control | Current | Git smart HTTP and Git LFS; no SSH Git or second production VCS. |
| Execution | Current | Isolated .NET-focused pipeline jobs; no general deployment environments. |
| Packages | Current | NuGet v3; no OCI registry or second production package protocol. |
| Collaboration | Current | Work, knowledge, activity, notifications, and minimal calendar coordination. |
| Native chat and media | Not current | No native chat, direct messages, provider-created meetings, audio, or video. |
| Distribution and scale | Not current | No supported self-hosted distribution, multi-node topology, or dedicated tenant infrastructure. |
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.