create-tigra 1.1.0 → 2.0.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024 seed977
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,87 +1,80 @@
-# create-tigra
-
-Generate a **production-ready, robust API server** in seconds. 
-
-`create-tigra` scaffolds a modern, high-performance backend with built-in best practices, simplifying the setup of complex stacks so you can focus on building features.
-
-## Key Features
-
-*   **Production-Ready Server**: A robust **Fastify + TypeScript** foundation designed for scale and performance.
-*   **Built-in Database & Caching**: Pre-configured **Database** (MySQL via Prisma) and **Redis** for caching and queues.
-*   **Docker Integration**: Full `docker-compose` setup included. Spin up your infrastructure (Database, Redis) instantly.
-*   **Management UIs Included**: Comes with containerized UIs for your database and Redis, making local development and debugging effortless.
-*   **Secured Authentication**: Implementation of robust authentication strategies out-of-the-box.
-*   **RBAC & Admin Routes**: Pre-built Role-Based Access Control system with dedicated, secured admin routes to manage your application.
-
-## Prerequisites
-
-Before using `create-tigra`, ensure you have the following installed:
-
-*   **Node.js**: Version 18.0.0 or higher.
-*   **Docker Desktop**: Required to run the initialized project (provides MySQL, Redis, and admin UIs).
-*   **npm** (or pnpm/yarn): To install dependencies.
-
-## Usage
-
-To create a new project, simply run:
-
-```bash
-npx create-tigra <project-name>
-```
-
-Follow the interactive prompts to configure your new server.
-
-## What's Inside?
-
-When you generate a project with `create-tigra`, you get a fully structured codebase:
-
-*   **Framework**: Fastify (v4+)
-*   **Language**: TypeScript (Strict mode)
-*   **ORM**: Prisma
-*   **Validation**: Zod (Type-safe schemas)
-*   **Testing**: Vitest
-*   **Documentation**: Swagger / OpenAPI (automatically generated)
-*   **Infrastructure**: Docker Compose for MySQL, Redis, and administration UIs.
-
-## Getting Started
-
-1.  **Generate the project**:
-    ```bash
-    npx create-tigra my-app
-    ```
-
-2.  **Install Dependencies**:
-    ```bash
-    cd my-app/server
-    npm install
-    ```
-
-3.  **Start Infrastructure**:
-    Make sure Docker is running, then start the services:
-    ```bash
-    docker-compose up -d
-    ```
-
-4.  **Initialize Database**:
-    This command waits for the database to be ready and runs migrations:
-    ```bash
-    npm run db:init
-    ```
-
-5.  **Seed Database (Optional)**:
-    Populate the database with an admin user and sample data:
-    ```bash
-    npm run prisma:seed
-    ```
-
-6.  **Build and Start**:
-    ```bash
-    npm run build
-    npm run dev
-    ```
-
-    Your server will be running at `http://localhost:3000`.
-
-## License
-
-MIT
+# create-tigra
+
+Scaffold a production-ready full-stack application with **Next.js 16** + **Fastify 5** + **Prisma** + **Redis**.
+
+## Quick Start
+
+```bash
+npx create-tigra my-app
+```
+
+## What's Included
+
+### Client (Next.js 16)
+
+| Feature | Technology |
+|---|---|
+| Framework | Next.js 16 (App Router, React 19) |
+| Styling | Tailwind CSS v4, shadcn/ui, OKLCH color system |
+| State | Redux Toolkit (auth), React Query v5 (server data) |
+| Forms | React Hook Form + Zod validation |
+| HTTP | Axios with httpOnly cookie auth + auto refresh |
+| Auth UI | Login, Register, Dashboard pages |
+| Components | Header, Footer, Loading, Error, Empty states |
+| Theme | Light/Dark mode with next-themes |
+
+### Server (Fastify 5)
+
+| Feature | Technology |
+|---|---|
+| Framework | Fastify 5 with TypeScript (strict) |
+| Database | MySQL 8.0 + Prisma 6 ORM |
+| Cache | Redis 7 (ioredis) |
+| Auth | JWT (httpOnly cookies), session management |
+| Validation | Zod schemas on all inputs |
+| Security | Helmet, CORS, rate limiting, password hashing (Argon2) |
+| File uploads | Multipart + Sharp image optimization |
+| Logging | Pino with pretty dev output |
+| Testing | Vitest with 80% coverage thresholds |
+| Dev tools | Docker Compose (MySQL, phpMyAdmin, Redis, Redis Commander) |
+
+### AI-Powered Development
+
+Includes `.claude/` rules for Claude Code with project-specific conventions, architecture patterns, and coding standards for both client and server.
+
+## Prerequisites
+
+- **Node.js** 18+
+- **Docker** (for MySQL and Redis)
+
+## After Scaffolding
+
+```bash
+# 1. Start infrastructure
+cd my-app/server
+docker compose up -d
+
+# 2. Install server dependencies & set up database
+npm install
+cp .env.example .env
+npm run prisma:generate
+npm run prisma:migrate:dev -- --name init
+
+# 3. Start the server
+npm run dev
+
+# 4. In a new terminal, set up the client
+cd my-app/client
+npm install
+cp .env.example .env
+npm run dev
+```
+
+- Server: http://localhost:8000
+- Client: http://localhost:3000
+- phpMyAdmin: http://localhost:8080
+- Redis Commander: http://localhost:8081
+
+## License
+
+MIT