{"id":22147777,"url":"https://github.com/rudrodip/nextemplate","last_synced_at":"2025-07-26T02:31:56.588Z","repository":{"id":216820256,"uuid":"742438283","full_name":"rudrodip/nextemplate","owner":"rudrodip","description":"Collection of custom templates and components made with Next.JS, shadcn/ui and TailwindCSS","archived":false,"fork":false,"pushed_at":"2024-04-10T16:39:17.000Z","size":3241,"stargazers_count":26,"open_issues_count":0,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-01T13:49:53.043Z","etag":null,"topics":["contentlayer-nextjs","nextjs14","shadcn-ui","tailwindcss"],"latest_commit_sha":null,"homepage":"https://nextemplate.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rudrodip.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2024-01-12T13:32:23.000Z","updated_at":"2024-11-08T10:40:27.000Z","dependencies_parsed_at":"2024-01-16T22:23:29.365Z","dependency_job_id":null,"html_url":"https://github.com/rudrodip/nextemplate","commit_stats":null,"previous_names":["rudrodip/nextemplate"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudrodip%2Fnextemplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudrodip%2Fnextemplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudrodip%2Fnextemplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudrodip%2Fnextemplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rudrodip","download_url":"https://codeload.github.com/rudrodip/nextemplate/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227642848,"owners_count":17797953,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["contentlayer-nextjs","nextjs14","shadcn-ui","tailwindcss"],"created_at":"2024-12-01T23:21:10.146Z","updated_at":"2024-12-01T23:21:10.694Z","avatar_url":"https://github.com/rudrodip.png","language":"TypeScript","funding_links":[],"categories":["Components \u0026 Libraries"],"sub_categories":[],"readme":"# NexTemplate\n\nHey there, welcome to NexTemplate – my personal indie project! This collection brings together custom templates and components crafted with Next.JS, shadcn/ui, and TailwindCSS. It's a space where I share pieces of code that might make your web development journey a bit smoother.\n\n![NexTemplate](https://nextemplate.vercel.app/nextemplate.gif)\n\n## Features\n\n1. **Diverse Collection**: NexTemplate offers a bunch of reusable templates and components that I've put together. They're not perfect, but they've been useful for me, and I hope you find them helpful too.\n\n2. **Search Functionality**: Need something specific? Use the search feature to quickly find the components you're looking for.\n\n3. **Live Demos**: See the components in action with live demos. The demos include code snippets in TypeScript, CSS, and Tailwind for your convenience.\n\n4. **Code Organization**: I've tried to organize the components into different files, following some good practices for clarity. It's not perfect, but it gets the job done.\n\n5. **Easy Copy-Paste Integration**: Feel free to copy and paste the code snippets directly into your project. It's a quick and straightforward way to integrate these components.\n\n6. **Fully Open Sourced**: NexTemplate is fully open source. Dive into the code, make changes, and use it as you see fit. Just remember, it's not perfect, and I'm always open to improvements.\n\n## Getting Started\n\nTo get started with NexTemplate, visit the [NexTemplate](https://nextemplate.vercel.app). The project isn't flawless, but it's a work in progress.\n\n## Contributing\n\nContributions to NexTemplate are welcome and encouraged! If you have suggestions, feature requests, or you found a bug, feel free to open an issue. If you'd like to contribute code, follow these steps:\n\n1. **Fork the repository**: Click the \"Fork\" button in the upper right corner of this repository to create your copy.\n\n2. **Clone your fork**: Clone your forked repository to your local machine using the following command:\n\n   ```bash\n   git clone https://github.com/rudrodip/nextemplate\n   ```\n\n3. **Create a branch**: Create a new branch for your contribution:\n\n   ```bash\n   git checkout -b feature-or-fix-name\n   ```\n\n4. **Make changes**: Make your changes or additions to the codebase. Ensure your code follows the project's coding guidelines.\n\n5. **Test your changes**: Run the development server locally to test your changes:\n\n```bash\nnpm run dev\n# or\nyarn dev\n# or\npnpm run dev\n# or\nbun run dev\n```\n\n6. **Commit your changes**: Commit your changes with a meaningful commit message:\n\n```bash\ngit add .\ngit commit -m \"Add feature or fix\"\n```\n\n7. **Push changes**: Push your changes to your forked repository:\n\n```bash\ngit push origin feature-or-fix-name\n```\n\n8. **Create a Pull Request (PR)**: Open a Pull Request on GitHub against the dev branch. Provide a clear title and description of your changes.\n   **Make sure to target the dev branch, not the main branch.**\n\n9. **Review and Merge**: Maintainers will review your contribution. Once approved, your changes will be merged into the main branch.\n\n## Adding a New Component\n\nIf you'd like to contribute a new component to NexTemplate, please follow these guidelines:\n\n1. **Component Location**: Place the new component in the `src/components/templates/\u003ccomponent_folder\u003e` directory.\n\n2. **Mandatory Files**: Each component folder must include the following two files:\n\n   - `component-details.json`: Contains metadata about the component.\n   - `main.tsx`: Should export the component as the default export.\n\n3. **Component Details Metadata**:\n\n   - The `component-details.json` file must export an object of type `ComponentDetails`.\n   - Example of `ComponentDetails` type:\n     ```\n     export type ComponentDetails = {\n       title: string;\n       desc: string;\n       tags: string[];\n       published: boolean;\n       date: string; // Format: \"2024-01-12T17:20:00.000Z\"\n     };\n     ```\n   - Ensure that the `date` string follows the specified JavaScript format.\n\n4. **File Structure**: There can be multiple files within the component folder, but subdirectories are not allowed.\n\n## Deployment\n\nTo deploy NexTemplate, you can use your preferred hosting platform. Here's a general guide:\n\n1. **Build your app**:\n\n```bash\nnpm run build\n# or\nyarn build\n# or\npnpm run build\n# or\nbun run build\n```\n\n2. **Deploy to your platform of choice**:\n\n   - If using Vercel, connect your GitHub repository, and Vercel will handle the deployment seamlessly.\n   - For other platforms, upload the contents of the `out/` directory generated after the build to your server.\n\n3. **Visit your deployed site**: Open your browser and visit your deployed site to ensure everything is working as expected.\n\n## Support\n\nIf you encounter any issues, have questions, or just want to chat, knock me on [Discord](https://discordapp.com/users/841126921886498817) / [Twitter](https://twitter.com/rds_agi) or open an issue on GitHub. Your feedback is valuable, and we appreciate your contribution!\n\nThank you for being a part of the NexTemplate community!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frudrodip%2Fnextemplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frudrodip%2Fnextemplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frudrodip%2Fnextemplate/lists"}