create-fogo-app 1.0.0 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rokan0-0
+
+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,68 +1,57 @@
-# create-fogo-app
+<div align="center">
 
-Scaffold a production-ready Fogo dApp with Sessions SDK in seconds.
+# 🔥 create-fogo-app
 
-## 🚀 Quick Start
+**The fastest way to build on Fogo Chain**
 
-```bash
-npx create-fogo-app my-fogo-app
-cd my-fogo-app
-npm install
-npm run dev
-```
+[![npm version](https://img.shields.io/npm/v/create-fogo-app.svg)](https://www.npmjs.com/package/create-fogo-app)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm downloads](https://img.shields.io/npm/dm/create-fogo-app.svg)](https://www.npmjs.com/package/create-fogo-app)
 
-## 📦 What's Included
+Scaffold a production-ready Fogo dApp with Sessions SDK in seconds.
 
-- **Next.js 14** with App Router and TypeScript
-- **Fogo Sessions SDK** pre-configured for gasless transactions
-- **Solana Wallet Adapters** (Phantom, Solflare, etc.)
-- **TailwindCSS** + **shadcn/ui** for beautiful UI
-- **SPL Memo Demo** to showcase session key signing
+[Quick Start](#-quick-start) • [Features](#-features) • [Documentation](#-documentation) • [Examples](#-examples)
 
-## 🎯 Features
+</div>
 
-- ✅ Zero-friction setup - just run and start building
-- ✅ Gasless transactions via Fogo Sessions
-- ✅ Session key management out of the box
-- ✅ Modern, responsive UI components
-- ✅ TypeScript for type safety
-- ✅ Production-ready configuration
+---
 
-## 📖 Usage
+## 🚀 Quick Start
 
-### Create a New Project
+Get started with a single command:
 
 ```bash
-# Interactive mode
-npx create-fogo-app
-
-# With project name
-npx create-fogo-app my-awesome-dapp
+npx create-fogo-app my-fogo-app
 ```
 
-### Configure Your App
+Then:
+
+```bash
+cd my-fogo-app
+npm install
+npm run dev
+```
 
-After creating your project:
+Open [http://localhost:3000](http://localhost:3000) and start building! 🎉
 
-1. Update `.env` with your paymaster details:
+---
 
-   ```env
-   NEXT_PUBLIC_PAYMASTER_URL=your-paymaster-url
-   NEXT_PUBLIC_SPONSOR_PUBLIC_KEY=your-sponsor-key
-   ```
+## ✨ Features
 
-2. Install dependencies:
+- **⚡ Zero-Config Setup** - Start building immediately with sensible defaults
+- **🔑 Fogo Sessions SDK** - Gasless transactions pre-configured
+- **💳 Wallet Integration** - Phantom, Solflare, and all Solana wallets supported
+- **🎨 Modern UI** - Beautiful components with shadcn/ui + TailwindCSS
+- **📝 TypeScript** - Full type safety out of the box
+- **🎯 Demo Included** - Working SPL Memo transaction example
+- **🌐 Next.js 14** - App Router, Server Components, and more
+- **📱 Responsive** - Mobile-first design that works everywhere
 
-   ```bash
-   npm install
-   ```
+---
 
-3. Start developing:
-   ```bash
-   npm run dev
-   ```
+## 📦 What's Included
 
-## 🏗️ What Gets Scaffolded
+Your scaffolded project includes:
 
 ```
 my-fogo-app/
@@ -85,25 +74,177 @@ my-fogo-app/
 └── package.json
 ```
 
-## 🔧 Requirements
+---
+
+## 🎯 What You Get
+
+### 1. **Session Management**
+
+- One-click wallet connection
+- Session key creation with scoped permissions
+- Automatic session state management
+
+### 2. **Gasless Transactions**
+
+- No gas fees for users
+- Paymaster integration ready
+- Session keys sign transactions in background
+
+### 3. **Production-Ready Stack**
+
+- Next.js 14 with App Router
+- TypeScript for type safety
+- TailwindCSS for styling
+- shadcn/ui for beautiful components
+- Solana Web3.js integration
+
+### 4. **Working Demo**
+
+- SPL Memo transaction example
+- "Say GM" button demonstrates gasless UX
+- No wallet popup needed after session established
+
+---
+
+## 🛠️ Configuration
+
+After creating your project, update `.env` with your paymaster details:
+
+```env
+# Fogo RPC (Testnet by default)
+NEXT_PUBLIC_FOGO_RPC_URL=https://testnet.fogo.io
+
+# Paymaster Configuration
+NEXT_PUBLIC_PAYMASTER_URL=https://paymaster.testnet.fogo.io
+NEXT_PUBLIC_SPONSOR_PUBLIC_KEY=YourSponsorPublicKeyHere
+```
+
+> **Note**: You need to set up a paymaster sponsor account. Visit [Fogo Documentation](https://fogo.io/docs) for instructions.
+
+---
+
+## 📚 Documentation
+
+### How Fogo Sessions Work
+
+1. **User connects wallet** (one-time)
+2. **App requests session** with specific limits
+3. **User approves** session creation
+4. **Session key signs** transactions in background
+5. **Paymaster covers** gas fees
 
-- Node.js 18 or higher
-- npm, yarn, or pnpm
+### Key Concepts
 
-## 📚 Learn More
+- **Session Keys**: Temporary keys with scoped permissions
+- **Paymaster**: Covers transaction fees for users
+- **Gasless UX**: No wallet popups or gas fees after session established
 
-- [Fogo Documentation](https://fogo.io/docs)
+### Learn More
+
+- [Fogo Chain Documentation](https://fogo.io/docs)
 - [Fogo Sessions SDK](https://github.com/fogo-foundation/sessions-sdk)
-- [Example Apps](https://github.com/fogo-foundation/sessions-example-vite)
+- [Next.js Documentation](https://nextjs.org/docs)
+- [Solana Web3.js](https://solana-labs.github.io/solana-web3.js/)
+
+---
+
+## 🎨 Examples
+
+### Basic Usage
+
+```bash
+# Create a new project
+npx create-fogo-app my-dapp
+
+# With custom name
+npx create-fogo-app awesome-fogo-project
+```
+
+### User Flow in Your App
+
+```typescript
+// 1. Connect wallet
+<WalletMultiButton />;
+
+// 2. Establish session
+const { establishSession } = useFogoSession();
+await establishSession();
+
+// 3. Send gasless transaction
+const { sendTransaction } = useFogoSession();
+await sendTransaction(transaction); // No wallet popup!
+```
+
+---
+
+## 🔧 Requirements
+
+- **Node.js** 18 or higher
+- **npm**, **yarn**, or **pnpm**
+- A Solana wallet (Phantom, Solflare, etc.)
+
+---
+
+## 🚢 Deployment
+
+### Vercel (Recommended)
+
+```bash
+npx vercel
+```
+
+Make sure to add your environment variables in Vercel project settings.
+
+### Other Platforms
+
+The scaffolded app is a standard Next.js application and can be deployed to:
+
+- Netlify
+- Railway
+- AWS
+- Any platform supporting Next.js
+
+---
 
 ## 🤝 Contributing
 
-Contributions are welcome! Please open an issue or submit a PR.
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+---
 
 ## 📄 License
 
-MIT
+MIT License - see the [LICENSE](LICENSE) file for details.
 
 ---
 
-Built with 🔥 by the Fogo community
+## 🙏 Acknowledgments
+
+- [Fogo Chain](https://fogo.io) for the amazing Sessions SDK
+- [Next.js](https://nextjs.org) for the incredible framework
+- [shadcn/ui](https://ui.shadcn.com) for beautiful components
+- [Solana](https://solana.com) for the underlying technology
+
+---
+
+## � Support
+
+- **Issues**: [GitHub Issues](https://github.com/Rokan0-0/create-fogo-app/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/Rokan0-0/create-fogo-app/discussions)
+- **Fogo Discord**: [Join the community](https://discord.gg/fogo)
+
+---
+
+<div align="center">
+
+**Built with 🔥 by [Rokan0-0](https://github.com/Rokan0-0)**
+
+[npm](https://www.npmjs.com/package/create-fogo-app) • [GitHub](https://github.com/Rokan0-0/create-fogo-app)
+
+</div>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-fogo-app",
-  "version": "1.0.0",
-  "description": "CLI to scaffold a Fogo dApp with Sessions SDK pre-configured",
+  "version": "1.0.1",
+  "description": "The easiest way to get started on Fogo Chain. Scaffolds a Next.js dApp with Fogo Sessions pre-configured.",
   "type": "module",
   "bin": {
     "create-fogo-app": "bin/cli.js"
@@ -10,6 +10,14 @@
     "bin",
     "template"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rokan0-0/create-fogo-app.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Rokan0-0/create-fogo-app/issues"
+  },
+  "homepage": "https://github.com/Rokan0-0/create-fogo-app#readme",
   "keywords": [
     "fogo",
     "solana",
@@ -20,7 +28,7 @@
     "cli",
     "scaffold"
   ],
-  "author": "",
+  "author": "Rokan0-0",
   "license": "MIT",
   "dependencies": {
     "chalk": "^5.3.0",