English ｜ 简体中文 / Simplified Chinese

HiCyou is a modern, AI-powered tools directory platform designed to help users discover and submit useful tools and resources. It leverages AI to automatically generate rich content—such as key features, use cases, and FAQs—to simplify the content creation process.

• Zero-cost deployment: Thanks to PaaS platforms with free tiers, you can achieve fast, stable, and reliable end-to-end deployment with virtually no cost.
• AI-powered content generation: Automatically extract and generate key features, use cases, and FAQs for submitted tools using AI.
• User submissions with admin review workflow: Users can submit tools, and admins can review and publish them.
• SEO optimization: Built with Next.js App Router, featuring dynamic sitemaps and optimized metadata.
• Modern UI/UX: Clean, responsive design built with Tailwind CSS and Shadcn UI.
• Secure user authentication: Full login and authorization system powered by Supabase.
• Cloudflare R2 storage: Efficient image storage for logos and cover images.
• Category management: Organize tools with custom icons and colors.

• Framework: Next.js 14
• Database: PostgreSQL (via Supabase)
• Auth: Supabase Auth
• ORM: Drizzle ORM
• Styling: Tailwind CSS & Shadcn UI
• Storage: Cloudflare R2
• AI Integration: OpenAI Completion API

Thanks to Supabase Auth, HiCyou can build and extend a user center with high security and low development cost.

• 100 GB/month free outbound bandwidth
• 1,000,000 free Edge Requests per month
• 1,000,000 free Functions invocations per month, roughly 4 hours of CPU and 360 GB·hours of memory

• 10 GB/month free standard or infrequent-access storage
• 1,000,000 free Class A (write) operations per month
• 10,000,000 free Class B (read) operations per month
• Zero egress fees (you only pay for storage and operations)

• Free 500 MB Postgres database + unlimited API requests
• Free 5 GB egress + 5 GB cached egress
• Free Auth: 50,000 MAUs/month, unlimited total users
• Free Realtime: 200 concurrent connections, 2,000,000 messages/month

The HiCyou project can be used for commercial purposes completely free of charge. However, if you use the HiCyou source code to build your own directory, you must display the “Powered by Hi Cyou” badge.

• The badge must be clearly visible on your website (typically in the footer or on an “About” page).
• The badge must link back to https://hicyou.com.
• Do not remove, modify, or cover the badge.
• Commercial use is allowed, as long as attribution is preserved.

Before you start, make sure you have the following installed:

• Node.js (v18 or higher)
• pnpm package manager
• A Supabase project
• A Cloudflare R2 bucket
• An API key for OpenAI or an OpenAI-compatible AI provider (optional)

git clone https://github.com/hicyoucom/hicyou cd hicyou

Use pnpm to install project dependencies:

pnpm install

Note: If you don’t have pnpm installed yet, you can install it with:

npm install -g pnpm

Copy the example environment file:

cp .env.example .env

Open the .env file and fill in the following configuration:

Log into your Supabase Dashboard and obtain the following values:

# Supabase configuration NEXT_PUBLIC_SUPABASE_URL=https://your-project-id.supabase.co NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key SUPABASE_SERVICE_ROLE_KEY=your-service-role-key DATABASE_URL=postgresql://postgres:[password]@db.[project-ref].supabase.co:5432/postgres

• NEXT_PUBLIC_SUPABASE_URL: Project Settings → API → Project URL
• NEXT_PUBLIC_SUPABASE_ANON_KEY: Project Settings → API → Project API keys → anon public
• SUPABASE_SERVICE_ROLE_KEY: Project Settings → API → Project API keys → service_role
• DATABASE_URL: Project Settings → Database → Connection string → URI

Configure your AI provider (OpenAI or any compatible service):

# AI configuration (OpenAI compatible) AI_API_KEY=your_api_key AI_BASE_URL=https://api.openai.com/v1 AI_MODEL=gpt-4o-mini

• AI_API_KEY: Your OpenAI API key or other compatible provider key.
• AI_BASE_URL: Base API URL (keep default if using OpenAI).
• AI_MODEL: Model name to use.

If you want to use Exa Search:

# Exa Search EXASEARCH_API_KEY=your_exa_api_key

Log into the Cloudflare Dashboard and configure R2 storage:

# R2 storage configuration R2_ACCOUNT_ID=your_account_id R2_ACCESS_KEY_ID=your_access_key_id R2_SECRET_ACCESS_KEY=your_secret_access_key R2_BUCKET_NAME=your_bucket_name R2_PUBLIC_URL=https://your-r2-domain.com R2_UPLOAD_DIR=hicyou/studio/uploads R2_LOGO_DIR=logos R2_COVER_DIR=covers

• In the Cloudflare Dashboard, go to R2 → “Manage R2 API Tokens” to create an API token.
• Create a bucket and configure a public access domain.

# Site URL and basic info NEXT_PUBLIC_SITE_URL=http://localhost:3000 NEXT_PUBLIC_SITE_NAME="HiCyou" NEXT_PUBLIC_MAIL=contact@hicyou.com NEXT_PUBLIC_Blog=https://blog.hicyou.com

If you want to use Cloudflare Turnstile:

# Turnstile configuration NEXT_PUBLIC_TURNSTILE_SITE_KEY=your_site_key TURNSTILE_SECRET_KEY=your_secret_key

⚠️ Only accounts whose email is configured here will have access to the admin panel.

Set admin emails (separate multiple emails with commas):

# Admin permissions ADMIN_EMAILS="admin@example.com,another@example.com"

Set a secure secret key for cron jobs:

# Cron secret (used for /api/cron/publish) CRON_SECRET=your_random_secret_string

For example, you can use an OpenSSL command to generate a 32-byte random string.

If these are left empty, no sponsor section will be shown.

# Sponsor configuration NEXT_PUBLIC_SPONSOR_IMAGE_URL=https://example.com/sponsor-image.avif NEXT_PUBLIC_SPONSOR_LINK=https://sponsor-website.com NEXT_PUBLIC_SPONSOR_TEXT=Sponsor name - short description

Run the database migrations to create the required tables and seed data:

pnpm db:generate pnpm db:migrate pnpm db:seed

Note: The seed data includes default categories and example tools to help you quickly understand the system structure.

pnpm dev

Open http://localhost:3000 in your browser to view the app.

1. Visit the site and click the “Submit tool” button.

2. Fill in the basic information for the tool:

   • URL (required)
   • Name
   • Description
   • Select category
   • Upload logo and cover image

3. After submission, the tool will enter the review queue.

4. AI will automatically analyze the tool and generate:

   • Key features
   • Use cases
   • Frequently asked questions

• Browse tools by category.
• Use the search feature to find specific tools.
• View detailed tool pages, including AI-generated content.

• After logging in, you can bookmark your favorite tools.
• View all your bookmarked tools in your profile.

1. Log in with an admin account (email must be included in the ADMIN_EMAILS configuration).
2. Open the admin panel.
3. View pending submissions.
4. Approve or reject submissions.
5. Once approved, the tool will be publicly visible on the site.

• Create, edit, or delete categories.
• Set icons and colors for categories.
• Adjust the display order of categories.

• Edit information for published tools.
• Manage user-submitted content.
• View site statistics.

# Development pnpm dev # Start the development server # Build and deploy pnpm build # Build for production pnpm start # Start the production server # Code quality pnpm lint # Run ESLint # Database management pnpm db:generate # Generate Drizzle migration files from the schema pnpm db:migrate # Apply database migrations pnpm db:studio # Open Drizzle Studio to inspect/manage the database pnpm db:seed # Seed the database with initial data # Cloudflare Pages deployment pnpm pages:build # Build for Cloudflare Pages pnpm preview # Preview the Cloudflare Pages build locally pnpm deploy # Deploy to Cloudflare Pages # Cron jobs pnpm cron:publish # Manually trigger the publish cron job

• profiles: User profile information
• categories: Tool categories
• bookmarks: Published tools
• submissions: Pending submissions

For detailed schema documentation, see ARCHITECTURE.md.

Update the AI configuration in .env:

# Use another OpenAI-compatible provider AI_API_KEY=your_api_key AI_BASE_URL=https://api.your-provider.com/v1 AI_MODEL=your-model-name

Add the new email address to ADMIN_EMAILS in .env:

ADMIN_EMAILS="admin1@example.com,admin2@example.com,new-admin@example.com"

1. Check whether DATABASE_URL is configured correctly.
2. Make sure the Supabase database is accessible.
3. Inspect the migration logs for error messages.
4. If needed, you can manually run the migration SQL in the Supabase Dashboard’s SQL Editor.

• Modify tailwind.config.ts to adjust Tailwind configuration.
• Edit app/globals.css to change global styles.
• Update components under the components/ directory to customize specific UI parts.

1. Push your code to GitHub.
2. Import the project in Vercel.
3. Configure environment variables (same as in .env).
4. Click deploy.

Contributions are welcome! Please follow these steps when contributing:

(Fill in your contribution guidelines here.)

If you have questions or suggestions, you can:

• Open an Issue
• Send an email to: contact@hicyou.com
• Visit our blog: https://blog.hicyou.com

Made with ❤️ and AI