{"id":23914655,"url":"https://github.com/osmanorhan/breeze-stack","last_synced_at":"2026-04-14T04:01:55.555Z","repository":{"id":271071222,"uuid":"912310881","full_name":"osmanorhan/breeze-stack","owner":"osmanorhan","description":"A modern, full-stack web application boilerplate built with speed and developer experience in mind.","archived":false,"fork":false,"pushed_at":"2025-12-05T16:32:46.000Z","size":141,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-09T03:37:55.190Z","etag":null,"topics":["boilerplate","prisma","react","react-router-v7","remix","shadcn-ui","tailwind","turso","turso-db","zod"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/osmanorhan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-05T07:49:27.000Z","updated_at":"2025-12-05T16:32:52.000Z","dependencies_parsed_at":"2025-01-05T09:39:03.534Z","dependency_job_id":null,"html_url":"https://github.com/osmanorhan/breeze-stack","commit_stats":null,"previous_names":["osmanorhan/breeze-stack"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/osmanorhan/breeze-stack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osmanorhan%2Fbreeze-stack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osmanorhan%2Fbreeze-stack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osmanorhan%2Fbreeze-stack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osmanorhan%2Fbreeze-stack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/osmanorhan","download_url":"https://codeload.github.com/osmanorhan/breeze-stack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osmanorhan%2Fbreeze-stack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31781292,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["boilerplate","prisma","react","react-router-v7","remix","shadcn-ui","tailwind","turso","turso-db","zod"],"created_at":"2025-01-05T10:15:56.578Z","updated_at":"2026-04-14T04:01:55.526Z","avatar_url":"https://github.com/osmanorhan.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Breeze Stack 🌪️\n\nA modern, full-stack web application boilerplate built with speed and developer experience in mind.\n\n## Tech Stack 🛠️\n\n- **[React Router v7](https://reactrouter.com/en/main)** - Next generation routing with file-based routing, type safety, and server components\n- **[Prisma ORM](https://www.prisma.io/)** - Next-generation Node.js and TypeScript ORM\n- **[Better Auth](https://www.better-auth.com/)** - Simple and secure authentication\n- **[Turso](https://turso.tech/)** - Distributed SQLite database built on libSQL\n- **[shadcn/ui](https://ui.shadcn.com/)** - Re-usable components built with Radix UI and Tailwind CSS\n- **[Tailwind CSS](https://tailwindcss.com/)** - Utility-first CSS framework\n- **[Conform](https://conform.guide/)** - Form validation and state management\n- **[Zod](https://zod.dev/)** - TypeScript-first schema validation\n\n## Getting Started 🚀\n\n### Prerequisites\n\n1. Node.js 18+ and pnpm\n2. Turso CLI installed (`brew install tursodatabase/tap/turso`)\n3. Git\n\n### Setting up Turso Database\n\n1. Sign up for a free account at [Turso](https://turso.tech)\n2. Create a new database:\n   ```bash\n   turso db create [your-db-name]\n   ```\n3. Get your database URL and authentication token:\n   ```bash\n   turso db show [your-db-name]\n   turso db tokens create [your-db-name]\n   ```\n\n### Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/osmanorhan/breeze-stack.git\n   cd breeze-stack\n   ```\n\n2. Install dependencies:\n   ```bash\n   pnpm install\n   ```\n\n3. Create a .env file:\n   ```\n   DATABASE_URL=\"libsql://[your-db-url]\"\n   DATABASE_AUTH_TOKEN=\"[your-token]\"\n   SESSION_SECRET=\"[your-session-secret]\"\n   ```\n4. Generate Prisma client:\n   ```bash\n   pnpm run db:generate\n   ```\n\n5. Generate auth tables:\n   ```bash\n   pnpm dlx @better-auth/cli generate --config ./app/lib/auth.server.ts\n   ```\n\n6. Apply migrations:\n   ```bash\n   pnpm dlx prisma migrate dev --name init\n   ```\n\n7. Apply initial migrations to Turso:\n   ```bash\n   turso db shell [your-db-name] \u003c ./prisma/migrations/20250104172246_init/migration.sql\n   ```\n\n### Development\n\nStart the development server:\n```bash\npnpm run dev\n```\n\n## Project Structure 📁\n\n```\n├── app/\n│   ├── components/        # Reusable components\n│   ├── lib/              # Utilities and configurations\n│   ├── routes/           # File-based routing\n│   └── styles/           # Global styles\n├── prisma/\n│   ├── migrations/       # Database migrations\n│   └── schema.prisma     # Database schema\n```\n\n## Database Migrations 🔄\n\nWhen making changes to the schema:\n\n1. Update `prisma/schema.prisma`\n2. Generate migration:\n   ```bash\n   npx prisma migrate dev --name [descriptive-name]\n   ```\n3. Apply to Turso:\n   ```bash\n   turso db shell [your-db-name] \u003c ./prisma/migrations/[timestamp]_[name]/migration.sql\n   ```\n\n## Authentication 🔐\n\nAuthentication is handled by Better Auth. The setup includes:\n- Email/Password authentication\n- OAuth providers (Google)\n- Session management\n- Protected routes\n\n## Features ✨\n\n- 🎯 Type-safe routing and data loading\n- 🔒 Built-in authentication with multiple providers\n- 📱 Responsive layout with modern UI components\n- 🎨 Dark mode support\n- 🔍 Form validation with schema-based approach\n- 🚀 Fast development workflow\n- 📦 Pre-built components and layouts\n\n## License 📝\n\nMIT\n## Roadmap\n## Roadmap 🗺️\n\n### Upcoming Features 🚀\n\n#### Authentication \u0026 Authorization\n- [ ] Role-based access control (RBAC)\n- [ ] Team/Organization support\n- [ ] Two-factor authentication (2FA)\n- [ ] Password reset flow\n- [ ] Email verification\n\n#### UI/UX Improvements\n- [ ] Advanced table features (sorting, filtering, pagination)\n- [ ] File upload support with object storage\n- [ ] Rich text editor integration (Lexical?)\n- [ ] Dashboard analytics and charts\n- [ ] Notification system\n- [ ] Search functionality (add Meili?)\n- [ ] SVG \n\n#### Developer Experience\n- [ ] API documentation with Swagger/OpenAPI\n- [ ] Unit and integration testing setup\n- [ ] GitHub Actions CI/CD pipeline\n- [ ] Performance monitoring\n- [ ] Error tracking integration\n\n#### Infrastructure\n- [ ] WebSocket support for real-time features\n- [ ] Background job processing\n- [ ] Caching layer\n\n### Recently Completed ✅\n\n- [x] Basic authentication flow\n- [x] Project CRUD operations\n- [x] Form validation with Conform\n- [x] Responsive dashboard layout\n- [x] Dark mode support\n- [x] Database migrations\n\n## Contributing 🤝\n\nContributions are welcome! Please feel free to submit a Pull Request. Check our roadmap for planned features or suggest new ones.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosmanorhan%2Fbreeze-stack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fosmanorhan%2Fbreeze-stack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosmanorhan%2Fbreeze-stack/lists"}