{"id":49283514,"url":"https://github.com/scottyvenable/spookiki-creations","last_synced_at":"2026-04-25T20:03:18.472Z","repository":{"id":325343405,"uuid":"1100813543","full_name":"ScottyVenable/spookiki-creations","owner":"ScottyVenable","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-26T23:38:47.000Z","size":399,"stargazers_count":1,"open_issues_count":8,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-29T03:57:55.326Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ScottyVenable.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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-11-20T19:45:59.000Z","updated_at":"2025-11-26T23:38:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ScottyVenable/spookiki-creations","commit_stats":null,"previous_names":["scottyvenable/spookiki-creations"],"tags_count":0,"template":false,"template_full_name":"github/spark-template","purl":"pkg:github/ScottyVenable/spookiki-creations","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScottyVenable%2Fspookiki-creations","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScottyVenable%2Fspookiki-creations/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScottyVenable%2Fspookiki-creations/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScottyVenable%2Fspookiki-creations/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ScottyVenable","download_url":"https://codeload.github.com/ScottyVenable/spookiki-creations/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScottyVenable%2Fspookiki-creations/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32274987,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T18:29:39.964Z","status":"ssl_error","status_checked_at":"2026-04-25T18:29:32.149Z","response_time":59,"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":[],"created_at":"2026-04-25T20:03:07.640Z","updated_at":"2026-04-25T20:03:18.466Z","avatar_url":"https://github.com/ScottyVenable.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎃 Spookiki Creations\n\nA handmade marketplace for spooky-cute art, ornaments, and gemstone clay snakes with a cozy, mystical aesthetic.\n\n[![Deploy to GitHub Pages](https://img.shields.io/badge/Deploy-GitHub%20Pages-blue)](https://github.com/ScottyVenable/spookiki-creations/actions)\n\n## ✨ Overview\n\nSpookiki Creations is a full-featured e-commerce platform built with React, TypeScript, and Vite. It provides a complete shopping experience with:\n\n- **Product Catalog** - Browse handmade art, ornaments, and gemstone clay snakes\n- **Shopping Cart** - Persistent cart with quantity management\n- **Checkout Flow** - Multi-step checkout with manual payment options\n- **Admin Panel** - Full product, order, and website management\n- **Blog** - Markdown-based blog with tags and categories\n- **User Accounts** - Authentication with role-based access control\n\n## 🎨 Design Philosophy\n\nThe design evokes a warm, mystical curiosity—like browsing a cozy witch's marketplace where every piece has a story and intention. The interface balances playful whimsy with clean professionalism.\n\n**Experience Qualities:**\n1. **Whimsical** - Every interaction feels delightful and slightly magical\n2. **Intimate** - Creates a personal connection with handmade creations\n3. **Trustworthy** - Clear information and transparent processes\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Node.js v20+ \n- npm (comes with Node.js)\n\n### Installation\n\n```bash\n# Install dependencies\nnpm install\n\n# Start development server\nnpm run dev\n```\n\nThe app will be available at `http://localhost:5173/`\n\n### Available Scripts\n\n| Script | Description |\n|--------|-------------|\n| `npm run dev` | Start development server |\n| `npm run build` | Build for production |\n| `npm run preview` | Preview production build |\n| `npm run lint` | Run ESLint |\n\n## 👤 Admin Access\n\nThe admin panel is accessible at `/admin` for authorized users.\n\n### Default Admin Accounts\n\n| User | Username | Password | Role |\n|------|----------|----------|------|\n| Kiki (Owner) | `spookiki` | `welcome123` | Admin |\n| Scotty | `Scotty2Hotty999` | `SVen!8019` | Admin |\n\n### Admin Features\n\n- **Products** - Full CRUD operations with multiple images, categories, and featured products\n- **Orders** - View and update order status (Pending → Paid → Shipped)\n- **Website** - Customize site name, hero content, policies, and contact info\n\nSee [ADMIN_GUIDE.md](./ADMIN_GUIDE.md) for detailed documentation.\n\n## 📁 Project Structure\n\n```\nspookiki-creations/\n├── src/\n│   ├── components/     # React components\n│   │   ├── ui/         # shadcn/ui component library\n│   │   └── admin/      # Admin panel components\n│   ├── pages/          # Page components\n│   ├── contexts/       # React Context providers\n│   ├── hooks/          # Custom React hooks\n│   ├── lib/            # Utilities and data\n│   └── styles/         # CSS styles and theming\n├── public/             # Static assets\n├── docs/               # Additional documentation\n└── ...config files\n```\n\nSee the README.md in each folder for detailed documentation.\n\n## 🛠️ Tech Stack\n\n### Frontend\n- **React 19** - UI library\n- **TypeScript** - Type safety\n- **Vite** - Build tool and dev server\n- **Tailwind CSS v4** - Utility-first styling\n- **shadcn/ui** - Component library (Radix UI primitives)\n\n### State Management\n- **React Context** - Global state (Auth, Mobile Optimization)\n- **React Query** - Server state management\n- **Firebase Realtime Database** - Cloud data sync (free tier)\n- **Local Storage** - Offline fallback\n\n### Additional Libraries\n- **Framer Motion** - Animations\n- **Lucide React** - Icons\n- **Phosphor Icons** - Additional icons\n- **Zod** - Schema validation\n- **React Hook Form** - Form handling\n- **date-fns** - Date utilities\n\n## 🌐 Deployment\n\n### GitHub Pages\n\nThe project is configured for automatic deployment to GitHub Pages:\n\n1. Go to repository **Settings** → **Pages**\n2. Set **Source** to \"GitHub Actions\"\n3. Push to `main` branch to trigger deployment\n\nYour site will be available at: `https://\u003cusername\u003e.github.io/spookiki-creations/`\n\nSee [GITHUB_PAGES_SETUP.md](./GITHUB_PAGES_SETUP.md) for detailed instructions.\n\n### ☁️ Cloud Storage (Optional)\n\nFor cross-device data sync (products, orders, cart), set up free Firebase:\n\n1. Create a free Firebase project at [console.firebase.google.com](https://console.firebase.google.com)\n2. Enable Realtime Database\n3. Copy your config to `.env` (see `.env.example`)\n4. Run `npm install` to get Firebase package\n\nSee [CLOUD_STORAGE_SETUP.md](./CLOUD_STORAGE_SETUP.md) for detailed instructions.\n\n**Without Firebase:** The app works perfectly with localStorage (no cross-device sync).\n\n## 📚 Documentation\n\n| Document | Description |\n|----------|-------------|\n| [PRD.md](./PRD.md) | Product Requirements Document |\n| [CLOUD_STORAGE_SETUP.md](./CLOUD_STORAGE_SETUP.md) | Free cloud storage setup guide |\n| [ADMIN_GUIDE.md](./ADMIN_GUIDE.md) | Complete admin user manual |\n| [ADMIN_FEATURES.md](./ADMIN_FEATURES.md) | Admin feature summary |\n| [ADMIN_TESTING.md](./ADMIN_TESTING.md) | Admin testing checklist |\n| [QUICK_REFERENCE.md](./QUICK_REFERENCE.md) | Admin quick reference |\n| [GITHUB_PAGES_SETUP.md](./GITHUB_PAGES_SETUP.md) | Deployment instructions |\n| [IMAGE_UPLOAD_FEATURE.md](./IMAGE_UPLOAD_FEATURE.md) | Image upload documentation |\n| [TODO.md](./TODO.md) | Testing TODO and known issues |\n\n## 🎯 Key Features\n\n### For Customers\n- Browse products by category (Art, Ornaments, Snakes)\n- View detailed product pages with gemstone meanings\n- Add items to persistent shopping cart\n- Complete checkout with multiple payment options\n- Create account and view order history\n\n### For Admins\n- Create, edit, and delete products\n- Manage multiple product images\n- Set product status (Active, Draft, Archived)\n- Process and track orders\n- Customize website content and policies\n\n## 🎨 Color Palette\n\n| Color | Hex | Usage |\n|-------|-----|-------|\n| Mystical Purple | `#7A687F` | Primary CTAs, headings |\n| Soft Mint | `#96DDCE` | Success states, accents |\n| Digital Lavender | `#CBC3E3` | Footer, hover states |\n| Blush Pink | `#E8A5A5` | Badges, highlights |\n| Background | `#F6F4F0` | Main background |\n\n## 📱 Responsive Design\n\n- **Desktop** - Full navigation and 3-column product grid\n- **Tablet** - 2-column product grid, simplified layout\n- **Mobile** - Single column, hamburger menu, touch-optimized\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Commit changes: `git commit -m 'Add amazing feature'`\n4. Push to branch: `git push origin feature/amazing-feature`\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Built with [Spark](https://github.com/github/spark)\n- UI components from [shadcn/ui](https://ui.shadcn.com/)\n- Icons from [Lucide](https://lucide.dev/) and [Phosphor](https://phosphoricons.com/)\n\n---\n\nMade with 🖤 by Spookiki Creations\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscottyvenable%2Fspookiki-creations","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscottyvenable%2Fspookiki-creations","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscottyvenable%2Fspookiki-creations/lists"}