Avis

Equip your project after init.

Avis is a source-available, ecosystem-agnostic CLI that safely adds, configures, and verifies common development capabilities inside existing software projects.

Framework scaffolders create the project. Avis equips it.

Avis is for the part after the starter template: the moment you realize a real app still needs auth, validation, forms, API tooling, monitoring, storage, email, caching, background jobs, and a dozen careful little setup steps you have done before.

$ npm install -g avis-dev@alpha
$ cd my-next-app
$ avis search icons

Search results for "icons":
- capability: icons (Icons) - Icon libraries and icon systems for application interfaces.
- integration: lucide-react (Lucide React) - A consistent, tree-shakeable outline icon system for React interfaces.

$ avis add icons

Detected:
Framework: nextjs
Language: typescript
Ecosystem: node
Package manager: pnpm

Recommendation:
Use lucide-react for icons.

Avis will make these changes:

Dependencies
+ lucide-react

Apply changes? Yes
OK Installed lucide-react.

Verification:
OK dependency installed

Why Avis Exists

After create-next-app, django-admin startproject, rails new, cargo new, dotnet new, or another framework initializer, developers still repeat the same setup work: state management, data fetching, forms, validation, API tooling, testing, monitoring, storage, background jobs, and more.

Avis starts after project initialization. It detects the project you already have, lets you ask for a purpose such as icons, validation, or state-management, recommends compatible integrations, previews a ChangePlan, asks before applying changes, and then verifies the result.

The public path is capability-first. You do not need to know whether the right command is avis add lucide-react, avis add react-icons, or avis add heroicons-react; start with avis add icons and let Avis show the recommendation and alternatives.

What Avis Gives You

Capability-first setup

Ask for what your project needs: auth, forms, monitoring, storage, background-jobs, or api-documentation. Avis maps the purpose to compatible tools for the detected project.

ChangePlans before changes

Avis shows dependencies, files, environment entries, and configuration patches before applying them. You see the work before it touches the repo.

Real project verification

avis doctor inspects the actual project state. A package installed in package.json or requirements.txt is not treated as complete setup by itself.

Safer repair

V3.1 repair flows are explicit and conservative. Managed repair checks Avis state hashes and stops when local edits make automation ambiguous.

V3.1 Alpha Focus

V3.1 is a release-hardening pass. It introduces clearer setup maturity, stronger catalog validation, fixture-based QA, packaged CLI smoke testing, and safer repair behavior.

Avis now classifies integration support as:

install: add a compatible dependency
configure: add dependency plus useful starter files or configuration
managed: verify setup health and generate supported repair plans

Repair is intentionally conservative. avis repair only runs where an integration declares repair-plan support, and it checks Avis’ recorded file hashes before mutating managed files. If local edits make a repair ambiguous, Avis stops for manual review rather than overwriting user work.

V3.1 Integration Depth

Next.js

Zustand, Redux Toolkit, TanStack Query, Zod, React Hook Form, Auth.js, Sentry for Next.js, Lucide React, React Icons, and Heroicons React.

Django

Managed Django REST Framework and django-cors-headers, plus configure-level Celery, Redis, Anymail, Storages, DRF Spectacular, and Sentry support.

Backend services

SQLAlchemy, Redis, Resend, AWS S3 SDK, Swagger UI Express, FastAPI settings, Go/Gin validation, pgx, GORM, Viper, and Sentry ecosystem entries.

Cross-ecosystem alpha

Node, Python, PHP, Dart, Rust, and Go project signals are represented in the registry, with support depth documented per framework and integration.

How Avis Works

Detect

Avis inspects the current project for ecosystem, framework, language, and package manager signals.

Plan

An integration generates a ChangePlan listing dependencies, files, configuration patches, and diagnostics.

Apply

Avis validates the plan, shows it to you, and asks for confirmation before modifying the project.

Verify

avis doctor checks actual project state so installed dependencies are not mistaken for complete setup.

Current Support

Next.js

Status: alpha. Current integrations include Zustand, Redux Toolkit, TanStack Query, Zod, React Hook Form, Auth.js, Sentry for Next.js, Lucide React, React Icons, and Heroicons React.

Django

Status: alpha. Managed support includes Django REST Framework and django-cors-headers. Configure-level support includes Celery, Redis, storage, email, API docs, and Sentry snippets.

Laravel

Status: alpha. Current integration: Laravel Sanctum.

Flutter

Status: alpha. Current integration: Flutter Riverpod.

Rust

Status: alpha. Current integration: Rust tracing.

Avis is currently in active development. Review ChangePlans before applying changes and use Avis inside projects tracked with version control.

More Than Installation

avis doctor is a core part of Avis. A dependency being present is not enough to mark an integration healthy. For example, a Next.js project with @tanstack/react-query installed but no generated provider module is reported as partially configured.

The V3.1 release gate also tests the package as users receive it: Avis packs the npm artifact, installs the generated tarball into a clean temporary project, and exercises the installed avis binary before release.

Explore the Catalog

Start with Supported Projects to see framework-level support.
Read Integration Maturity to understand install, configure, and managed setup.
Browse Integrations for capability-grouped integration pages.
Check the Generated Registry for the complete manifest table.

Contribute

Avis is designed to become community-extensible, but it is not ready for broad external code contributions yet. Contributor docs are included so the project can open up cleanly when the foundation is stable.

Equip Your Next Project

Get Started or view Avis on GitHub.