vibefigma 1.0.0

package/LICENSE

@@ -0,0 +1,110 @@
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2026 VibeFlowing Inc.
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,32 @@
+NOTICE
+
+This project includes code derived from the following open source projects:
+
+================================================================================
+
+css-to-tailwindcss
+Copyright (c) 2023 Salakhutdinov Salavat
+License: MIT
+Source: https://github.com/Jackardios/css-to-tailwindcss
+
+The MIT License requires the following notice:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+================================================================================

package/README.md

@@ -0,0 +1,216 @@
+# VibeFigma - Figma to React Converter
+
+Transform your Figma designs into production-ready React components with Tailwind CSS automatically. VibeFigma leverages the official Figma API to accurately extract design information and generate clean, maintainable code.
+
+## Demo
+
+<div align="center">
+  <a href="https://www.youtube.com/watch?v=6DhaK_thwkc">
+    <img src="https://img.youtube.com/vi/6DhaK_thwkc/maxresdefault.jpg" alt="VibeFigma Demo" style="width:100%;max-width:720px;">
+  </a>
+</div>
+
+## CLI in Action
+
+<div align="center">
+  <img src=".github/cli-demo.png" alt="VibeFigma CLI Demo" style="width:100%;max-width:800px;">
+</div>
+
+## Features
+
+- **Official Figma API Integration** - Direct integration with Figma's API for accurate design extraction
+- **React Component Generation** - Convert Figma frames to React/TypeScript components
+- **Tailwind CSS Support** - Automatic Tailwind class generation (enabled by default)
+- **Code Optimization** - Optional AI-powered code cleanup
+
+## Quick Start
+
+### Using npx (Recommended)
+
+No installation required! Just run:
+
+```bash
+npx vibefigma [figma-url] --token YOUR_FIGMA_TOKEN
+
+# Example with a public design:
+npx vibefigma https://www.figma.com/design/rZbJ7EQucq6UCkqlIl1a6P/Personal-Portfolio-Website-Template--Community?node-id=7-191 --token YOUR_TOKEN
+```
+
+### Using Environment Variable
+
+Set your Figma token once:
+
+```bash
+export FIGMA_TOKEN=your_figma_access_token
+npx vibefigma https://www.figma.com/design/YOUR_FILE_ID
+```
+
+### Interactive Mode
+
+```bash
+npx vibefigma --interactive
+```
+
+This will prompt you for:
+- Figma URL
+- Access token (if not set in environment)
+- Output paths
+
+## Usage
+
+### Basic Usage
+
+```bash
+# Convert a Figma design to React component
+npx vibefigma https://www.figma.com/design/YOUR_FILE_ID?node-id=X-Y
+```
+
+### Custom Output Paths
+
+```bash
+# Save to specific directory
+npx vibefigma [url] -c ./src/components -a ./public/assets
+
+# Save to specific file
+npx vibefigma [url] -c ./src/components/Hero.tsx
+```
+
+### Disable Tailwind CSS
+
+```bash
+# Generate regular CSS instead of Tailwind
+npx vibefigma [url] --no-tailwind
+```
+
+### Advanced Options
+
+```bash
+npx vibefigma [url] \
+  --token YOUR_TOKEN \
+  --component ./src/components \
+  --assets ./public/assets \
+  --optimize \
+  --clean
+```
+
+## 🔑 Getting a Figma Access Token
+
+1. Go to [Figma Account Settings](https://www.figma.com/settings)
+2. Scroll to **Personal Access Tokens**
+3. Click **Generate new token**
+4. Give it a name and click **Generate**
+5. Copy the token (you won't see it again!)
+
+Set it as an environment variable:
+
+```bash
+# Linux/Mac
+export FIGMA_TOKEN=your_token_here
+
+# Windows (PowerShell)
+$env:FIGMA_TOKEN="your_token_here"
+
+# Windows (CMD)
+set FIGMA_TOKEN=your_token_here
+```
+
+## Command Options
+
+```
+Usage: vibefigma [options] [url]
+
+Convert Figma designs to React components
+
+Arguments:
+  url                           Figma file/node URL
+
+Options:
+  -V, --version                 Output the version number
+  -t, --token <token>           Figma access token (overrides FIGMA_TOKEN env var)
+  -u, --url <url>               Figma file/node URL
+  -c, --component <path>        Component output path (default: ./src/components/[ComponentName].tsx)
+  -a, --assets <dir>            Assets directory (default: ./public)
+  --no-tailwind                 Disable Tailwind CSS (enabled by default)
+  --optimize                    Optimize components
+  --clean                       Use AI code cleaner (requires GOOGLE_GENERATIVE_AI_API_KEY)
+  --no-classes                  Don't generate CSS classes
+  --no-absolute                 Don't use absolute positioning
+  --no-responsive               Disable responsive design
+  --no-fonts                    Don't include fonts
+  --interactive                 Force interactive mode
+  -h, --help                    Display help for command
+```
+
+## 🛠️ Development
+
+### API Server
+
+This project also includes a REST API server:
+
+```bash
+# Install dependencies
+bun install
+
+# Run development server
+bun run dev
+
+# Server runs on http://localhost:3000
+```
+
+### CLI Development
+
+```bash
+# Run CLI in development mode
+bun run dev:cli
+
+# Build CLI
+bun run build:cli
+
+# Test CLI locally
+bun run cli -- --help
+```
+
+## API Usage
+
+The project includes a REST API for Figma to React conversion:
+
+```bash
+POST /v1/api/vibe-figma
+```
+
+See [API.md](docs/API.md) for full API documentation.
+
+## Configuration
+
+### Environment Variables
+
+Create a `.env` file:
+
+```env
+# Required for CLI
+FIGMA_TOKEN=your_figma_access_token
+
+# Optional: For AI code cleanup feature
+GOOGLE_GENERATIVE_AI_API_KEY=your_google_ai_key
+
+# API Server Configuration (for development server)
+PORT=3000
+HOST=0.0.0.0
+CORS_ORIGIN=*
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Acknowledgments
+
+This project includes code derived from [css-to-tailwindcss](https://github.com/Jackardios/css-to-tailwindcss) by Salakhutdinov Salavat, licensed under the MIT License.
+
+## License
+
+Copyright 2026 VibeFlowing Inc.
+
+This project is licensed under the Functional Source License, Version 1.1, MIT Future License (FSL-1.1-MIT). See the [LICENSE](LICENSE) file for the full license text.
+
+See the [NOTICE](NOTICE) file for details about third-party code used in this project.

package/bin/vibefigma.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli/index.js'