An open API service indexing awesome lists of open source software.

https://github.com/yllvar/ily.quest

Build websites with AI, no code required | Always wanted to build but haven't had the time? or technical skills to create?
https://github.com/yllvar/ily.quest

code-generator web-application web-development web-generator

Last synced: 2 months ago
JSON representation

Build websites with AI, no code required | Always wanted to build but haven't had the time? or technical skills to create?

Awesome Lists containing this project

README

          

# iLy.quest
---


Build websites with AI, no code required.


Website
Features
Getting Started
Development
Deployment
Contributing
License


iLy.quest Screenshot

---

## Overview

iLy.quest is an AI-powered web development platform that enables users to create sophisticated websites using natural language instructions. It combines a code editor, real-time preview, and advanced AI assistance powered by DeepSeek to streamline the web development process.

## Features

### 🤖 AI-Powered Development
- Generate complete HTML, CSS, and JavaScript from natural language descriptions.
- Get intelligent suggestions and improvements for your code.
- Ask questions about web development and receive expert guidance.

### 📝 Professional Code Editor
- Syntax highlighting and autocompletion.
- Error detection and code suggestions.
- Full access to edit and customize generated code.

### 👁️ Real-Time Preview
- See your changes instantly.
- Test responsiveness and interactions.
- Debug visual elements in real-time.

### 🚀 One-Click Deployment
- Deploy to Hugging Face Spaces with a single click.
- Share your creation with a public URL.
- Allow others to remix and build upon your work.

### 🔄 Remix and Collaborate
- Start from existing templates.
- Remix other users' projects.
- Share and collaborate on web development.

![Screen Recording 2025-04-02 at 03 57 06](https://github.com/user-attachments/assets/faf0bd2b-96b2-4033-9b09-33d3115398f5)

---

## Getting Started

### Prerequisites
- A modern web browser (Chrome, Firefox, Safari, Edge).
- A [Hugging Face](https://huggingface.co) account for authentication and deployment.

### Quick Start
1. Visit [iLy.quest](https://ily.quest).
2. Sign in with your Hugging Face account.
3. Start a new project or remix an existing one.
4. Use AI to generate code or start coding manually.
5. Deploy your site when ready.

### Example Prompts
Try these prompts to see what iLy.quest can do:
- "Create a responsive landing page for a fitness app with a hero section, features, and pricing."
- "Build a portfolio website with a gallery, about section, and contact form."
- "Make an e-commerce product page with an image carousel, description, and add-to-cart button."
- "Design a dashboard layout with sidebar navigation, stats cards, and a data table."

---

## Development

iLy.quest is built with modern web technologies:

- **Frontend:** Next.js, React, TailwindCSS
- **AI:** DeepSeek integration via AI SDK
- **Authentication:** Hugging Face OAuth
- **Database:** Supabase
- **Deployment:** Vercel, Hugging Face Spaces

### Local Development Setup

```sh
# Clone the repository
git clone https://github.com/yllvar/ily.quest.git
cd ily.quest

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your API keys and configuration

# Start the development server
npm run dev
```

### Environment Variables

The following environment variables are required:

```plaintext
# App
NEXT_PUBLIC_APP_URL=http://localhost:3000

# Authentication
OAUTH_CLIENT_ID=your_huggingface_oauth_client_id
OAUTH_CLIENT_SECRET=your_huggingface_oauth_client_secret
REDIRECT_URI=http://localhost:3000/api/auth/callback

# API Keys
DEEPSEEK_API_KEY=your_deepseek_api_key
DEFAULT_HF_TOKEN=your_huggingface_token

# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key
```

---

## Deployment

### Deploying to Vercel
The easiest way to deploy iLy.quest is using Vercel:

1. Fork this repository.
2. Create a new project on [Vercel](https://vercel.com).
3. Connect your forked repository.
4. Configure environment variables.
5. Deploy.

### Manual Deployment
For other hosting providers:

```sh
# Build the application
npm run build

# Start the production server
npm start
```

---

## Project Structure

```plaintext
ily.quest/
├── app/ # Next.js App Router
│ ├── api/ # API routes
│ ├── layout.tsx # Root layout
│ └── page.tsx # Home page
├── components/ # React components
├── lib/ # Utility functions and configuration
├── public/ # Static assets
└── ... # Configuration files
```

---

## Security Considerations
- API keys are securely stored as environment variables.
- Authentication is handled via OAuth with secure token storage.
- CORS headers are properly configured for API security.
- Rate limiting is implemented to prevent abuse.
- User content is sanitized to prevent XSS attacks.

---

## Performance Optimizations
- Code splitting and lazy loading for faster initial load.
- Static generation for non-dynamic pages.
- Optimized image loading and processing.
- Efficient state management to minimize re-renders.
- Edge caching for API responses where appropriate.

---

## Contributing
We welcome contributions to iLy.quest! Please follow these steps:

1. Fork the repository.
2. Create a feature branch (`git checkout -b feature/amazing-feature`).
3. Commit your changes (`git commit -m 'Add some amazing feature'`).
4. Push to the branch (`git push origin feature/amazing-feature`).
5. Open a Pull Request.

### Development Guidelines
- Follow the existing code style and conventions.
- Write tests for new features.
- Update documentation as needed.
- Ensure all tests pass before submitting a PR.

---

## Roadmap
- Enhanced component library.
- Collaborative editing features.
- Additional deployment options.
- Advanced AI customization.
- Mobile app development support.
- Integration with design tools.

---

## License
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.

## Acknowledgements
- [DeepSeek](https://deepseek.ai) for AI-powered assistance.
- [Hugging Face](https://huggingface.co) for authentication and hosting.
- [Supabase](https://supabase.io) for database services.
- [Next.js](https://nextjs.org) for the application framework.
- [Vercel](https://vercel.com) for hosting and infrastructure.