{"id":25234153,"url":"https://github.com/basuabhirup/kichirmichir","last_synced_at":"2026-02-03T04:05:03.113Z","repository":{"id":246531409,"uuid":"820600464","full_name":"basuabhirup/kichirmichir","owner":"basuabhirup","description":"🦜 An Interactive, Duolingo-Inspired Language Learning Application","archived":false,"fork":false,"pushed_at":"2024-09-12T08:44:37.000Z","size":873,"stargazers_count":3,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"development","last_synced_at":"2025-04-02T02:11:16.340Z","etag":null,"topics":["clerk","drizzle-orm","neondb","nextjs14","postgresql","shadcn-ui","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://kichirmichir-v1.vercel.app","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/basuabhirup.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":"2024-06-26T19:56:18.000Z","updated_at":"2024-10-14T11:02:39.000Z","dependencies_parsed_at":"2024-09-12T18:21:49.916Z","dependency_job_id":"41c5317c-a388-4c5f-92c5-02f89b1ea0cb","html_url":"https://github.com/basuabhirup/kichirmichir","commit_stats":null,"previous_names":["basuabhirup/nextjs_kichirmichir"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/basuabhirup/kichirmichir","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basuabhirup%2Fkichirmichir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basuabhirup%2Fkichirmichir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basuabhirup%2Fkichirmichir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basuabhirup%2Fkichirmichir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/basuabhirup","download_url":"https://codeload.github.com/basuabhirup/kichirmichir/tar.gz/refs/heads/development","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/basuabhirup%2Fkichirmichir/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261193126,"owners_count":23122909,"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":["clerk","drizzle-orm","neondb","nextjs14","postgresql","shadcn-ui","tailwindcss","typescript"],"created_at":"2025-02-11T13:58:46.904Z","updated_at":"2026-02-03T04:05:03.080Z","avatar_url":"https://github.com/basuabhirup.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kichirmichir 🦜\n\n**Kichirmichir** is an interactive language learning application designed to make language acquisition as fun as the chirping of birds. The name \"Kichirmichir\" is derived from the Bengali word for \"chirping,\" symbolizing this app's vibrant and engaging nature.\n\nThis project is a clone of the popular language-learning app Duolingo, built with cutting-edge technologies to create a seamless and intuitive user experience.\n\nhttps://github.com/user-attachments/assets/c2328f45-33b3-4fc7-8900-ef65a6172b17\n\n## 🚀 Features\n\n- **Interactive Lessons:** Engaging language lessons that guide users from basic to advanced levels.\n- **Gamified Learning Experience:** Earn points, unlock new levels, and track progress like in Duolingo.\n- **Voiceover by AI:** Leveraging Elevenlabs AI for natural and dynamic voiceovers.\n- **Admin Dashboard:** Manage users, courses, and content effortlessly with a powerful admin interface.\n\n## 🛠 Tech Stack\n\n- **Next.js v14:** Utilizes server-side rendering and static site generation for fast, SEO-friendly pages.\n- **Shadcn UI \u0026 Tailwind CSS:** Provides a modern and accessible user interface with utility-first CSS for responsive design.\n- **Clerk:** Manages secure user authentication and user management.\n- **Drizzle ORM:** Offers type-safe ORM for efficient database queries with PostgreSQL.\n- **Elevenlabs AI:** Delivers natural voiceovers to enhance the auditory learning experience.\n- **React-Admin:** Powers the admin dashboard for efficient backend management.\n- **Neon DB:** Hosts a scalable and secure cloud-based PostgreSQL database.\n- **React-Use \u0026 Zustand:** Enhances app functionality with hooks and centralized state management.\n\n## 🛤 Future Plans\n\nKichirmichir aims to go beyond language learning. We plan to introduce various challenges and expand the course offerings to transform it into a versatile quiz and for-fun app.\n\n\n## 📚 Getting Started\n\n### Prerequisites\n\n- **Node.js** v16 or higher\n- **npm**\n- An working account on [Clerk](https://clerk.dev)\n- An working account on [Neon DB](https://neon.tech)\n\n### Installation\n\n1. **Clone the repository:**\n\n    ```bash\n    git clone https://github.com/yourusername/kichirmichir.git\n    ```\n\n2. **Navigate to the project directory:**\n\n    ```bash\n    cd kichirmichir\n    ```\n\n3. **Install dependencies:**\n\n    ```bash\n    npm install\n    ```\n\n4. **Set up environment variables:**\n\n    - Copy the `.env.example` file to `.env`:\n\n        ```bash\n        cp .env.example .env\n        ```\n\n    - Open the `.env` file and fill in the necessary values:\n\n        ```env\n        NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=\"your_clerk_publishable_key\"\n        CLERK_SECRET_KEY=\"your_clerk_secret_key\"\n        NEXT_PUBLIC_CLERK_SIGN_IN_FORCE_REDIRECT_URL=\"/learn\"\n        NEXT_PUBLIC_CLERK_SIGN_UP_FORCE_REDIRECT_URL=\"/learn\"\n        DATABASE_URL=\"your_postgresql_database_url\"\n        ADMIN_USER_ID=\"your_admin_user_id\"\n        ```\n\n        \u003e **Notes:**\n        \u003e\n        \u003e - Replace `your_clerk_publishable_key` and `your_clerk_secret_key` with your keys from the [Clerk Dashboard](https://dashboard.clerk.dev/).\n        \u003e - Replace `your_postgresql_database_url` with your Neon DB connection string from the [Neon DB Dashboard](https://console.neon.tech/).\n\n5. **Run the development server:**\n\n    ```bash\n    npm run dev\n    ```\n\n6. **Open the app in your browser:**\n\n    Navigate to [http://localhost:3000](http://localhost:3000) to view the app.\n\n      Now please sign up in the application using `Clerk` in your localhost and then find your `userId` in the [Clerk Dashboard](https://dashboard.clerk.dev/) or inside the `userProgress` table in your Neon database. \n  \n    \u003e - Add your `userId` in the `ADMIN_USER_ID` field of your `.env` file and restart the `localhost` server again\n    \u003e - Only the account with the `ADMIN_USER_ID` will be able to access the admin dashboard at the `/admin` route.\n\n\n## 🧑‍💻 Contributing\n\nContributions are welcome! If you'd like to contribute to Kichirmichir, please fork the repository, create a new branch, and submit a pull request. Make sure to follow the code style and add relevant tests.\n\n## 📝 License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbasuabhirup%2Fkichirmichir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbasuabhirup%2Fkichirmichir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbasuabhirup%2Fkichirmichir/lists"}