https://github.com/natuleadan/nla-template
Next.js 16 e-commerce template with shadcn/ui components, API routes, dynamic brand theming via Radix UI color palettes, and infinite scroll product filtering.
https://github.com/natuleadan/nla-template
ecommerce nextjs nextjs-template radix-ui scalar shadcn tailwindcss turbopack typescript vercel
Last synced: 2 months ago
JSON representation
Next.js 16 e-commerce template with shadcn/ui components, API routes, dynamic brand theming via Radix UI color palettes, and infinite scroll product filtering.
- Host: GitHub
- URL: https://github.com/natuleadan/nla-template
- Owner: natuleadan
- License: mit
- Created: 2026-04-25T17:26:10.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-25T19:00:56.000Z (2 months ago)
- Last Synced: 2026-04-25T19:23:36.309Z (2 months ago)
- Topics: ecommerce, nextjs, nextjs-template, radix-ui, scalar, shadcn, tailwindcss, turbopack, typescript, vercel
- Language: TypeScript
- Homepage:
- Size: 239 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
NLA Template
Next.js 16 E-commerce Template with shadcn/ui
> ⚠️ **Active Development** — This template is under active construction. APIs, module interfaces, and features may change without prior notice. For production use, rely only on tagged releases (`vX.Y.Z`).
## 1. What is NLA Template?
NLA Template is a Next.js 16 e-commerce starter template with shadcn/ui components. It provides a complete foundation for building modern e-commerce applications with REST API, authentication, and best practices.
Built with Next.js 16, TypeScript, Tailwind CSS, and shadcn/ui. Ready to deploy to Vercel with CI/CD and automated releases.
## 2. Features
- **Next.js 16** with App Router and Turbopack
- **shadcn/ui** components for modern UI
- **REST API** with 8 categories and 4 endpoints each (GET/POST/PUT/DELETE)
- **Scalar API Documentation** at `/api`
- **Husky + Commitlint** for conventional commits
- **GitHub Actions CI/CD** with build, lint, and test
- **Semantic Release** for automated versioning
- **CodeQL** security scanning
- **Cookie Consent** with shadcn components
- **Geolocation** service with Vercel headers
- **Notifications** with Sonner
- **Product Gallery** with carousel and fallback images
## 3. Technology Stack
- **Framework**: Next.js 16 with App Router
- **Language**: TypeScript 5.7+
- **UI**: shadcn/ui + Tailwind CSS
- **API**: Next.js Route Handlers (REST)
- **Documentation**: Scalar
- **Testing**: Vitest
- **CI/CD**: GitHub Actions
- **Hosting**: Vercel
## 4. Getting Started
```bash
# Clone the repository
git clone https://github.com/natuleadan/nla-template.git
# Install dependencies
pnpm install
# Configure environment variables
cp .env.example .env.local
# Run development server
pnpm dev
```
## 5. Environment Variables
| Variable | Description | Default |
|----------|-------------|---------|
| `API_KEY` | API key for protected endpoints | (required) |
| `NEXT_PUBLIC_BASE_URL` | Base URL of the application | http://localhost:3000 |
| `NEXT_PUBLIC_WHATSAPP_NUMBER` | WhatsApp number for orders | 1234567890 |
## 6. API Endpoints
| Category | Endpoints |
|----------|-----------|
| `products` | GET, POST, PUT, DELETE |
| `products/[slug]` | GET, POST, PUT, DELETE |
| `categories` | GET, POST, PUT, DELETE |
| `pages` | GET, POST, PUT, DELETE |
| `formulario` | GET, POST, PUT, DELETE |
| `resenas` | GET, POST, PUT, DELETE |
| `inventario` | GET, POST, PUT, DELETE |
| `pedidos` | GET, POST, PUT, DELETE |
### Authentication
POST/PUT/DELETE endpoints require the header:
```
x-api-key: your_api_key
```
## 7. Available Scripts
| Script | Description |
|--------|-------------|
| `pnpm dev` | Start development server |
| `pnpm build` | Build for production |
| `pnpm start` | Start production server |
| `pnpm lint` | Run ESLint |
| `pnpm test` | Run tests |
## 8. Project Structure
```
app/
├── api/ # REST API endpoints
│ └── v1/ # API v1 (8 categories)
components/
├── ui/ # shadcn/ui components
├── layout/ # Navbar, Footer
├── products/ # ProductCard, ProductDetails
lib/
├── config/ # Environment variables
└── modules/ # Business logic
├── products/ # Product management
├── reviews/ # Reviews
├── inventory/ # Inventory
└── scalar/ # API documentation
public/
├── design/ # Icons and placeholders
└── store/ # Product images
```
## 9. License
MIT License
Copyright (c) 2026 NATULEADAN SAS BIC
---
## 10. Contributors
Developed by [Leonardo Jara](https://github.com/leojara95).
Thanks to all contributors:
---
## Star History
