A modern, production-ready web application scaffold built with the latest technologies. Llamacto provides everything you need to build scalable, maintainable, and performant web applications.
- 🎯 Modern Stack: Built with Next.js 15, TypeScript, and Tailwind CSS
- 🔐 Authentication: Complete auth system with login, registration, and protected routes
- 📊 Admin Dashboard: Beautiful admin interface with analytics and data visualization
- 🎨 UI Components: Extensive component library with Radix UI and custom designs
- 🌙 Theme System: Dark/light mode with automatic system detection
- 📱 Responsive Design: Mobile-first approach with responsive layouts
- 🔍 TypeScript: Full type safety and excellent developer experience
- 🎭 State Management: Modern state management with Zustand
- 🚦 Validation: Form validation with Zod schemas
- 📈 Performance: Optimized for speed with Next.js App Router
- 🧪 Testing Ready: Pre-configured for testing frameworks
- 📦 Production Ready: Deployment-ready configuration
- Framework: Next.js 15 with App Router
- Language: TypeScript
- Styling: Tailwind CSS
- UI Components: Radix UI
- State Management: Zustand
- Forms: React Hook Form + Zod validation
- Icons: Lucide React
- Theme: next-themes
- Data Fetching: TanStack Query
- Package Manager: pnpm
- Node.js 18+
- pnpm (recommended) or npm
-
Clone the repository
git clone https://github.com/yourusername/llamacto-web.git cd llamacto-web -
Install dependencies
pnpm install
-
Set up environment variables
cp .env.example .env.local # Edit .env.local with your configuration -
Run the development server
pnpm dev
-
Open your browser Navigate to http://localhost:3000
src/
├── app/ # Next.js App Router
│ ├── (auth)/ # Authentication pages
│ ├── (site)/ # Public pages
│ └── console/ # Admin dashboard
├── components/ # Reusable components
│ └── ui/ # UI component library
├── hooks/ # Custom React hooks
├── lib/ # Utility functions
├── providers/ # React context providers
├── store/ # Zustand stores
└── utils/ # Helper utilities
Llamacto includes a comprehensive UI component library built with:
- Radix UI: Unstyled, accessible components
- Tailwind CSS: Utility-first styling
- Custom Components: Button, Card, Input, Modal, etc.
- Form Components: Input, Select, Checkbox, Radio, etc.
- Data Display: Table, Badge, Avatar, etc.
- Navigation: Navbar, Sidebar, Breadcrumb, etc.
Pre-built authentication system includes:
- Login/Register: Email and password authentication
- Protected Routes: Route-level protection
- User Management: User profiles and settings
- Password Reset: Secure password recovery
- Session Management: JWT-based sessions
Full-featured admin interface with:
- Analytics Dashboard: Charts and metrics
- User Management: CRUD operations for users
- Settings Panel: Application configuration
- Data Tables: Sortable, filterable tables
- Responsive Design: Mobile-friendly admin interface
- Push your code to GitHub
- Connect your repository to Vercel
- Deploy with zero configuration
# Build the Docker image
docker build -t llamacto-web .
# Run the container
docker run -p 3000:3000 llamacto-webLlamacto can be deployed to any platform that supports Node.js:
- Netlify
- Railway
- Heroku
- AWS
- Google Cloud
- Azure
# Development
pnpm dev # Start development server
pnpm build # Build for production
pnpm start # Start production server
# Code Quality
pnpm lint # Run ESLint
pnpm lint:fix # Fix ESLint errors
pnpm type-check # Run TypeScript checks
pnpm format # Format code with PrettierWe welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Next.js - The React framework for production
- Tailwind CSS - A utility-first CSS framework
- Radix UI - Low-level UI primitives
- Vercel - Platform for frontend frameworks
- 📧 Email: support@llamacto.com
- 💬 Discord: Join our community
- 📚 Documentation: docs.llamacto.com
- 🐛 Issues: GitHub Issues
Made with ❤️ by the Llamacto Team