{"id":21069260,"url":"https://github.com/harrisonwang/url-shortener","last_synced_at":"2025-05-16T04:34:22.496Z","repository":{"id":256154042,"uuid":"854458394","full_name":"harrisonwang/url-shortener","owner":"harrisonwang","description":"URL Shortener is a free tool designed to help users easily shorten long URLs. Our goal is to make URL shortening simple, fast, and efficient. Whether you're a marketer, developer, or anyone who needs to share links, URL Shortener can help you create concise, manageable links.","archived":false,"fork":false,"pushed_at":"2024-10-10T08:24:00.000Z","size":1066,"stargazers_count":33,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-27T20:38:59.355Z","etag":null,"topics":["nextjs","shortener","supabase"],"latest_commit_sha":null,"homepage":"https://t.voxsay.com","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/harrisonwang.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-09-09T07:57:37.000Z","updated_at":"2025-03-15T09:54:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"5159f617-3d24-4e84-ae06-3f6160925078","html_url":"https://github.com/harrisonwang/url-shortener","commit_stats":null,"previous_names":["harrisonwang/url-shortener"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harrisonwang%2Furl-shortener","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harrisonwang%2Furl-shortener/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harrisonwang%2Furl-shortener/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harrisonwang%2Furl-shortener/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/harrisonwang","download_url":"https://codeload.github.com/harrisonwang/url-shortener/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254470303,"owners_count":22076566,"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":["nextjs","shortener","supabase"],"created_at":"2024-11-19T18:33:46.423Z","updated_at":"2025-05-16T04:34:17.479Z","avatar_url":"https://github.com/harrisonwang.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# URL Shortener\n\n[English](README.md) | [中文](README.zh.md)\n\nURL Shortener is a free tool designed to help users easily shorten long URLs. Our goal is to make URL shortening simple, fast, and efficient. Whether you're a marketer, developer, or anyone who needs to share links, URL Shortener can help you create concise, manageable links.\n\n## About the Author\n\nThis website is built by [Harrison Wang](https://x.com/voywang) using [Cursor](https://www.cursor.com/) and theme originally by [Viggo](https://x.com/decohack).\n\n## Features\n\n- **Instant URL Shortening**: Quickly generate short links for any long URL.\n- **Custom Short Links**: Create memorable and branded short URLs.\n- **Analytics**: Track the performance of your shortened links.\n- **Secure and Reliable**: Ensure safe redirection and link management.\n- **Free to Use**: No cost associated with creating or managing short links.\n\n## Installation and Running\n\n### Prepare Supabase Project\n\nRun the following SQL commands in your Supabase project to create the necessary tables:\n\n```sql\ncreate table\n  public.links (\n    id serial not null,\n    url text null,\n    slug text null,\n    ua text null,\n    ip text null,\n    status integer null,\n    created_at timestamp without time zone null default current_timestamp,\n    constraint links_pkey primary key (id)\n  ) tablespace pg_default;\n\ncreate table\n  public.logs (\n    id serial not null,\n    url text null,\n    slug text null,\n    referer text null,\n    ua text null,\n    ip text null,\n    created_at timestamp without time zone null default current_timestamp,\n    constraint logs_pkey primary key (id)\n  ) tablespace pg_default;\n```\n\n### 1. Deploy to Vercel\n\nClick the button below to deploy to Vercel:\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FHarrisonWang%2Furl-shortener\u0026env=NEXT_PUBLIC_SUPABASE_URL\u0026env=NEXT_PUBLIC_SUPABASE_KEY\u0026project-name=url-shortener\u0026repository-name=url-shortener)\n\nConfigure the following environment variables:\n\n- `NEXT_PUBLIC_SUPABASE_URL`\n- `NEXT_PUBLIC_SUPABASE_KEY`\n\n### 2. Run Docker\n\n#### 2.1. Clone the Repository\n\n```bash\ngit clone https://github.com/harrisonwang/url-shortener.git\n```\n\n#### 2.2. Rename `.env.example` to `.env` and set environment variables\n\n```bash\nmv .env.example .env\n```\n\n```bash\nNEXT_PUBLIC_SUPABASE_URL=\nNEXT_PUBLIC_SUPABASE_KEY=\n```\n\n#### 2.3. Run Docker Container\n\n```bash\ndocker compose up -d\n```\n\n#### 2.4. Access the Application\n\nOpen your browser and visit `http://localhost:3000`, you should be able to see the URL short link generator interface.\n\n### 3. Run Locally\n\n#### 3.1. Clone the Repository\n\n```bash\ngit clone https://github.com/harrisonwang/url-shortener.git\n```\n\n#### 3.2. Install Dependencies\n\n```bash\nnpm i\n```\n\n#### 3.3. Rename `.env.example` to `.env` and set environment variables\n\n```bash\nmv .env.example .env\n```\n\n```bash\nNEXT_PUBLIC_SUPABASE_URL=\nNEXT_PUBLIC_SUPABASE_KEY=\n```\n\n#### 3.4. Run the Development Server\n\n```bash\nnpm run dev\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharrisonwang%2Furl-shortener","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharrisonwang%2Furl-shortener","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharrisonwang%2Furl-shortener/lists"}