ZCore

Portable credit scoring for Stellar DeFi.
Zero-knowledge, on-chain only. No banks. No forms. Just your wallet.

zcore.vercel.app · Contributing · Issues

---

What is this repo?

This repository contains the ZCore marketing site: animations, informational sections, and CTAs to the dapp.

Live site: zcore.vercel.app

Includes	Does not include
Hero, partners, scoring, tiers, builders	Login / register
Animations and visual effects	Dashboard
Dapp links via env var	Backend API
Custom 404 page	Event history

The authenticated dapp and backend live in separate repos. See ZCore-dev.

---

Quick start

git clone https://github.com/Zcorehub/Zcore-Landing.git
cd Zcore-Landing
npm install
cp .env.example .env.local
npm run dev

Open http://localhost:3000.

Environment variables

Variable	Required	Description
NEXT_PUBLIC_DAPP_URL	No	Deployed dapp URL. Without it, CTAs point to #launch.

NEXT_PUBLIC_DAPP_URL=https://app.zcore.xyz

Scripts

Command	Description
npm run dev	Development server
npm run build	Production build
npm run start	Post-build server
npm run lint	ESLint

---

Landing sections

Section	Component	Description
Hero	hero.tsx	Headline, ZK badge, animated score preview
Marquee	marquee.tsx	Claim ticker (no custody, open source, etc.)
How It Works	how-it-works.tsx	3 steps: wallet → chain → score
Partners	partners.tsx	Trustless Work, Blend, Vaquita
Score System	score-system.tsx	0-850 engine, transparent breakdown
Tiers	tiers.tsx	Risk bands in % (LTV, default, APR)
Builders	builders.tsx	API preview for integrators
CTA	cta.tsx	Final call-to-action to the dapp

---

Stack

Layer	Technology
Framework	Next.js 14 (App Router)
Language	TypeScript
Styling	Tailwind CSS + custom ZK utilities
UI base	shadcn/ui (components/ui/)
Icons	lucide-react
Fonts	Inter (headline), JetBrains Mono (badge), Space Mono (ZK UI)

---

Design

Monochrome zero-knowledge aesthetic: pure black, white, opaque grays. No color accents.

• Background: #000000
• ZK typography: font-zk (Space Mono) for UI, labels, and sections
• Hero headline: Inter bold: YOUR WALLET IS YOUR CREDIT.
• Badge: JetBrains Mono: Zero-Knowledge · On-chain only
• Angular corners: zk-slash and zk-badge utilities in globals.css
• Logo: logo_name.png in navbar and footer (components/landing/logo.tsx)
• Favicon: logo.jpeg (Z mark only)

---

Project structure

app/
  page.tsx          # Main landing page
  layout.tsx        # Fonts and metadata
  not-found.tsx     # Custom 404
  globals.css       # ZK tokens and utilities

components/
  landing/          # Landing sections (one component per section)
  ui/               # shadcn primitives (Button, Badge, Card…)

lib/
  site.ts           # Site config + getDappUrl()
  utils.ts          # cn() and helpers

public/
  logo_name.png     # Primary wordmark logo
  logo.jpeg         # Z mark: favicon only

---

Deploy on Vercel

Production: https://zcore.vercel.app

1. Import the repo at vercel.com/new (project name: zcore).
2. Framework preset: Next.js (auto-detected via vercel.json).
3. Add NEXT_PUBLIC_DAPP_URL under Environment Variables.
4. Deploy.

npx vercel link --project zcore
npx vercel          # preview
npx vercel --prod   # production

---

Contributing

Want to improve the landing? Read the full guide in CONTRIBUTING.md.

Quick flow:

1. Open or pick an issue.
2. Fork → branch (feat/name, fix/name, style/name).
3. npm run dev + verify responsive layout.
4. Open a PR using the template.