🚨 Shai-Hulud Strikes Again:834 Packages Compromised.Technical Analysis →
Socket
Book a DemoInstallSign in
Socket

starkon-template

Package Overview
Dependencies
Maintainers
1
Versions
5
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install
Package was removed
Sorry, it seems this package was removed from the registry

starkon-template

Create a Next.js project with Starkon Template

latest
Source
npmnpm
Version
0.0.8
Version published
Maintainers
1
Created
Source

Starkon Template

Starkon Template, modern React uygulamaları için tasarlanmış kapsamlı bir component kütüphanesidir. Radix UI tabanlı, erişilebilir ve özelleştirilebilir komponentler sunar.

Kurulum

npx create-starkon-template my-project
cd my-project
npm install
npm run dev
starkon-template/
├── src/
│   ├── app/                    # Next.js App Router
│   │   ├── (auth)/            # Korumalı rotalar grubu
│   │   │   ├── components/    # Bileşenler showcase sayfası
│   │   │   ├── dashboard/     # Ana kontrol paneli
│   │   │   ├── settings/      # Kullanıcı ayarları
│   │   │   └── layout.tsx     # Auth layout bileşeni
│   │   ├── auth/              # Authentication sayfaları
│   │   │   └── login/         # Giriş sayfası
│   │   ├── globals.css        # Global stil tanımları
│   │   ├── layout.tsx         # Kök layout bileşeni
│   │   └── page.tsx           # Ana sayfa
│   ├── components/            # Component kütüphanesi
│   │   ├── core/              # Temel UI bileşenleri
│   │   │   ├── Accordion/     # Genişletilebilir içerik
│   │   │   ├── AlertDialog/   # Uyarı diyalogları
│   │   │   ├── Avatar/        # Kullanıcı avatarları
│   │   │   ├── Badge/         # Durum etiketleri
│   │   │   ├── Button/        # Etkileşimli butonlar
│   │   │   ├── Card/          # İçerik kartları
│   │   │   ├── Checkbox/      # Seçim kutuları
│   │   │   ├── CommandMenu/   # Komut menüsü
│   │   │   ├── DataTable/     # Gelişmiş veri tablosu
│   │   │   ├── Dialog/        # Modal diyaloglar
│   │   │   ├── Dropdown/      # Açılır menüler
│   │   │   ├── Input/         # Metin giriş alanları
│   │   │   ├── Label/         # Form etiketleri
│   │   │   ├── Loading/       # Yükleme animasyonları
│   │   │   ├── Popover/       # Açılır içerik kutuları
│   │   │   ├── Select/        # Seçim dropdownları
│   │   │   ├── Separator/     # Ayırıcı çizgiler
│   │   │   ├── Skeleton/      # Yükleme placeholderları
│   │   │   ├── Slider/        # Değer seçici kaydırıcılar
│   │   │   ├── Switch/        # Açma/kapama düğmeleri
│   │   │   ├── Tabs/          # Sekme navigasyonu
│   │   │   ├── Textarea/      # Çok satırlı metin alanları
│   │   │   ├── Toast/         # Bildirim mesajları
│   │   │   └── Tooltip/       # Yardım ipuçları
│   │   ├── forms/             # Form bileşenleri
│   │   │   └── auth/          # Authentication formları
│   │   └── ui/                # Özel UI bileşenleri
│   │       ├── ComponentDemo/ # Bileşen demo wrapper
│   │       ├── ErrorBoundary/ # Hata yakalama
│   │       ├── FileUpload/    # Dosya yükleme
│   │       ├── LanguageToggle/# Dil değiştirici
│   │       ├── PageHeader/    # Sayfa başlığı
│   │       ├── ThemeToggle/   # Tema değiştirici
│   │       └── ToastContainer/# Toast yöneticisi
│   ├── data/                  # Statik veri dosyaları
│   │   └── componentDemoData.tsx # Demo component verileri
│   ├── hooks/                 # Özel React hook'ları
│   │   ├── useAuth.ts         # Authentication yönetimi
│   │   ├── useDropdownPortal.ts # Dropdown portal yönetimi
│   │   ├── useDropdownState.ts  # Dropdown durumu
│   │   ├── useForm.ts         # Form yönetimi (Zod entegrasyonu)
│   │   ├── useLocalStorage.ts # LocalStorage hook'u
│   │   ├── useLocale.ts       # Çoklu dil desteği
│   │   ├── useScrollbarCompensation.ts # Scrollbar telafisi
│   │   ├── useTheme.ts        # Tema yönetimi
│   │   └── useTokenManager.ts # Token yönetimi
│   ├── lib/                   # Yardımcı kütüphaneler
│   │   ├── locale-utils.ts    # Dil yardımcıları
│   │   ├── utils.ts           # Genel yardımcı fonksiyonlar
│   │   └── validations/       # Form validasyon şemaları
│   │       └── auth.ts        # Authentication validasyonları
│   ├── locales/               # Çoklu dil desteği
│   │   ├── en/                # İngilizce çeviriler
│   │   ├── tr/                # Türkçe çeviriler
│   │   └── index.ts           # i18n yapılandırması
│   ├── providers/             # React context sağlayıcıları
│   │   ├── AuthProvider.tsx   # Authentication context
│   │   ├── ClientProviders.tsx# Client-side provider wrapper
│   │   └── TokenManagerProvider.tsx # Token yönetim context
│   ├── services/              # API ve servis katmanları
│   │   ├── apiService.ts      # Ana API servisi
│   │   ├── apiSlice.ts        # RTK Query API slice
│   │   ├── authService.ts     # Authentication servisleri
│   │   ├── constants.ts       # API sabitleri
│   │   ├── tokenManager.ts    # Token yönetim servisi
│   │   └── utils.ts           # Servis yardımcıları
│   ├── store/                 # Redux Toolkit store
│   │   ├── slices/            # Redux slice'ları
│   │   │   ├── langSlice.ts   # Dil durumu
│   │   │   ├── loadingSlice.ts# Yükleme durumu
│   │   │   ├── themeSlice.ts  # Tema durumu
│   │   │   ├── toastSlice.ts  # Toast bildirimleri
│   │   │   └── userSlice.ts   # Kullanıcı durumu
│   │   ├── index.ts           # Store yapılandırması
│   │   └── types.ts           # Store tip tanımları
│   ├── types/                 # TypeScript tip tanımları
│   │   └── index.ts           # Genel tip tanımları
│   ├── utils/                 # Yardımcı fonksiyonlar
│   │   └── security.ts        # Güvenlik yardımcıları
│   ├── index.ts               # Ana export dosyası
│   └── middleware.ts          # Next.js middleware
├── public/                    # Statik dosyalar
│   ├── favicon.svg            # Site ikonu
│   ├── robots.txt             # Robot yönergeleri
│   └── site.webmanifest       # PWA manifest
├── next.config.mjs            # Next.js yapılandırması
├── tailwind.config.mjs        # Tailwind CSS yapılandırması
├── postcss.config.mjs         # PostCSS yapılandırması
├── tsconfig.json              # TypeScript yapılandırması
├── package.json               # Proje bağımlılıkları
└── README.md                  # Bu dosya

Ă–zellikler

Temel BileĹźenler

  • Button: 5 farklı varyant, 4 boyut seçeneÄźi, loading durumu
  • Input: ÇeĹźitli varyantlar, ikon desteÄźi, validasyon entegrasyonu
  • Card: Esnek içerik kartları, hover efektleri
  • Dialog: Modal diyaloglar, eriĹźilebilir tasarım
  • Select: Ă–zelleĹźtirilebilir dropdown seçiciler
  • DataTable: Sıralama, filtreleme, sayfalama desteÄźi

Form Yönetimi

  • React Hook Form entegrasyonu
  • Zod validasyon Ĺźemaları
  • Çoklu dil form hata mesajları
  • Otomatik form durumu yönetimi

Çoklu Dil Desteği

  • TĂĽrkçe ve İngilizce dil desteÄźi
  • i18next entegrasyonu
  • Otomatik dil algılama
  • Cookie tabanlı dil tercihi

Tema Sistemi

  • Açık/koyu tema desteÄźi
  • Sistem tercihi algılama
  • CSS custom properties ile renk yönetimi
  • Smooth tema geçiĹźleri

State Yönetimi

  • Redux Toolkit ile merkezi state
  • Redux Persist ile kalıcı veri
  • Optimistic UI gĂĽncellemeleri
  • Real-time bildirim sistemi

Authentication

  • JWT token yönetimi
  • Otomatik token yenileme
  • Korumalı rota sistemi
  • Middleware tabanlı yetkilendirme

GeliĹźtirici Deneyimi

  • TypeScript ile tip gĂĽvenliÄźi
  • ESLint ve Prettier entegrasyonu
  • Storybook benzeri component showcase
  • Kapsamlı JSDoc dokĂĽmantasyonu

Kullanılan Teknolojiler

Frontend Framework

  • Next.js 15 - React framework
  • React 18 - UI kĂĽtĂĽphanesi
  • TypeScript - Tip gĂĽvenliÄźi

UI/UX

  • Tailwind CSS - Utility-first CSS framework
  • Radix UI - Headless UI primitives
  • Lucide React - İkon kĂĽtĂĽphanesi
  • Framer Motion - Animasyon kĂĽtĂĽphanesi

State Management

  • Redux Toolkit - State yönetimi
  • React Redux - React-Redux baÄźlantısı
  • Redux Persist - State kalıcılığı

Form Yönetimi

  • React Hook Form - Form yönetimi
  • Zod - Schema validation
  • @hookform/resolvers - Zod entegrasyonu

Çoklu Dil

  • i18next - UluslararasılaĹźtırma
  • react-i18next - React entegrasyonu
  • i18next-browser-languagedetector - Dil algılama

API Yönetimi

  • RTK Query - Data fetching
  • Axios - HTTP client

Development Tools

  • ESLint - Kod kalitesi
  • Prettier - Kod formatlaması
  • PostCSS - CSS iĹźleme

Başlangıç

Gereksinimler

  • Node.js 18.0.0 veya ĂĽzeri
  • npm, yarn veya pnpm

Kurulum ve Çalıştırma

Projeyi oluĹźtur

npx create-starkon-template my-app
cd my-app

# Bağımlılıkları yükle
npm install

# GeliĹźtirme sunucusunu baĹźlat
npm run dev

`Tarayıcıda http://localhost:3000 adresini aç`

Build ve Deploy

# Production build
npm run build

# Production sunucusunu baĹźlat
npm start

# Kod kalitesi kontrolĂĽ
npm run lint

# TypeScript kontrolleri
npm run type-check

# Kod formatlaması
npm run prettier

Sayfalar

### Ana Sayfalar

-   `/` - Landing page
-   `/dashboard` - Kullanıcı dashboard'u (korumalı)
-   `/components` - Component showcase (korumalı)
-   `/settings` - Kullanıcı ayarları (korumalı)

### Authentication

-   `/auth/login` - Giriş sayfası

Demo Kullanıcıları

Admin: admin@example.com / Admin123!
User: user@example.com / User123!
Demo: demo@example.com / Demo123!

Component Showcase

Component showcase sayfası (`/components`) tüm mevcut bileşenleri interaktif olarak sunar:

-   Gerçek zamanlı preview
-   Kod örnekleri
-   Props dokĂĽmantasyonu
-   Kullanım senaryoları
-   Filtreleme ve arama

Ă–zelleĹźtirme

Tema Ă–zelleĹźtirme

tailwind.config.mjs dosyasında renk paleti ve tasarım sistemini özelleştirebilirsiniz:

// Özel renkler tanımlama
colors: {
  primary: {
    50: 'hsl(var(--primary-50))',
    // ... diÄźer tonlar
  }
}

Yeni Dil Ekleme

  • src/locales/ altında yeni dil klasörĂĽ oluĹźturun
  • translation.json dosyasını çevirin
  • src/lib/locale-utils.ts dosyasında dili SUPPORTED_LOCALES'a ekleyin

Yeni Component Ekleme

  • src/components/core/ altında component klasörĂĽ oluĹźturun
  • Component'i geliĹźtirin
  • src/index.ts dosyasından export edin
  • src/data/componentDemoData.tsx dosyasına demo ekleyin

API Entegrasyonu

Proje mock authentication kullanır, ancak gerçek API entegrasyonu için:

  • src/config/api.ts dosyasında API URL'lerini gĂĽncelleyin
  • src/services/apiSlice.ts dosyasında endpoint'leri tanımlayın
  • Authentication logic'ini src/hooks/useAuth.ts dosyasında gĂĽncelleyin

Deployment

Vercel (Ă–nerilen)

npm install -g vercel
vercel

Netlify

npm run build
# out/ klasörünü Netlify'a yükleyin

Docker

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "start"]

Katkıda Bulunma

  • Fork yapın
  • Feature branch oluĹźturun (git checkout -b feature/amazing-feature)
  • DeÄźiĹźikliklerinizi commit edin (git commit -m 'Add amazing feature')
  • Branch'inizi push edin (git push origin feature/amazing-feature)
  • Pull Request oluĹźturun

Lisans

MIT License - detaylar için LICENSE dosyasına bakın.

İletişim

Keywords

ui

FAQs

Package last updated on 07 Jun 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts