mi-proyecto-2026

---

🚀 Use This Template

Click the "Use this template" button on GitHub (not git clone) to create your own repository instantly:

1. Go to github.com/Lostovayne/Payload-CMS-3-Nextjs16-Turso-Cloudflare-R2
2. Click "Use this template" → "Create a new repository"
3. Name your project and click Create
4. Clone your new repo and start coding:

git clone https://github.com/YOUR-USERNAME/YOUR-REPO.git
cd YOUR-REPO
pnpm install

Prefer cloning? Run these commands instead:

git clone https://github.com/Lostovayne/Payload-CMS-3-Nextjs16-Turso-Cloudflare-R2.git
cd Payload-CMS-3-Nextjs16-Turso-Cloudflare-R2
git remote set-url origin https://github.com/YOUR-USERNAME/YOUR-REPO.git
pnpm install

---

⚡ Quick Start

# 1. Configure environment
cp .env.example .env
# Edit .env with your credentials

# 2. Start development
pnpm dev

Open http://localhost:3000/admin — create your admin user on first visit.

Environment Variables

Variable	Description	How to get
PAYLOAD_SECRET	Encryption key (min 32 chars)	openssl rand -base64 32
TURSO_DATABASE_URL	Turso database URL	turso db show <db> --url
TURSO_AUTH_TOKEN	Turso auth token	turso db tokens create <db>
R2_BUCKET_NAME	Cloudflare R2 bucket name	Cloudflare Dashboard > R2
R2_ACCESS_KEY_ID	R2 API access key	Manage R2 API Tokens
R2_SECRET_ACCESS_KEY	R2 API secret key	Shown once on creation
R2_ENDPOINT	R2 endpoint URL	https://<account-id>.r2.cloudflarestorage.com

See docs/QUICKSTART.md for step-by-step setup with Turso CLI and Cloudflare Dashboard.

---

✨ Features

• Payload CMS 3.80.0 — Headless CMS with full admin panel
• Next.js 16 App Router — React 19 with server components
• Turso — Edge SQLite database with global replication
• Cloudflare R2 — S3-compatible storage (zero egress fees)
• Lexical Editor — Rich text editing
• JWT Authentication — Built-in user management
• REST + GraphQL — Auto-generated API endpoints
• TypeScript — End-to-end type safety
• Docker — Multi-stage optimized build
• CI/CD — GitHub Actions, auto-format, security audit
• Testing — Vitest (integration) + Playwright (E2E)

---

🛠 Tech Stack

Technology	Version	Purpose
Payload CMS	3.80.0	Headless CMS
Next.js	16.2	React framework
React	19.2.3	UI library
TypeScript	5.9.3	Type safety
Turso / libSQL	0.15.15	Edge database
Cloudflare R2	—	File storage
Drizzle Kit	0.31.10	Database migrations

---

💻 Development

pnpm dev              # Start dev server (http://localhost:3000)
pnpm devsafe          # Start dev server (clean cache)
pnpm build            # Build for production
pnpm lint             # Run ESLint
pnpm format           # Format with Prettier
pnpm test             # Run all tests
pnpm generate:types   # Regenerate TypeScript types

Project Structure

src/
├── app/
│   ├── (frontend)/        # Public frontend
│   ├── (payload)/         # Admin panel
│   ├── api/health/        # Health check endpoint
│   └── my-route/          # Example custom API route
├── collections/
│   ├── Users.ts           # User collection with auth
│   └── Media.ts           # File uploads (stored in R2)
├── payload.config.ts      # Central Payload configuration
└── payload-types.ts       # Auto-generated TypeScript types

---

🚀 Deployment

Platform	Guide
Vercel (recommended)	docs/VERCEL.md
Docker	docker-compose up -d
Railway / Render / Fly.io	docs/DOCKER.md

See docs/DOCKER.md for detailed deployment guides.

---

📚 Documentation

Guide	Description
QUICKSTART.md	Get running in 5 minutes
DEVELOPMENT.md	Create collections, fields, customize
ARCHITECTURE.md	Technical architecture
COMMANDS.md	Complete command reference
CI_CD.md	GitHub Actions and automation

---

🤝 Contributing

Contributions are welcome! Read CONTRIBUTING.md first.

1. Fork the repository
2. Create a branch (git checkout -b feature/my-feature)
3. Commit (git commit -m 'feat: add my feature')
4. Push (git push origin feature/my-feature)
5. Open a Pull Request

---

🔒 Security

Report vulnerabilities via SECURITY.md.

---

📄 License

MIT