{"id":31557072,"url":"https://github.com/pirmax/skycle","last_synced_at":"2025-10-07T11:44:59.572Z","repository":{"id":317940780,"uuid":"1067045549","full_name":"pirmax/skycle","owner":"pirmax","description":"A modern web application built with Next.js, featuring AT Protocol integration, social media interaction, and dynamic content generation.","archived":false,"fork":false,"pushed_at":"2025-09-30T10:15:42.000Z","size":2553,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-04T02:56:28.655Z","etag":null,"topics":["atproto","atproto-client","atprotocol","bluesky","bluesky-api","bluesky-app","bluesky-client","nextjs","prisma","react","reactjs","shadcn","shadcn-ui","skycle","tailwindcss"],"latest_commit_sha":null,"homepage":"https://skycle.app","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/pirmax.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"pirmax","ko_fi":"pirmax","custom":"https://www.paypal.me/pirmax"}},"created_at":"2025-09-30T10:03:05.000Z","updated_at":"2025-10-03T10:32:23.000Z","dependencies_parsed_at":"2025-10-04T02:56:34.407Z","dependency_job_id":"ef886306-5b66-4bc2-882c-93c3ff870db1","html_url":"https://github.com/pirmax/skycle","commit_stats":null,"previous_names":["pirmax/skycle"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/pirmax/skycle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirmax%2Fskycle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirmax%2Fskycle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirmax%2Fskycle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirmax%2Fskycle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pirmax","download_url":"https://codeload.github.com/pirmax/skycle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirmax%2Fskycle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278386651,"owners_count":25978217,"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","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["atproto","atproto-client","atprotocol","bluesky","bluesky-api","bluesky-app","bluesky-client","nextjs","prisma","react","reactjs","shadcn","shadcn-ui","skycle","tailwindcss"],"created_at":"2025-10-04T23:22:13.030Z","updated_at":"2025-10-04T23:22:16.052Z","avatar_url":"https://github.com/pirmax.png","language":"TypeScript","funding_links":["https://github.com/sponsors/pirmax","https://ko-fi.com/pirmax","https://www.paypal.me/pirmax"],"categories":[],"sub_categories":[],"readme":"# Skycle\n\nA modern web application built with Next.js, featuring AT Protocol integration, social media interaction, and dynamic content generation.\n\n## Features\n\n- 🚀 **Next.js 14** with App Router\n- 🎨 **Tailwind CSS** for styling\n- 🔒 **AT Protocol** integration for decentralized social features\n- 📊 **Prisma ORM** with PostgreSQL database\n- ⚡ **Redis** for caching and session management\n- 🎯 **TypeScript** for type safety\n- 🎨 **Konva.js** for canvas graphics and image manipulation\n- 📱 **Responsive design** with mobile-first approach\n- 🌙 **Dark/Light mode** support\n\n## Prerequisites\n\nBefore you begin, ensure you have the following installed on your system:\n\n- **Node.js** (version 18 or higher)\n- **Bun** (recommended) or npm/yarn\n- **PostgreSQL** (version 12 or higher)\n- **Redis** (version 6 or higher)\n- **Git**\n\n## Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/pirmax/skycle.git\n   cd skycle\n   ```\n\n2. **Install dependencies**\n   ```bash\n   # Using Bun (recommended)\n   bun install\n   \n   # Or using npm\n   npm install\n   \n   # Or using yarn\n   yarn install\n   ```\n\n3. **Set up environment variables**\n   ```bash\n   cp .env.example .env\n   ```\n   \n   Edit the `.env` file and configure the following variables:\n   ```bash\n   # Bluesky/AT Protocol credentials\n   BSKY_ACCOUNT_HANDLE=\"your-handle.bsky.social\"\n   BSKY_ACCOUNT_PASSWORD=\"your-app-password\"\n   \n   # Security\n   COOKIE_PASSWORD=\"your-secure-cookie-password-min-32-chars\"\n   \n   # Application URL\n   NEXT_PUBLIC_URL=\"http://localhost:3000\"\n   \n   # Google Analytics (optional)\n   NEXT_PUBLIC_GA_MEASUREMENT_ID=\"G-XXXXXXXXXX\"\n   \n   # Database\n   DATABASE_URL=\"postgres://username:password@localhost:5432/skycle\"\n   \n   # Redis\n   REDIS_URL=\"redis://localhost:6379/0\"\n   \n   # Unsplash API (optional)\n   UNSPLASH_ACCESS_KEY=\"your-unsplash-access-key\"\n   UNSPLASH_SECRET_KEY=\"your-unsplash-secret-key\"\n   ```\n\n## Database Setup\n\n1. **Create a PostgreSQL database**\n   ```bash\n   # Connect to PostgreSQL\n   psql -U postgres\n   \n   # Create database\n   CREATE DATABASE skycle;\n   \n   # Exit PostgreSQL\n   \\q\n   ```\n\n2. **Generate Prisma client**\n   ```bash\n   bun run prisma:generate\n   ```\n\n3. **Run database migrations**\n   ```bash\n   bun run prisma:migration\n   ```\n\n## Redis Setup\n\nMake sure Redis is running on your system:\n\n```bash\n# Start Redis (macOS with Homebrew)\nbrew services start redis\n\n# Start Redis (Ubuntu/Debian)\nsudo systemctl start redis-server\n\n# Start Redis (Docker)\ndocker run -d -p 6379:6379 redis:alpine\n```\n\n## Development\n\n1. **Start the development server**\n   ```bash\n   bun run dev\n   ```\n\n2. **Open your browser**\n   Navigate to [http://localhost:3000](http://localhost:3000)\n\nThe application will automatically reload when you make changes to the code.\n\n## Available Scripts\n\n- `bun run dev` - Start the development server\n- `bun run build` - Build the application for production\n- `bun run start` - Start the production server\n- `bun run lint` - Run ESLint\n- `bun run lint:fix` - Run ESLint and fix issues automatically\n- `bun run format` - Format code with Prettier\n- `bun run prisma:generate` - Generate Prisma client\n- `bun run prisma:migration` - Run database migrations\n- `bun run prisma:migrate` - Push database schema changes\n\n## Project Structure\n\n```\nskycle/\n├── prisma/                 # Database schema and migrations\n│   ├── schema.prisma      # Prisma schema definition\n│   └── migrations/        # Database migration files\n├── public/                # Static assets\n├── src/\n│   ├── actions/          # Server actions\n│   ├── app/              # Next.js App Router pages\n│   ├── components/       # React components\n│   │   ├── ui/          # Reusable UI components\n│   │   ├── konva/       # Canvas/graphics components\n│   │   └── sheets/      # Sheet/modal components\n│   ├── hooks/           # Custom React hooks\n│   ├── lib/             # Utility libraries\n│   ├── providers/       # React context providers\n│   ├── styles/          # Global styles\n│   └── utils/           # Utility functions\n├── components.json      # shadcn/ui configuration\n├── tailwind.config.ts   # Tailwind CSS configuration\n└── next.config.js       # Next.js configuration\n```\n\n## Technologies Used\n\n### Core Framework\n- **Next.js 14** - React framework with App Router\n- **React 18** - UI library\n- **TypeScript** - Type-safe JavaScript\n\n### Styling\n- **Tailwind CSS** - Utility-first CSS framework\n- **shadcn/ui** - Beautiful UI components\n- **Radix UI** - Unstyled, accessible UI primitives\n\n### Database \u0026 Backend\n- **Prisma** - Modern database toolkit\n- **PostgreSQL** - Relational database\n- **Redis** - In-memory data store\n\n### Graphics \u0026 Canvas\n- **Konva.js** - 2D canvas graphics library\n- **react-konva** - React bindings for Konva\n- **Sharp** - Image processing\n\n### Authentication \u0026 Social\n- **AT Protocol** - Decentralized social networking protocol\n- **Iron Session** - Secure session management\n\n### Development Tools\n- **Biome** - Fast formatter and linter\n- **ESLint** - Code linting\n- **Prettier** - Code formatting\n\n## Configuration\n\n### Environment Variables\n\nThe application requires several environment variables to function properly:\n\n| Variable | Description | Required |\n|----------|-------------|----------|\n| `BSKY_ACCOUNT_HANDLE` | Your Bluesky handle | Yes |\n| `BSKY_ACCOUNT_PASSWORD` | Your Bluesky app password | Yes |\n| `COOKIE_PASSWORD` | Secure password for cookie encryption | Yes |\n| `NEXT_PUBLIC_URL` | Application URL | Yes |\n| `DATABASE_URL` | PostgreSQL connection string | Yes |\n| `REDIS_URL` | Redis connection string | Yes |\n| `NEXT_PUBLIC_GA_MEASUREMENT_ID` | Google Analytics ID | No |\n| `UNSPLASH_ACCESS_KEY` | Unsplash API access key | No |\n| `UNSPLASH_SECRET_KEY` | Unsplash API secret key | No |\n\n### Database Schema\n\nThe application uses Prisma with PostgreSQL. Key models include:\n\n- **Version** - Stores generated content versions\n- **AuthState** - Manages authentication states\n- **AuthSession** - Handles user sessions\n\n## Deployment\n\n### Build for Production\n\n```bash\nbun run build\n```\n\n### Start Production Server\n\n```bash\nbun run start\n```\n\n### Deploy to Vercel\n\n1. Push your code to GitHub\n2. Connect your repository to Vercel\n3. Set up environment variables in Vercel dashboard\n4. Deploy automatically on push to main branch\n\n### Deploy to Other Platforms\n\nThe application can be deployed to any platform that supports Node.js applications:\n\n- **Railway**\n- **Render**\n- **DigitalOcean App Platform**\n- **AWS**\n- **Google Cloud Platform**\n\nMake sure to:\n1. Set up environment variables\n2. Configure PostgreSQL and Redis instances\n3. Run database migrations\n4. Build the application\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the GPL v3.0 - see the [LICENSE](LICENSE) file for details.\n\n## Support\n\nIf you encounter any issues or have questions, please:\n\n1. Check the existing [issues](https://github.com/pirmax/skycle/issues)\n2. Create a new issue if your problem isn't already reported\n3. Provide as much detail as possible, including:\n   - Node.js version\n   - Operating system\n   - Error messages\n   - Steps to reproduce\n\n## Sponsor Me\n\nIf you find this project helpful and would like to support its development, please consider sponsoring me on GitHub:\n\n[![Sponsor Me](https://img.shields.io/badge/Sponsor-💖-pink?style=for-the-badge\u0026logo=github-sponsors)](https://github.com/sponsors/pirmax)\n\nYour support helps me:\n- 🚀 Continue developing and maintaining this project\n- 🛠️ Add new features and improvements\n- 🐛 Fix bugs and provide support\n- 📚 Create better documentation and tutorials\n- ☕ Stay caffeinated during late-night coding sessions\n\n[**Become a sponsor →**](https://github.com/sponsors/pirmax)\n\n## Acknowledgments\n\n- [Next.js](https://nextjs.org/) for the amazing React framework\n- [Tailwind CSS](https://tailwindcss.com/) for the utility-first CSS framework\n- [Prisma](https://prisma.io/) for the excellent database toolkit\n- [AT Protocol](https://atproto.com/) for decentralized social networking\n- [shadcn/ui](https://ui.shadcn.com/) for beautiful UI components","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpirmax%2Fskycle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpirmax%2Fskycle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpirmax%2Fskycle/lists"}