About This Project
YwyBase: Solid ground to build and grow.
Ywy
The name YwyBase is rooted in the ancestral heritage of Araucária, Paraná, a city built atop the historical site of the village of Tindiqüera. In the Tupi-Guarani language family, Ywy (or Yvy) translates literally to "earth," "soil," or "land"—the most fundamental substrate upon which all life and structures are established. By adopting this term, the project honors the regional identity of its birthplace while symbolizing the high-performance, resilient "ground" provided to developers as a starting point for their applications.
Beyond its linguistic origin, the name reflects the geological stability of the Paraná Shield (Escudo Paranaense), the ancient crystalline basement that has sustained the region's landscape for billions of years. Just as the Guarani concept of Ywyrupa represents a continuous terrestrial platform where interconnected communities thrive together, YwyBase serves as a unified, "solid ground" designed to support the weight of complex software ecosystems. The combination of the indigenous root for earth with the technical term "Base" signals a project that is both deeply rooted in history and engineered for modern scalability.
The Araucária tree is emblematic of the region’s landscape, showcasing its natural beauty and resilience. This species dates back to the Mesozoic era. Just as the Araucária has withstood the test of time, YwyBase is designed to provide a stable and enduring foundation for developers to build upon.
Why Choose YwyBase
Stop rebuilding the same foundations. YwyBase gives you an opinionated starting point so you can begin shaping product value instead of rebuilding auth, forms, and architecture for the tenth time.
🚀 Ship Faster
From authentication to database schema, everything is pre-configured. Focus on your unique business logic from day one.
🛡️ Built Secure
Enterprise-grade security out of the box: rate limiting, CSRF protection, security headers, and error tracking.
🎯 Production Ready
Type-safe from database to UI, comprehensive testing patterns, and structured logging for easy debugging.
Project Overview
This Next.js App Boilerplate is a comprehensive, production-ready foundation for building modern web applications. It combines the latest technologies and best practices to provide developers with a robust starting point for their projects.
Built with accessibility in mind, this boilerplate follows WCAG 2.1 guidelines and implements semantic HTML structures. The codebase emphasizes clean architecture, strong typing, and maintainable code patterns following DRY and KISS principles.
The application features a complete authentication system powered by Supabase, including user registration, login, password recovery, and profile management. The UI is built with Material UI components and supports both light and dark themes.
YwyBase is created and maintained by Marcio Merlone.
Key Features
- Authentication System: Complete user management with Supabase integration
- Modern UI: Material UI components with customizable theming
- Type Safety: Full TypeScript implementation with Zod validation
- Data Management: React Query for efficient data fetching and caching
- Form Handling: React Hook Form with comprehensive validation
- Code Quality: ESLint and Prettier configuration for consistent code style
- Accessibility: WCAG 2.1 compliant with semantic HTML and ARIA attributes
- Cookie Consent: GDPR-compliant cookie management system
Technology Stack
Frontend
Next.js 15
React 19
TypeScript
Material UI
Tailwind CSS
Backend & Database
Supabase
PostgreSQL
Row Level Security
State & Forms
React Query
React Hook Form
Zod
Vanilla CookieConsent
Development
ESLint
Prettier
Vercel
Monitoring & Utilities
Sentry
Pino Logger
Moment Timezone
Architecture Principles
- DRY: Don't Repeat Yourself
- KISS: Keep It Simple, Stupid
- Strong Typing: TypeScript throughout
- Clean Code: Readable and maintainable
- Separation of Concerns: Modular architecture
Third-Party Services
We gratefully acknowledge the following services that power this application
Vercel
Hosting and deployment platform providing seamless CI/CD, edge computing, and excellent developer experience.
Sentry
Error monitoring and performance tracking helping us deliver a reliable and bug-free user experience.
Supabase
Backend-as-a-Service providing authentication, database, and real-time capabilities with PostgreSQL.
Resend
Email delivery platform powering transactional emails with excellent deliverability and developer-friendly API.
Upstash
Serverless Redis database providing rate limiting and caching for production-grade performance.
ipgeolocation.io
IP geolocation service providing accurate country detection for personalized user experiences.
These services enable us to deliver a modern, scalable, and feature-rich application to our users.