with only the final specialization\n# 4. Reuse shared-full and the shared feature layers where appropriate\n# 5. Test template generation\nnpx starkon test-app --template your-template\n\n# 6. Update README.md with template documentation\n# 7. Submit PR\n```\n\nTemplate sources are composed in manifest order. `shared` is the universal\nbaseline, `shared-full` contains the Full App infrastructure and UI kit, and\nthe `shared-product`, `shared-corporate`, `shared-marketing`, and\n`shared-public` layers add reusable feature slices. The dedicated template\ndirectory is always last and should contain only intentional overrides or\ntemplate-specific files.\n\nLayer-local `package.json` files are fragments. Starkon merges their `scripts`,\ndependency groups, and `engines` in manifest order before applying the generated\nproject name and standard scripts. Keep shared dependencies in the narrowest\nreusable layer and template identity fields in the dedicated fragment.\n\n### Guidelines\n\n- **Code Quality:** Follow ESLint and Prettier rules\n- **Testing:** Add tests for new features\n- **Documentation:** Update README for new features\n- **TypeScript:** Maintain full type safety\n- **Conventional Commits:** Use `npm run commit` for commits\n\n## 📈 Performance\n\n### Bundle Analysis\n\n```bash\n# Analyze the repository app build\nnpm run analyze\n```\n\n### Optimization Features\n\n- **Automatic Code Splitting** - Route-based splitting\n- **Image Optimization** - Next.js Image component\n- **Font Optimization** - Google Fonts optimization\n- **Static Generation** - ISG and SSG support\n- **Edge Runtime** - Faster cold starts\n- **React Server Components** - Reduced client bundle\n\n## 🛠️ Troubleshooting\n\n### Common Issues\n\n**Build Errors:**\n\n```bash\n# Clear Next.js cache\nrm -rf .next\n\n# Clear npm cache\nnpm cache clean --force\n\n# Reinstall dependencies\nrm -rf node_modules package-lock.json\nnpm install\n```\n\n**TypeScript Errors:**\n\n```bash\n# Check types without building\nnpm run type-check\n\n# Clear TypeScript cache\nrm -rf node_modules/.cache\n```\n\n**Authentication Issues:**\n\n```bash\n# Check token in browser storage\n# DevTools -> Application -> Session Storage -> tokens\n\n# Clear all auth data\nlocalStorage.clear()\nsessionStorage.clear()\n```\n\n**i18n Not Working:**\n\n```bash\n# Check language detection priority:\n# 1. localStorage 'language' key\n# 2. Cookie 'language' key\n# 3. URL parameter ?lang=en\n# 4. Browser navigator.language\n# 5. Default: 'tr'\n\n# Force language\nlocalStorage.setItem('language', 'en')\n```\n\n**Component Not Found:**\n\n```bash\n# Check import path uses @ alias\nimport { Button } from '@/components/core/button' # ✅ Correct\nimport { Button } from '../components/core/button' # ❌ Wrong\n\n# Verify tsconfig.json has paths configured:\n# \"@/*\": [\"./src/*\"]\n```\n\n### Getting Help\n\n- 🐛 **Bug Reports:** [GitHub Issues](https://github.com/zzafergok/starkon/issues)\n- 💬 **Questions:** [Discussions](https://github.com/zzafergok/starkon/discussions)\n- 📧 **Contact:** [zafer@starkon.website](mailto:zafer@starkon.website)\n- 📚 **Documentation:** [CLAUDE.md](CLAUDE.md) (for development)\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n**Core Technologies:**\n\n- **[Next.js](https://nextjs.org/)** - The React framework for production\n- **[Radix UI](https://www.radix-ui.com/)** - Low-level accessible UI primitives\n- **[Tailwind CSS](https://tailwindcss.com/)** - Utility-first CSS framework\n- **[React Query](https://tanstack.com/query)** - Powerful data synchronization\n- **[Zustand](https://zustand-demo.pmnd.rs/)** - Lightweight state management\n\n**Inspiration:**\n\n- **[shadcn/ui](https://ui.shadcn.com/)** - Component design patterns\n- **[T3 Stack](https://create.t3.gg/)** - TypeScript-first development\n- **[Vercel Templates](https://vercel.com/templates)** - Deployment optimization\n\n---\n\n\n\n### 🌊 Ready to Build Something Amazing?\n\n**[Get Started](https://github.com/zzafergok/starkon#quick-start) • [View Examples](https://starkon.website) • [Read Docs](https://github.com/zzafergok/starkon/wiki)**\n\nMade with ❤️ by [Zafer Gök](https://github.com/zzafergok)\n\n⭐ **If Starkon helped you ship faster, please give us a star on GitHub!**\n\n
\n\n---\n\n## 📊 Stats\n\n- 🎨 **46 UI Components** ready to use\n- 🔐 **Auth Starter Foundation** with BFF endpoints & HttpOnly cookie guards\n- 🌍 **2 Languages** supported (English, Turkish) with easy expansion\n- 📱 **6 Templates** fully supported via interactive CLI\n- 🪝 **7 Custom Hooks** for common patterns\n- 🔌 **5 Providers** for app-wide state management\n- ⚡ **Interactive CLI generator** with arrow key navigation\n- 🚀 **< 30 seconds** from CLI to running app\n- 🛠️ **Integration Ready** - preconfigured baseline for your custom backend\n- 📦 **React 19** & **Next.js 16** - Latest versions\n","readmeFilename":"README.md"}