Asya business cards

Open-source digital business card platform by ASYA.

Each user gets a public profile page at /<username> with links, contact info, avatar, and vCard export.

• Public card pages with custom links
• vCard endpoint (/<username>/vcard) for contact import
• Optional contact form per card
• Page analytics (views, link clicks, form submissions, vCard downloads)
• SSO authentication (OIDC via NextAuth)
• Role-based access (user / admin groups)
• Admin panel for user management and default settings
• Avatar upload + crop

• Public card pages use the user displayName as the page title
• All other pages use Asya business cards

• Next.js 16 (App Router)
• React 19
• TypeScript
• Tailwind CSS v4
• Drizzle ORM
• PostgreSQL 17
• NextAuth v5 (beta)
• Docker Compose

• Node.js 22+
• pnpm
• Docker

pnpm install
cp .env.example .env
docker compose up db -d
pnpm db:migrate
pnpm dev

App runs at http://localhost:3000 in local dev.

docker compose up -d --build

Compose services:

• db (PostgreSQL)
• migrate (runs Drizzle migrations once)
• app (Next.js standalone server)

Default published app port in compose: 3017:3000.

All required variables are documented in .env.example.

Do not commit real secrets. Keep .env private.

Before pushing public commits:

• Ensure .env is not tracked
• Ensure no private keys/certs are tracked
• Keep only template values in .env.example
• Review docker-compose.yml for hardcoded credentials
• Run git status and verify only intended files are staged

Add your preferred license file (for example MIT) before publishing.