{"id":32398552,"url":"https://github.com/rootz491/kaluwala-web","last_synced_at":"2026-05-17T00:12:13.306Z","repository":{"id":319194751,"uuid":"983668428","full_name":"rootz491/kaluwala-web","owner":"rootz491","description":"website about my village","archived":false,"fork":false,"pushed_at":"2026-01-29T13:32:04.000Z","size":1018,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-31T12:23:37.490Z","etag":null,"topics":["nextjs","sanity-cms"],"latest_commit_sha":null,"homepage":"https://kaluwala.in","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/rootz491.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-05-14T18:20:21.000Z","updated_at":"2025-12-06T22:47:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"509cfaba-08ba-4a67-9b7c-4b8c77f93c95","html_url":"https://github.com/rootz491/kaluwala-web","commit_stats":null,"previous_names":["rootz491/kaluwala-web"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rootz491/kaluwala-web","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootz491%2Fkaluwala-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootz491%2Fkaluwala-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootz491%2Fkaluwala-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootz491%2Fkaluwala-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rootz491","download_url":"https://codeload.github.com/rootz491/kaluwala-web/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rootz491%2Fkaluwala-web/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33123119,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T18:38:32.183Z","status":"ssl_error","status_checked_at":"2026-05-16T18:38:29.903Z","response_time":115,"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":["nextjs","sanity-cms"],"created_at":"2025-10-25T08:01:00.644Z","updated_at":"2026-05-17T00:12:13.301Z","avatar_url":"https://github.com/rootz491.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kaluwala Web\n\nA modern web application built with Next.js 15, Sanity CMS, Tailwind CSS v4, and shadcn/ui.\n\n## 🚀 Tech Stack\n\n- **Next.js 15** - React framework with App Router\n- **TypeScript** - Type-safe JavaScript\n- **Tailwind CSS v4** - Utility-first CSS framework\n- **shadcn/ui** - Beautiful, accessible UI components\n- **Sanity CMS** - Headless content management system\n\n## 📦 Installation\n\n1. **Clone the repository** (if you haven't already):\n   ```bash\n   git clone \u003cyour-repo-url\u003e\n   cd kaluwala-web\n   ```\n\n2. **Install dependencies**:\n   ```bash\n   npm install\n   ```\n\n3. **Set up environment variables**:\n   Copy `.env.local` and fill in your Sanity project details:\n   ```bash\n   NEXT_PUBLIC_SANITY_PROJECT_ID=your_project_id_here\n   NEXT_PUBLIC_SANITY_DATASET=production\n   NEXT_PUBLIC_SANITY_API_VERSION=2024-01-01\n   SANITY_API_TOKEN=your_api_token_here\n   ```\n\n4. **Run the development server**:\n   ```bash\n   npm run dev\n   ```\n\n5. **Open your browser** and navigate to `http://localhost:3000`\n\n## 🎨 UI Components\n\nThis project uses shadcn/ui for components. To add new components:\n\n```bash\nnpx shadcn@latest add \u003ccomponent-name\u003e\n```\n\nAvailable components: https://ui.shadcn.com/docs/components\n\n## 📝 Sanity CMS Setup\n\n1. **Create a Sanity project**:\n   - Go to https://sanity.io\n   - Create a new project\n   - Note down your project ID\n\n2. **Update environment variables**:\n   - Add your project ID to `.env.local`\n   - Set your dataset name (usually \"production\")\n\n3. **Create schemas** (when ready):\n   - Set up Sanity Studio\n   - Define your content schemas\n   - Update the types in `src/types/sanity.ts`\n\n## 🔧 Configuration Files\n\n- `components.json` - shadcn/ui configuration\n- `tailwind.config.ts` - Tailwind CSS configuration (if needed)\n- `src/lib/sanity.ts` - Sanity client configuration\n- `src/types/sanity.ts` - TypeScript types for Sanity documents\n\n## 📁 Project Structure\n\n```\nsrc/\n├── app/                 # Next.js App Router pages (routing only)\n│   └── page.tsx        # Homepage route (imports from ui-pages)\n├── ui-pages/           # Client components for pages\n│   ├── index.ts        # Barrel exports for all pages\n│   └── HomePage.tsx    # Homepage UI component\n├── components/          # React components\n│   └── ui/             # shadcn/ui components\n├── lib/                # Utility functions and configurations\n│   ├── sanity.ts       # Sanity client setup\n│   └── utils.ts        # General utilities\n└── types/              # TypeScript type definitions\n    └── sanity.ts       # Sanity-specific types\n```\n\n### Architecture Pattern\n\nThis project follows a clean separation between routing and UI:\n\n- **`src/app/`** - Contains only Next.js App Router files for routing. These files should be minimal and only import/render components from `ui-pages/`.\n- **`src/ui-pages/`** - Contains all page-level UI components that require client-side functionality (React hooks, state, etc.). These are marked with `'use client'`.\n- **`src/components/`** - Reusable UI components, including shadcn/ui components.\n\nThis pattern keeps the app directory clean and makes it easy to identify which components are client-side.\n\n## 🚀 Deployment\n\nThis project can be deployed on Vercel, Netlify, or any platform that supports Next.js.\n\nFor Vercel:\n```bash\nnpm run build\n```\n\nMake sure to add your environment variables to your deployment platform.\n\n## 📚 Next Steps\n\n1. Set up your Sanity project and configure environment variables\n2. Create content schemas in Sanity Studio\n3. Add more shadcn/ui components as needed\n4. Build your application pages and components\n5. Set up proper error handling and loading states\n6. Add authentication if needed\n7. Optimize for production\n\n## 🛠 Available Scripts\n\n- `npm run dev` - Start development server\n- `npm run build` - Build for production\n- `npm run start` - Start production server\n- `npm run lint` - Run ESLint\n\n## 📖 Documentation\n\n- [Next.js Documentation](https://nextjs.org/docs)\n- [Tailwind CSS Documentation](https://tailwindcss.com/docs)\n- [shadcn/ui Documentation](https://ui.shadcn.com)\n- [Sanity Documentation](https://www.sanity.io/docs)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frootz491%2Fkaluwala-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frootz491%2Fkaluwala-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frootz491%2Fkaluwala-web/lists"}