{"id":49040452,"url":"https://github.com/iamaanahmad/grimoire-skeleton","last_synced_at":"2026-04-19T14:39:29.952Z","repository":{"id":326270170,"uuid":"1103111769","full_name":"iamaanahmad/grimoire-skeleton","owner":"iamaanahmad","description":"Grimoire Skeleton is a Kiro-native framework that demonstrates how to build reusable, production-ready systems. Define your entities once, and watch as complete CRUD interfaces materialize before your eyes.","archived":false,"fork":false,"pushed_at":"2025-12-04T18:44:58.000Z","size":1270,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-07T15:03:41.999Z","etag":null,"topics":["hackathon","helloween","kiro","kiro-ide","kiroween","open-source"],"latest_commit_sha":null,"homepage":"https://grimoire-skeleton.appwrite.network/","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/iamaanahmad.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":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-11-24T12:51:18.000Z","updated_at":"2025-12-04T18:45:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/iamaanahmad/grimoire-skeleton","commit_stats":null,"previous_names":["iamaanahmad/grimoire-skeleton"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iamaanahmad/grimoire-skeleton","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamaanahmad%2Fgrimoire-skeleton","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamaanahmad%2Fgrimoire-skeleton/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamaanahmad%2Fgrimoire-skeleton/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamaanahmad%2Fgrimoire-skeleton/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iamaanahmad","download_url":"https://codeload.github.com/iamaanahmad/grimoire-skeleton/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iamaanahmad%2Fgrimoire-skeleton/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32010306,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["hackathon","helloween","kiro","kiro-ide","kiroween","open-source"],"created_at":"2026-04-19T14:39:28.787Z","updated_at":"2026-04-19T14:39:29.934Z","avatar_url":"https://github.com/iamaanahmad.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎃 Grimoire Skeleton\n\n\u003e A spooky, elegant skeleton framework for spawning diverse applications from a single foundation\n\n**Built for the Kiroween Hackathon** - Showcasing Kiro's full capabilities through specs, hooks, and vibe coding.\n\n## 🌐 Live Demo\n\n**[https://grimoire-skeleton.appwrite.network/](https://grimoire-skeleton.appwrite.network/)**\n\nExperience the full platform live with real Appwrite backend integration!\n\n## 🌟 What is Grimoire Skeleton?\n\nGrimoire Skeleton is a Kiro-native framework that demonstrates how to build reusable, production-ready systems. Define your entities once, and watch as complete CRUD interfaces materialize before your eyes.\n\n### Key Features\n\n- **🔮 Entity System** - Declarative entity definitions that auto-generate types, forms, lists, and API routes\n- **🎨 Theme Engine** - Three spooky skins (Nightmare Neon, Bone Minimal, Blood Moon) with seamless switching\n- **⚡ Dual Applications** - Two complete apps from one skeleton:\n  - **Cursed Arena** - Esports tournament platform\n  - **Haunted Clinic** - Doctor appointment system\n- **🤖 Kiro-First Development** - Built using specs, hooks, and steering documents\n- **🎯 Type-Safe** - Full TypeScript with strict mode\n- **♿ Accessible** - WCAG AA compliant with proper ARIA attributes\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Node.js 20.x or higher\n- npm 10.x or higher\n- Appwrite account ([sign up here](https://cloud.appwrite.io/))\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone \u003crepository-url\u003e\ncd grimoire-skeleton\n\n# Install dependencies\nnpm install\n\n# Set up environment variables\ncp .env.local.example .env.local\n# Edit .env.local with your Appwrite credentials\n\n# Initialize Appwrite backend\nnpm run setup:appwrite\n\n# Start the development server\nnpm run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) to see your application.\n\n## 🛠️ Technology Stack\n\n- **Frontend**: Next.js 16 (App Router) + React 19 + TypeScript\n- **Backend**: Appwrite (auth, database, storage)\n- **Styling**: Tailwind CSS 4 + CSS variables for theming\n- **Testing**: Vitest + Testing Library\n- **Code Quality**: ESLint + Prettier + TypeScript strict mode\n\n## 📚 Documentation\n\n- **[DEVELOPMENT.md](./DEVELOPMENT.md)** - Complete development guide with setup instructions, workflows, and troubleshooting\n- **[ARCHITECTURE_OVERVIEW.md](./ARCHITECTURE_OVERVIEW.md)** - System architecture and design decisions\n- **[KIRO_USAGE_WRITEUP.md](./KIRO_USAGE_WRITEUP.md)** - How we used Kiro to build this project\n\n## 🎭 The Two Applications\n\n### Cursed Arena 🏆\n\nAn esports tournament management platform featuring:\n\n- Tournament creation and management\n- Team registration and tracking\n- Live tournament status updates\n- Prize pool tracking\n\n### Haunted Clinic 🏥\n\nA doctor appointment booking system featuring:\n\n- Doctor profiles and specialties\n- Appointment scheduling\n- Patient management\n- Appointment status tracking\n\nBoth applications share the same core components, layouts, and theme system - demonstrating the power of the skeleton approach.\n\n## 🎨 Theme System\n\nSwitch between three spooky themes:\n\n1. **Nightmare Neon** 💚 - Cyberpunk vibes with neon green and purple\n2. **Bone Minimal** 🦴 - Clean monochrome with bone-white and black\n3. **Blood Moon** 🌙 - Elegant darkness with deep red accents\n\nAll themes maintain excellent contrast ratios and smooth animations.\n\n## 🤖 Kiro Integration\n\nThis project showcases Kiro's capabilities:\n\n- **Specs** - Used for core systems (entity system, theme engine, auth)\n- **Vibe Coding** - Used for UI components and rapid prototyping\n- **Hooks** - Automated entity generation, theme validation, and pre-commit checks\n- **Steering** - Project architecture and development guidelines\n- **MCP** - Appwrite integration for backend management\n\n## 📝 Available Scripts\n\n```bash\nnpm run dev          # Start development server\nnpm run build        # Build for production\nnpm run start        # Start production server\nnpm run lint         # Run ESLint\nnpm run type-check   # Run TypeScript compiler\nnpm run format       # Format code with Prettier\nnpm run test         # Run tests\nnpm run test:watch   # Run tests in watch mode\nnpm run test:coverage # Generate coverage report\n```\n\n## 🏗️ Project Structure\n\n```\n/src\n  /core           # Shared components, layouts, utilities\n  /modules        # Domain-specific features\n  /theme          # Theme system and skins\n  /config         # Entity definitions\n/apps             # The two example applications\n  /cursed-arena   # Esports tournament platform\n  /haunted-clinic # Doctor appointment system\n/.kiro\n  /specs          # Kiro specs for features\n  /hooks          # Automated workflows\n  /steering       # Development guidelines\n```\n\n## 🤝 Contributing\n\nThis is a hackathon project, but contributions are welcome! Please read the development guide first.\n\n## 📄 License\n\nMIT License - see [LICENSE](./LICENSE) file for details\n\n## 🎃 Built with Kiro\n\nThis project was built for the Kiroween Hackathon to demonstrate how Kiro can accelerate development while maintaining code quality. Every feature was developed using a combination of specs for core systems and vibe coding for UI work.\n\n---\n\n**Happy Haunting!** 👻💀🎃\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamaanahmad%2Fgrimoire-skeleton","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiamaanahmad%2Fgrimoire-skeleton","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiamaanahmad%2Fgrimoire-skeleton/lists"}