{"id":23185759,"url":"https://github.com/developer-multigroup/cekilis-arkadasi","last_synced_at":"2026-04-12T10:47:12.885Z","repository":{"id":268268516,"uuid":"902070118","full_name":"Developer-MultiGroup/cekilis-arkadasi","owner":"Developer-MultiGroup","description":"🎁 A web application for managing and organizing team giveaways, promoting engagement and fun within teams!","archived":false,"fork":false,"pushed_at":"2025-01-01T10:25:03.000Z","size":23700,"stargazers_count":0,"open_issues_count":8,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-04-05T04:44:09.320Z","etag":null,"topics":["giveaway","nextjs","open-source","reactjs","supabase","tailwindcss"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Developer-MultiGroup.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-12-11T21:07:52.000Z","updated_at":"2025-01-01T10:25:07.000Z","dependencies_parsed_at":"2025-01-01T11:33:23.099Z","dependency_job_id":null,"html_url":"https://github.com/Developer-MultiGroup/cekilis-arkadasi","commit_stats":null,"previous_names":["developer-multigroup/cekilis-arkadasi"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Developer-MultiGroup%2Fcekilis-arkadasi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Developer-MultiGroup%2Fcekilis-arkadasi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Developer-MultiGroup%2Fcekilis-arkadasi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Developer-MultiGroup%2Fcekilis-arkadasi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Developer-MultiGroup","download_url":"https://codeload.github.com/Developer-MultiGroup/cekilis-arkadasi/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247289398,"owners_count":20914464,"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":["giveaway","nextjs","open-source","reactjs","supabase","tailwindcss"],"created_at":"2024-12-18T10:12:40.797Z","updated_at":"2025-12-30T23:07:53.444Z","avatar_url":"https://github.com/Developer-MultiGroup.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![open_graph_image](public/images/documentation/opengraph-image.png)\n\n# DMG Çekiliş Arkadaşın\n\n[![Made With Love](https://img.shields.io/badge/Made%20With-Love-orange.svg)](https://github.com/chetanraj/awesome-github-badges) [![License: GNU](https://img.shields.io/badge/License-GNU-orange.svg)](https://opensource.org/licenses/gpl-2-0) [![GitHub pull-requests](https://img.shields.io/github/issues-pr/Developer-MultiGroup/cekilis-arkadasi.svg)](https://GitHub.com/Developer-MultiGroup/cekilis-arkadasi/pulls/) [![GitHub pull-requests](https://img.shields.io/github/issues/Developer-MultiGroup/cekilis-arkadasi.svg)](https://GitHub.com/Developer-MultiGroup/cekilis-arkadasi/issues/)\n\nDeveloper MultiGroup Çekiliş Arkadaşın is a web application for managing and organizing team giveaways, promoting engagement and fun within teams! There is a stage logic which is determined before the giveaway starts, so that every level unlocks in the specified time.\n\n## How to Play\n\n1. Login / Register with Supabase Auth\n2. **Stage-1:** Choose the person which you will buy a present to using a giveaway spinner.\n3. **Stage-2:** Upload the present you have bought to the system when the stage unlocks.\n4. **Stage-3:** Play a game of **_Who Bought This Present ?_** as the last stage, don't forget to check your score from the scoreboard page for more surprises :)\n\n## Technologies\n\n- Next.js: Used for both frontend and backend development of the site.\n- Vercel: For deployment of the project to the web.\n- Supabase: Preference of provider for user authentication and database management.\n- Tailwind CSS: Utility-first CSS framework for responsive and customizable UI.\n\n## Run Locally\n\n### Getting Started\n\n### Supabase Integration\n\nWe are using Supabase as our main storage - database - authentication provider for this project, so you firstly should [create an account](https://supabase.com/dashboard/sign-up).\n\n#### Project Creation\n\nAs the first step after creating account, we need to create an organization which will hold your project\n\n![create_org](public/images/documentation/create_org.png)\n\nand a project which will hold your data (storage - db - auth),\n\n![create_project](public/images/documentation/create_project.png)\n\n#### Database Creation\n\nNow you are ready to create the tables that will hold your user data, matches and present photo URL's. Here is the schema for the database tables:\n\n![db_schema](public/images/documentation/db-schema.png)\n\nTo create these tables, you can directly copy and paste the following query to SQL Editor which can be found in your sidebar:\n\n```postgresql\n-- Hold the user related calues\ncreate table users (\n    id uuid primary key default uuid_generate_v4(), -- Current User ID\n    name text, -- Name of the current user\n    surname text, -- Surname of the current user\n    photo_url text, -- Public URL to users profile picture\n    points int4, -- Points gained from the game stage\n    username text, -- Username of the current user\n    email text, -- E-Mail of the current user\n    has_match bool, -- Whether someone has this user as a match in the mathces table\n    game_played bool -- Whether the user has played the game already\n);\n\n-- Matches tablosu\ncreate table matches (\n    id uuid primary key default uuid_generate_v4(), -- Current User ID\n    matched_to text -- ID of the matched user\n);\n\n-- Presents tablosu\ncreate table presents (\n    id text primary key, -- Current User ID\n    photo_url text -- Public URL to the photo of the present this user has bought\n);\n```\n\n#### Storage Creation\n\nSupabase Storage will hold our user's profile pictures and the photos of the presents they have bought, so we need to initialize a storage bucket named `images` and some sub-folders inside that storage bucket with names `presents` and `users`. You can access storage bucket creation in your sidebar's\n\n```sh\n📂 images /\n├── 📂 presents/\n└── 📂 users/\n```\n\nIt is enough for you to create the directories correctly, the application will handle the rest of the work.\n\n#### Disable Authentication E-Mails\n\nIf you don't want your recently registered users to get an automatic e-mail from Supabase Auth for E-Mail verification, you can toggle the following setting in the Authentication tab of your sidebar:\n\n![disable_verification](public/images/documentation/disable_verify.png)\n\n### Environment Variables\n\nYou only need two environment variables to run the project correctly, your Supabase URL and Supabase Key. You can get this values from the following page:\n\n![environment_variables](public/images/documentation/env_variables.png)\n\nAfter getting these values, (assuming you already forked and cloned this project to your local machine, if not check out [run the project section](#run-the-project)) create a `.env` file at the root of your project and populate it like the following:\n\n```env\nNEXT_PUBLIC_SUPABASE_URL=your_supabase_url\nNEXT_PUBLIC_SUPABASE_KEY=your_supabase_key\n```\n\n### Run the Project\n\n1. **Clone the Repository**: Clone the repository to your local machine.\n\n   ```bash\n   git clone https://github.com/your-username/repository-name.git\n   cd repository-name\n   ```\n\n2. **Install Dependencies**: Install the required dependencies.\n\n   ```bash\n   npm install\n   ```\n\n3. **Start the Development Server**: Run the project in development mode.\n   ```bash\n   npm run dev\n   ```\n\n## Customizing\n\n### Organization Identity\n\nYou can change the background and logos both on the user form and loading screen easily, you only need to change the contents of the [following folder](https://github.com/Developer-MultiGroup/cekilis-arkadasi/tree/main/public/images/constants) while keeping the file names as they are.\n\n```sh\n📂 public /\n└── 📂 images/\n    └── 📂 constants/\n        ├── background.png\n        ├── loading_logo.png\n        └── logo.png\n```\n\n### Stages\n\nTo change the look, title or time of a stage you can simply edit the [stages array](https://github.com/Developer-MultiGroup/cekilis-arkadasi/blob/main/src/data/stages.ts) in the following directory\n\n```sh\n📂 src /\n└── 📂 data/\n    └── stages.ts\n```\n\nExample Stage Object:\n\n```ts\n{\n    \"index\": 1, // Takes values 1, 2 and 3\n    \"name\": \"Eşleşme\", // name of the stage displayed on StageCard component\n    \"start_date\": \"2024-12-15T22:30:00+03:00\", // Determines when the stage unlocks, accepts any time-zone in this format\n    \"image\": \"/images/stages/1.png\" // Path to the stage image shown on StageCard component\n}\n```\n\nYou don't need to edit the source URL for the stage image, rather you can just upload a new image with the same name to the [following directory](https://github.com/Developer-MultiGroup/cekilis-arkadasi/tree/main/public/images/stages), as in the [organization identity](#organization-identity) section above.\n\n```sh\n📂 public /\n└── 📂 images/\n    └── 📂 stages/\n        ├── 1.png\n        ├── 2.png\n        └── 3.png\n```\n\n## Contributing\n\nWe are open for any kind contribution you are interested in, follow these steps to help us:\n\n### 1. Fork \u0026 Clone\n\nFork this repository to your account and clone it to your local machine with the following command:\n\n```bash\ngit clone https://github.com/yourusername/project-name.git\ncd project-name\n```\n\n### 2. Create Branch\n\n```bash\ngit checkout -b feature/your-feature\n# or\ngit checkout -b fix/bug-name\n```\n\n### 3. Make Changes\n\nCode your features/fixes and have fun :)\n\n### 4. Check Status\n\n```sh\ngit status\nThis shows your changed files\n```\n\n### 5. Stage Changes\n\n```sh\n# Stage all changes\ngit add .\n# or stage for specific files\ngit add filename.js\n```\n\n### 6. Commit\n\n```sh\ngit commit -m \"Add: new login page\"\n# or\ngit commit -m \"Fix: navigation bar responsiveness\"\n```\n\n### 7. Push\n\n```sh\ngit push origin feature/your-feature\n```\n\n### 8. Create PR\n\nGo to GitHub and create a Pull Request to this repository\n\n## Contributors\n\n[![awesome contributors](https://contrib.rocks/image?repo=Developer-MultiGroup/cekilis-arkadasi)](https://github.com/Developer-MultiGroup/cekilis-arkadasi)\n\n[![Star History Chart](https://api.star-history.com/svg?repos=Developer-MultiGroup/cekilis-arkadasi\u0026type=Timeline)](https://star-history.com/#Developer-MultiGroup/cekilis-arkadasi)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeveloper-multigroup%2Fcekilis-arkadasi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeveloper-multigroup%2Fcekilis-arkadasi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeveloper-multigroup%2Fcekilis-arkadasi/lists"}