{"id":48908718,"url":"https://github.com/aojdevstudio/nextjs-starter","last_synced_at":"2026-04-16T22:03:57.857Z","repository":{"id":282927864,"uuid":"950116540","full_name":"AojdevStudio/nextjs-starter","owner":"AojdevStudio","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-17T17:04:54.000Z","size":109,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-17T18:24:44.638Z","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/AojdevStudio.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}},"created_at":"2025-03-17T16:51:29.000Z","updated_at":"2025-03-17T17:04:58.000Z","dependencies_parsed_at":"2025-03-17T18:24:47.579Z","dependency_job_id":"da0dce0d-cf26-459d-a3d2-e835858d8513","html_url":"https://github.com/AojdevStudio/nextjs-starter","commit_stats":null,"previous_names":["aojdevstudio/nextjs-starter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AojdevStudio/nextjs-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AojdevStudio%2Fnextjs-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AojdevStudio%2Fnextjs-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AojdevStudio%2Fnextjs-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AojdevStudio%2Fnextjs-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AojdevStudio","download_url":"https://codeload.github.com/AojdevStudio/nextjs-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AojdevStudio%2Fnextjs-starter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31905896,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"ssl_error","status_checked_at":"2026-04-16T18:21:47.142Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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-16T22:03:40.409Z","updated_at":"2026-04-16T22:03:57.843Z","avatar_url":"https://github.com/AojdevStudio.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dental Case Acceptance Analytics\n\nA comprehensive analytics dashboard showing dental case acceptance rates, financial impact, and industry benchmarks.\n\n## 🚀 Features\n\n- ⚡ **Next.js** - Latest Next.js with App Router\n- ⚛️ **React** - Latest React version with hooks and server components\n- 📘 **TypeScript** - Type safety and better developer experience\n- 🎨 **Tailwind CSS** - Utility-first CSS framework\n- 🔐 **Authentication** - Ready-to-use auth with NextAuth.js\n- 🧩 **Component Library** - Basic UI components to get started\n- 📝 **ESLint \u0026 Prettier** - Code quality and formatting\n- 🧪 **Testing Setup** - Jest configuration for testing\n- 📱 **Responsive Design** - Mobile-first approach\n- 🌓 **Dark Mode** - Built-in dark mode support\n- 🚢 **CI/CD** - GitHub Actions workflow\n- 📦 **Directory Structure** - Organized project structure\n- 🛠️ **Cursor Editor Integration** - Best practices and rules\n\n## 📋 Prerequisites\n\n- Node.js 18.17.0 or later\n- npm or yarn package manager\n\n## 🏗️ Getting Started\n\n\u003e **Note:** This starter template uses `@latest` versions for all dependencies, ensuring you always get the most up-to-date packages when you create a new project. This design choice makes the template future-proof, but be aware that breaking changes in newer versions may require adjustments.\n\n1. Clone the repository:\n```bash\ngit clone \u003cyour-repo-url\u003e\ncd dental-case-acceptance-analytics\n```\n\n2. Install dependencies:\n```bash\nnpm install\n# or\nyarn install\n```\n\n3. Create a `.env.local` file in the root directory:\n```bash\ntouch .env.local\n```\n\n4. Start the development server:\n```bash\nnpm run dev\n# or\nyarn dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see the result.\n\n## 📁 Project Structure\n\n```\nnextjs-starter/\n├── .github/                  # GitHub actions and configuration\n├── .vscode/                  # VS Code settings\n├── .cursor/                  # Cursor editor integration\n├── public/                   # Static assets\n├── src/                      # Source directory\n│   ├── app/                  # App Router pages\n│   │   ├── (auth)/           # Auth route group\n│   │   │   ├── login/        # Login page\n│   │   │   ├── register/     # Register page\n│   │   ├── api/              # API routes\n│   │   │   └── auth/         # Auth API routes\n│   │   ├── dashboard/        # Dashboard page\n│   │   ├── favicon.ico       # Favicon\n│   │   ├── globals.css       # Global styles\n│   │   ├── layout.tsx        # Root layout\n│   │   └── page.tsx          # Home page\n│   ├── components/           # React components\n│   │   ├── auth/             # Auth components\n│   │   ├── common/           # Common components\n│   │   ├── layout/           # Layout components\n│   │   └── ui/               # UI components\n│   ├── hooks/                # Custom React hooks\n│   ├── lib/                  # Utility libraries\n│   ├── types/                # TypeScript types\n│   └── styles/               # Component styles\n├── .env.example              # Example environment variables\n├── .eslintrc.json           # ESLint configuration\n├── .gitignore               # Git ignore file\n├── .prettierrc              # Prettier configuration\n├── jest.config.js           # Jest configuration\n├── next.config.js           # Next.js configuration\n├── package.json             # Package dependencies\n├── postcss.config.js        # PostCSS configuration\n├── README.md                # Project documentation\n├── tailwind.config.js       # Tailwind configuration\n└── tsconfig.json            # TypeScript configuration\n```\n\n## 🔧 Available Scripts\n\n- `npm run dev` - Run development server\n- `npm run build` - Build for production\n- `npm start` - Start production server\n- `npm run lint` - Lint code with ESLint\n- `npm run test` - Run tests with Jest\n- `npm run test:watch` - Run tests in watch mode\n\n## 🔐 Authentication\n\nThis starter comes with NextAuth.js pre-configured. By default, it includes:\n\n- Credentials Provider (email/password)\n- GitHub OAuth Provider\n- Google OAuth Provider\n\nTo use social providers, you need to add your own API keys in the `.env.local` file.\n\n## 📚 Best Practices\n\nThis starter follows best practices for Next.js development:\n\n### Server Components\n\n- Use React Server Components where possible\n- Only add 'use client' directive when needed\n- Keep client components lean\n\n### Performance\n\n- Implement proper image optimization with next/image\n- Use dynamic imports for code splitting\n- Lazy load components when appropriate\n\n### Accessibility\n\n- Use semantic HTML elements\n- Include proper ARIA attributes\n- Ensure keyboard navigation works\n- Test with screen readers\n\n### State Management\n\n- Use local state for component-specific state\n- Use server actions for form submissions\n- Keep client-side state minimal\n\n## 🛠️ Cursor Editor Integration\n\nThis starter includes special `.cursor/rules` for Cursor editor integration:\n\n- `nextjs-best-practices.mdc` - Next.js best practices and patterns\n- `react-component-patterns.mdc` - React component structure and patterns\n\nThese rules help maintain consistency and follow best practices in your codebase.\n\n## 🧩 Custom Components\n\nThe starter includes several custom components to help you get started:\n\n- Authentication components (Login, Register)\n- Layout components (Header, Footer)\n- UI components (Button, Card, etc.)\n\n## 🌓 Dark Mode\n\nDark mode is built-in and can be toggled using Tailwind CSS classes:\n\n- Add the `dark` class to the `html` tag to enable dark mode\n- Use `dark:` prefix for dark mode styles\n\n## 🔄 Continuous Integration\n\nThe starter includes a GitHub Actions workflow for CI/CD:\n\n- Run ESLint\n- Run tests\n- Build the application\n\n## 📱 Responsive Design\n\nThe starter uses a mobile-first approach with Tailwind CSS:\n\n- Responsive breakpoints: sm, md, lg, xl, 2xl\n- Consistent spacing and sizing\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\nCopyright (c) 2024 Next.js Starter Kit. All rights reserved.\n\n## 🙏 Acknowledgments\n\n- [Next.js](https://nextjs.org/)\n- [Tailwind CSS](https://tailwindcss.com/)\n- [NextAuth.js](https://next-auth.js.org/)\n- [TypeScript](https://www.typescriptlang.org/)\n- [ESLint](https://eslint.org/)\n- [Prettier](https://prettier.io/)\n- [Jest](https://jestjs.io/)\n\n## 🎯 Quick Start for Basic Webpage\n\nIf you want to use this starter kit for a simple webpage (without authentication and complex features), follow these steps:\n\n1. Clone this repository:\n```bash\ngit clone https://github.com/AojdevStudio/nextjs-starter.git my-project\ncd my-project\n```\n\n2. Run the simplification script:\n```bash\nnode scripts/simplify.js\n```\n\nThis script will:\n- Remove unnecessary directories and files\n- Remove unused dependencies\n- Add Chart.js and React Chart.js 2\n- Update the homepage with a sample chart\n- Install the required dependencies\n\nThe simplified structure will be:\n```\nmy-project/\n├── public/                   # Static assets\n├── src/                     # Source directory\n│   ├── app/                 # App Router pages\n│   │   ├── globals.css      # Global styles\n│   │   ├── layout.tsx      # Root layout\n│   │   └── page.tsx        # Home page\n│   ├── components/         # React components\n│   │   ├── common/         # Common components\n│   │   └── ui/            # UI components\n│   └── lib/               # Utility libraries\n├── package.json           # Package dependencies\n├── tailwind.config.js     # Tailwind configuration\n└── tsconfig.json         # TypeScript configuration\n```\n\n3. Start the development server:\n```bash\nnpm run dev\n```\n\nYour simplified Next.js application will be running at [http://localhost:3000](http://localhost:3000) with:\n- ⚡ Modern React and Next.js\n- 🎨 Tailwind CSS styling\n- 📊 Chart.js integration\n- 📱 Responsive design\n- 🌓 Dark mode support\n\n### Customizing the Chart\n\nThe sample chart in `src/app/page.tsx` can be easily customized:\n- Change the chart type (Line, Bar, Pie, etc.)\n- Modify the data and labels\n- Adjust the styling and options\n- Add more charts to the dashboard\n\nFor more chart types and options, visit the [React Chart.js 2 documentation](https://react-chartjs-2.js.org/).\n\n## Running on Replit\n\n1. Create a new Repl and select \"Import from GitHub\"\n2. Paste your repository URL\n3. In the Replit shell, run:\n```bash\nnpm install\nnpm run dev\n```\n\n4. Important: Make sure to set the \"Run\" button command to:\n```bash\nnpm run dev\n```\n\n## Environment Variables\n\nNo environment variables are required for basic functionality.\n\n## Built With\n\n- [Next.js](https://nextjs.org/) - The React framework\n- [Tailwind CSS](https://tailwindcss.com/) - CSS framework\n- [Recharts](https://recharts.org/) - Charting library\n- [shadcn/ui](https://ui.shadcn.com/) - UI components\n\n## Development\n\n- `npm run dev` - Start development server\n- `npm run build` - Build for production\n- `npm start` - Start production server\n- `npm run lint` - Run ESLint\n\n## Troubleshooting\n\n### Common Issues\n\n1. **Module not found errors**\n   - Run `npm install` again\n   - Clear `.next` cache: `rm -rf .next`\n   - Ensure Node.js version is 18.17.0 or later\n\n2. **Build failures**\n   - Ensure all dependencies are installed\n   - Clear npm cache: `npm cache clean --force`\n   - Delete node_modules and reinstall: `rm -rf node_modules \u0026\u0026 npm install`\n\n3. **Replit-specific issues**\n   - Use Node.js 18.x or later in Replit\n   - Set correct run command in Replit config\n   - Ensure all dependencies are properly installed\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faojdevstudio%2Fnextjs-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faojdevstudio%2Fnextjs-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faojdevstudio%2Fnextjs-starter/lists"}