Tema# Next.js temaları ve Tecof Studio için.
@tecof/theme-editor Tecof Studio (theme-editor)
v0.0.98 npm README’yi kopyala Görsel sayfa editörü (TecofEditor / TecofStudio), yayın renderer’ı (TecofRender), alan fabrikaları, API istemcisi, stil/tema motoru ve e-posta doküman modeli.
Gereksinim —
Lisans · boyut MIT · 16.3 MB npm pnpm yarn bun
Terminal Kopyala npm install @tecof/theme-editor @tiptap/core @tiptap/pm @tiptap/react lucide-react Terminal Kopyala pnpm add @tecof/theme-editor @tiptap/core @tiptap/pm @tiptap/react lucide-react Terminal Kopyala yarn add @tecof/theme-editor @tiptap/core @tiptap/pm @tiptap/react lucide-react Terminal Kopyala bun add @tecof/theme-editor @tiptap/core @tiptap/pm @tiptap/react lucide-react Giriş noktaları
@tecof/theme-editor — Editör, renderer, alanlar, API istemcisi, yardımcılar @tecof/theme-editor/styles.css — Editör ve alan arayüzü stilleri (zorunlu) @tecof/theme-editor/email — Pazarlama e-postası doküman modeli ve HTML render’ı @tecof/theme-editor/under-construction — Yapım aşaması sayfası bileşeni Peer bağımlılıklar
react@^18 || ^19 react-dom@^18 || ^19 @tiptap/pm@^3.0.0 @tiptap/core@^3.0.0 lucide-react@>=0.408.0 <2 @tiptap/react@^3.0.0
Sürüm geçmişi
0.0.98 · 12 Kas 2026 0.0.97 · 15 Eki 2026 0.0.96 · 23 Eyl 2026 0.0.94 · 21 Eyl 2026 0.0.93 · 21 Eyl 2026 Toplam 94 sürüm · tümü npm’de
app/[slug]/page.tsx Kopyala import { TecofApiClient, TecofRender } from "@tecof/theme-editor" ;
import { editorConfig } from "@/app/editor-config" ;
const client = new TecofApiClient (process.env. NEXT_PUBLIC_BASE_URL ! , process.env. NEXT_PUBLIC_MERCHANT_SECRET_KEY ! );
export default async function Page ({ params } : { params : Promise<{ slug : string }> }) {
const { slug } = await params;
const res = await client. getPublishedPage (slug, "tr" );
if ( ! res.success || ! res.data) return null ;
return < TecofRender data ={ res.data.draftData } config ={ editorConfig } />;
} @tecof/analytics Analytics SDK
v0.0.3 npm README’yi kopyala Gizlilik öncelikli, hafif vitrin analitiği: izleme betiğini enjekte eden TecofAnalyticsProvider ve özel olaylar için useTecofAnalytics().
Gereksinim —
Lisans · boyut — · 38 KB npm pnpm yarn bun
Terminal Kopyala npm install @tecof/analytics Terminal Kopyala pnpm add @tecof/analytics Terminal Kopyala yarn add @tecof/analytics Terminal Kopyala bun add @tecof/analytics Giriş noktaları
@tecof/analytics — TecofAnalyticsProvider, useTecofAnalytics (React 18/19) Peer bağımlılıklar
react@^18 || ^19 react-dom@^18 || ^19
Sürüm geçmişi
0.0.3 · 28 Tem 2026 0.0.2 · 13 Tem 2026 0.0.1 · 30 Haz 2026 app/layout.tsx Kopyala import { TecofAnalyticsProvider } from "@tecof/analytics" ;
< TecofAnalyticsProvider merchantId ={ merchantId } /> Uygulama# Panelde çalışan partner uygulamaları için.
@tecof/app-sdk App SDK (sunucu)
v0.1.0 npm README’yi kopyala Partner uygulamalarının sunucu tarafı: oturum token’ı doğrulama, webhook/aksiyon imzası, kurulum token’ı ve /api/v1 istemcisi (siparişler, ayarlar, Vault, metafield, Tools API).
Gereksinim node >=18
Lisans · boyut UNLICENSED · 262 KB npm pnpm yarn bun
Terminal Kopyala npm install @tecof/app-sdk Terminal Kopyala pnpm add @tecof/app-sdk Terminal Kopyala yarn add @tecof/app-sdk Terminal Kopyala bun add @tecof/app-sdk Giriş noktaları
@tecof/app-sdk — TecofApp, createWebhookHandler, verifyActionRequest, client(…) — Node.js ≥ 18 Sürüm geçmişi
0.1.0 · 11 Eki 2026 İlk sürüm: oturum token’ı, imza doğrulama, kurulum token’ı ve /api/v1 istemcisi; sır döndürmede kendiliğinden süresi dolan önceki sır.
lib/tecof.ts Kopyala import { TecofApp } from "@tecof/app-sdk" ;
export const tecof = new TecofApp ({
clientId: process.env. TECOF_CLIENT_ID ! ,
clientSecret: process.env. TECOF_CLIENT_SECRET ! ,
}); @tecof/app-bridge App Bridge
v0.1.0 npm README’yi kopyala Panele gömülü (iframe) uygulamalar için el sıkışma, oturum token’ı, toast, onay, başlık ve gezinme; React sağlayıcısı ve kancaları.
Gereksinim —
Lisans · boyut UNLICENSED · 154 KB npm pnpm yarn bun
Terminal Kopyala npm install @tecof/app-bridge Terminal Kopyala pnpm add @tecof/app-bridge Terminal Kopyala yarn add @tecof/app-bridge Terminal Kopyala bun add @tecof/app-bridge Giriş noktaları
@tecof/app-bridge — Çerçeveden bağımsız köprü istemcisi @tecof/app-bridge/react — AppBridgeProvider, useSessionFetch ve diğer kancalar Peer bağımlılıklar
react@>=18
Sürüm geçmişi
0.1.0 · 11 Eki 2026 İlk sürüm.
app/settings/page.tsx Kopyala "use client" ;
import { useSessionFetch } from "@tecof/app-bridge/react" ;
const fetch = useSessionFetch (); // her isteğe 60 sn'lik oturum token'ını ekler @tecof/app-ui App UI (tasarım kimliği)
v0.1.0 npm README’yi kopyala Tecof panel görünümünde uygulama arayüzü: React Suite 6 + Tailwind CSS 4 + lucide; AppShell, DataTable, StatusBadge, AppForm ve sunucu-güvenli şema (@tecof/app-ui/schema).
Gereksinim —
Lisans · boyut UNLICENSED · 683 KB npm pnpm yarn bun
Terminal Kopyala npm install @tecof/app-ui @tecof/app-bridge rsuite lucide-react geist Terminal Kopyala pnpm add @tecof/app-ui @tecof/app-bridge rsuite lucide-react geist Terminal Kopyala yarn add @tecof/app-ui @tecof/app-bridge rsuite lucide-react geist Terminal Kopyala bun add @tecof/app-ui @tecof/app-bridge rsuite lucide-react geist Giriş noktaları
@tecof/app-ui — İstemci bileşenleri ("use client") @tecof/app-ui/schema — Sunucu-güvenli şema, doğrulayıcılar, biçimlendiriciler @tecof/app-ui/styles.css — Tailwind 4 belirteçleri ve React Suite eşlemesi Peer bağımlılıklar
react@^19.0.0 rsuite@^6.2.0 react-dom@^19.0.0 lucide-react@>=0.400.0 || ^1.0.0 @tecof/app-bridge@^0.1.0
Sürüm geçmişi
0.1.0 · 11 Eki 2026 İlk sürüm: Tecof uygulama tasarım kimliği, tek şemalı formlar, TR telefon/VKN/TCKN/IBAN doğrulayıcıları.
app/globals.css Kopyala @layer theme, base, rsuite, components, utilities;
@import "tailwindcss" ;
@import "rsuite/dist/rsuite-no-reset.min.css" layer(rsuite);
@import "@tecof/app-ui/styles.css" ; @tecof/invoice-kit Invoice Kit
v0.2.0 npm README’yi kopyala Tecof siparişini doğru Türk faturasına çeviren çekirdek: VKN/TCKN, alıcı sınıflandırma, KDV/indirim/yuvarlama, tutarın yazıyla gösterimi, UBL-TR 1.2 XML; fatura uygulamalarının ortak arayüzü (/ui).
Gereksinim node >=18
Lisans · boyut UNLICENSED · 622 KB npm pnpm yarn bun
Terminal Kopyala npm install @tecof/invoice-kit Terminal Kopyala pnpm add @tecof/invoice-kit Terminal Kopyala yarn add @tecof/invoice-kit Terminal Kopyala bun add @tecof/invoice-kit Giriş noktaları
@tecof/invoice-kit — Bağımlılıksız çekirdek (Node ≥ 18 ve tarayıcı) @tecof/invoice-kit/ui — Fatura uygulaması ekranları (InvoiceShell, ActionFrame…) @tecof/invoice-kit/ui.css — Arayüz stilleri Peer bağımlılıklar
react@^19.0.0 rsuite@^6.2.0 react-dom@^19.0.0 lucide-react@>=0.400.0 || ^1.0.0 @tecof/app-ui@^0.1.0 @tecof/app-bridge@^0.1.0
Sürüm geçmişi
0.2.0 · 11 Eki 2026 @tecof/invoice-kit/ui (fatura uygulamalarının ortak arayüzü); siparişin satır indirim payları kullanılır (KDV matrahı indirim sonrası).
0.1.0 · 11 Eki 2026 İlk sürüm: sipariş → Türk faturası çekirdeği ve UBL-TR 1.2.
lib/invoice.ts Kopyala import { toInvoiceDraft, buildUblInvoice } from "@tecof/invoice-kit" ;
const draft = toInvoiceDraft (order, { defaultVatRate: 20 });
if (draft.warnings. some (( w ) => w.code === "total-mismatch" )) {
// insan kontrolü gerekir
} CLI ve AI# Terminal, CI ve AI ajanları için.
v0.2.0 npm README’yi kopyala tecof komutu: cihaz akışıyla giriş, tema ve uygulama Spaces’leri, artımlı push, staged sürüm, anında canlıya alma/geri alma, bulut geliştirme, CI token’ları ve ajan modu.
Gereksinim node >=20
Lisans · boyut UNLICENSED · 867 KB npm pnpm yarn bun
Terminal Kopyala npm install -g @tecof/cli Terminal Kopyala pnpm add -g @tecof/cli Terminal Kopyala yarn global add @tecof/cli Terminal Kopyala bun add -g @tecof/cli Kurmadan çalıştır Kopyala npx @tecof/cli@latest doctor Giriş noktaları
tecof — Komut satırı (Node.js ≥ 20, çalışma zamanı bağımlılığı yok) Sürüm geçmişi
0.2.0 · 11 Eki 2026 Tecof Spaces: tema/uygulama push, numaralı staged sürümler, promote/rollback, JSON makbuzları ve ajan modu; backend sınırlarıyla hizalama ve base-moved yönlendirmesi; `tecof app init` şablonları @tecof/app-ui kullanır.
0.1.0 · 11 Eki 2026 İlk sürüm: cihaz akışıyla giriş, `tecof app init / dev / deploy`, uygulama sırrı döndürme; çıkışta token sunucuda iptal edilir.
Terminal Kopyala tecof login
tecof doctor
tecof theme ls @tecof/mcp Tecof MCP (stdio)
v0.2.7 npm README’yi kopyala Tema reposunun içinden çalışan stdio MCP sunucusu: bileşen kataloğunu diskten okur, Developer API ile sayfa oluşturur/günceller; remote modda backend araç kataloğunu kullanır.
Gereksinim node >=20
Lisans · boyut MIT · 1.5 MB npm pnpm yarn bun
Terminal Kopyala npx -y @tecof/mcp@latest Terminal Kopyala pnpm dlx @tecof/mcp@latest Terminal Kopyala yarn dlx @tecof/mcp@latest Terminal Kopyala bunx @tecof/mcp@latest Giriş noktaları
tecof-mcp — stdio MCP sunucusu (Node.js ≥ 20) Sürüm geçmişi
0.2.7 · 28 Eyl 2026 0.2.6 · 21 Eyl 2026 0.2.5 · 19 Eyl 2026 0.2.4 · 18 Eyl 2026 0.2.3 · 14 Eyl 2026 Toplam 13 sürüm · tümü npm’de
.mcp.json Kopyala {
"mcpServers" : {
"tecof" : { "command" : "npx" , "args" : [ "-y" , "@tecof/mcp@latest" ] }
}
} Sürüm politikası# 0.0.x sürümlerde npm’in ^ aralığı yalnız aynı yamayı kabul eder (^0.0.96 = 0.0.96); yükseltmek için sürümü package.json’da elle değiştirin.0.x.y sürümlerde ^0.2.0 yalnız 0.2.x yamalarını alır.Projede kurulu sürümü npm ls @tecof/<paket> ile görün; bu sayfanın Markdown’ı (packages.md ) AI araçları için de aynı veriyi verir.