Registry / web-framework / create-varity-app

create-varity-app

library2.0.0-beta.22jsnpmunverified

Create Varity App is a command-line interface (CLI) tool designed to bootstrap production-ready web applications with integrated authentication, database, storage, and payment capabilities. Functioning as an 'all-in-one' platform, Varity aims to significantly reduce development and deployment time, boasting '60-second deploys' and claiming 60-80% cost savings compared to traditional cloud setups like AWS. It achieves this through a 'zero-configuration' approach for core services, leveraging internal packages such as `@varity-labs/sdk` for backend interactions and `@varity-labs/ui-kit` for frontend components. The package is currently in a beta state, version `2.0.0-beta.22`, indicating active development and a rapid release cadence for new features and improvements. It targets developers building SaaS products, dashboards, or any web application requiring robust foundational features without extensive manual setup. Key differentiators include its unified platform experience, emphasis on developer experience with React and TypeScript, and a marketplace for monetization.

web-framework auth-security database payments devops

npm install create-varity-app

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CREATE-VARITY-APP

create-varity-app

web-frameworkjavascriptv2.0.0-beta.22

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

create-varity-app

✓ npx create-varity-app my-app

✗ import createVarityApp from 'create-varity-app'

`create-varity-app` is primarily a CLI tool; its programmatic imports are not intended for direct use. Applications are scaffolded using `npx`.

✓ import { db } from '@varity-labs/sdk'

✗ import { database } from '@varity-labs/sdk'

The database instance is exposed as `db` from the core SDK, not a more generic `database`.

AuthProvider

✓ import { AuthProvider } from '@varity-labs/ui-kit'

✗ import { Auth } from '@varity-labs/ui-kit'

Authentication context for React components is provided by `AuthProvider` from the UI kit.

LoginButton

✓ import { LoginButton } from '@varity-labs/ui-kit'

✗ import { ButtonLogin } from '@varity-labs/ui-kit'

Pre-built login component for UI integration.

Initializes a new Varity application, installs dependencies, starts the development server, and demonstrates basic database interaction and UI authentication components within the generated project structure.

npx create-varity-app my-awesome-app cd my-awesome-app npm install npm run dev // Example of using SDK within the created app (e.g., in a React component or API route): import { db } from '@varity-labs/sdk'; import { AuthProvider, LoginButton } from '@varity-labs/ui-kit'; function MyAppComponent() { const handleAddPost = async () => { const posts = db.collection('posts'); const newPost = await posts.add({ title: 'My First Varity Post', content: 'Hello, Varity world!', authorId: 'user-123' // Replace with actual user ID from auth context }); console.log('Added post:', newPost); }; return ( <AuthProvider> <div> <h1>Welcome to Varity!</h1> <LoginButton /> <button onClick={handleAddPost}>Add Example Post</button> </div> </AuthProvider> ); }

create-varity-app --version

Debug

Known issues

gotchaThe `create-varity-app` package and the underlying Varity platform are currently in a `2.0.0-beta.22` state. This indicates active development where APIs, features, and stability might change without strict adherence to semantic versioning for non-major releases, potentially leading to breaking changes between beta versions. Use in production with caution.

fix

Regularly consult the official Varity documentation and GitHub repository for updates and potential migration guides between beta releases. Pin dependencies to specific beta versions to ensure stability.

affects: >=2.0.0-beta.0

gotchaWhile Varity is advertised as an all-in-one platform including payments, the documentation explicitly states that 'Payments (coming soon)' or that the 'PaymentWidget' is for 'post-beta' availability. This means the payments functionality may not be fully implemented or production-ready despite being part of the SDK/UI kit. This could lead to unexpected roadblocks for apps requiring immediate payment processing.

fix

Verify the current status of payments functionality in the latest Varity documentation before building critical payment-dependent features. Plan for alternative payment integrations if Varity's built-in solution is not yet stable or feature-complete for your needs.

affects: >=2.0.0-beta.0

gotchaThe Varity ecosystem includes both a JavaScript `create-varity-app` (via `npx`) and a Python `varitykit` CLI (via `pip`). Mixing these CLIs or misunderstanding their respective roles could lead to confusion or environment setup issues, especially regarding deployment commands (`varitykit deploy`).

fix

Be clear about which CLI tool is appropriate for each task. `create-varity-app` is for scaffolding new projects, while `varitykit` handles deployment and potentially other platform-level operations. Ensure Python and its package manager (`pip`) are correctly set up if using `varitykit`.

affects: >=2.0.0-beta.0

Errors

Common errors & fixes

command not found: create-varity-app

The `create-varity-app` package is typically executed via `npx` and is not installed globally or directly in the system's PATH.

fix

Always use `npx create-varity-app my-app` to execute the package, which downloads and runs the latest version without global installation.

TypeError: Cannot read properties of undefined (reading 'collection') when using `db`

The Varity SDK's database client (`db`) might not be initialized correctly, or the application is running outside the Varity environment where it expects automatic configuration.

fix

Ensure the application is running within the Varity-generated project structure and that all necessary environment variables or configurations are in place as expected by the SDK's 'zero-config' setup. Check Varity documentation for explicit initialization steps if running outside a typical Varity app.

Failed to authenticate / Login fails unexpectedly with AuthProvider or LoginButton

Authentication issues in a Varity app can stem from incorrect Varity platform configuration (e.g., app ID, API keys), network issues preventing communication with Varity auth services, or misconfiguration of social login providers.

fix

Verify that your Varity project is correctly configured on the Varity platform. Check console logs for network errors or specific authentication error messages. Ensure that the `AuthProvider` wraps your application's components as per documentation.

Upgrade

Version history

2.0.0-beta.22latest on npm

Audit

Dependencies

@varity-labs/sdkrequiredCore SDK for database, storage, and other backend interactions within Varity applications.

@varity-labs/ui-kitrequiredReact component library for authentication, payments, and account management within Varity applications.

Agent activity

21 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/varity-labs/varity-sdk ↗

packagehttps://www.npmjs.com/package/create-varity-app ↗

homepagehttps://varity.app ↗