diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..83368a8 --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +images/.DS_Store +.DS_store \ No newline at end of file diff --git a/Screenshot2025-02-03at12.44.21PM.png b/Screenshot2025-02-03at12.44.21PM.png new file mode 100644 index 0000000..4daa973 Binary files /dev/null and b/Screenshot2025-02-03at12.44.21PM.png differ diff --git a/Screenshot2025-02-03at12.47.42PM.png b/Screenshot2025-02-03at12.47.42PM.png new file mode 100644 index 0000000..f290543 Binary files /dev/null and b/Screenshot2025-02-03at12.47.42PM.png differ diff --git a/Screenshot2025-02-03at12.50.50PM.png b/Screenshot2025-02-03at12.50.50PM.png new file mode 100644 index 0000000..1456ca4 Binary files /dev/null and b/Screenshot2025-02-03at12.50.50PM.png differ diff --git a/Screenshot2025-02-03at12.52.30PM.png b/Screenshot2025-02-03at12.52.30PM.png new file mode 100644 index 0000000..ba6f78c Binary files /dev/null and b/Screenshot2025-02-03at12.52.30PM.png differ diff --git a/Screenshot2025-02-11at1.14.17PM.png b/Screenshot2025-02-11at1.14.17PM.png new file mode 100644 index 0000000..940d1e2 Binary files /dev/null and b/Screenshot2025-02-11at1.14.17PM.png differ diff --git a/account/subscriptions.mdx b/account/subscriptions.mdx index 522c3b7..243f449 100644 --- a/account/subscriptions.mdx +++ b/account/subscriptions.mdx @@ -49,8 +49,13 @@ You can view and upgrade your subscription at [create.xyz/pricing](https://creat To manage your subscription: 1. Click your profile icon in the bottom left corner of the dashboard -2. Select "Manage Subscription" +2. Select "[Manage Subscription](https://pay.create.xyz/p/login/5kA6oDbVS22c2jedQQ)" 3. From here you can: - Upgrade your plan - Downgrade your plan - Cancel your subscription + + +## Invoices, Receipts, and Billing History + +You can access your invoices, receipts, and billing history through Create's [billing portal](https://pay.create.xyz/p/login/5kA6oDbVS22c2jedQQ) in Stripe. \ No newline at end of file diff --git a/auth/facebook.mdx b/auth/facebook.mdx new file mode 100644 index 0000000..da49764 --- /dev/null +++ b/auth/facebook.mdx @@ -0,0 +1,270 @@ +--- +title: "Facebook Login" +description: "Let users login to your app with their Facebook accounts" +--- + +Let users sign in to your app with their Facebook accounts. They'll share their email, name, and profile picture. + +You'll need to set up a few things in Facebook first, then add those settings to Create. + +## Before You Start + +Make sure you have: + + + A Create project with [User Accounts](/builder/user-accounts) turned on + + + + Your app running on a custom domain through [Create's domain setup](/publish-and-share/custom-domains) + + +## Overview + + + + Create an app in Facebook + + + Add your Facebook App ID and Secret to Create + + + Make the login button look how you want + + + Make sure login works + + + +## Facebook Setup + + + + 1. Go to [Facebook for Developers](https://developers.facebook.com) + 2. Sign in with your Facebook account + 3. Click "My Apps" in the top right + + + + + 1. Click "Create App" from the dashboard + 2. You'll be taken to the app creation screen + + + + + 1. Enter your app name + 2. Add your contact email + 3. Click "Create App" + + + Choose an app name that clearly represents your business or service - this will be visible to users + + + + + 1. On the product selection screen + 2. Find and select "Facebook Login" + 3. This will add the login capability to your app + + + + + 1. Choose whether to add your app to a business portfolio + 2. You can skip this step for now during development + 3. You'll need to complete this before launching + + + + + 1. Click "Go to Dashboard" to finalize the initial setup + 2. This will take you to your app's main dashboard + + + + + 1. Navigate to App Settings > Permissions + 2. Add the email permission if you want to receive user email addresses + 3. This is optional but recommended if your app needs to email users + + + + + 1. In the left sidebar, click "Facebook Login > Settings" + 2. This is where you'll configure the OAuth settings + + + + + 1. Under "Valid OAuth Redirect URIs" + 2. Add: `https://www.your-domain.com/api/auth/callback/facebook` + 3. Replace "your-domain.com" with your actual domain + + + Must include: + - `https://` protocol + - `www` prefix in the domain + - Exact domain used in Create's custom domain settings + - Valid CNAME record for `www` subdomain in DNS + + + + + 1. Scroll to the bottom of the settings page + 2. Click "Save Changes" to store your OAuth configuration + + + + + 1. Navigate to Settings > Basic in the left sidebar + 2. This section contains your app credentials and core settings + + + + + 1. Find your App ID + 2. Click "Show" to reveal your App Secret + 3. Save both values - you'll need them for Create setup + + + Keep your App Secret secure - never share it publicly + + + + + + Before launching, you'll need to complete these additional settings: + + 1. Add your domain with `www` prefix + 2. Add Privacy Policy URL + 3. Add User Data Deletion Policy URL + 4. Add Terms of Service URL + + + You can use services like Termly to generate these required policy documents and then host them on pages in your Create app. + + + + + + Required before launching your app: + + 1. Complete the business verification process + 2. Provide required documentation + 3. Wait for Facebook's review + + + + + + Final step before going live: + + 1. Navigate to the App Dashboard + 2. Switch your app from Development to Live mode + 3. Complete any remaining verification steps + + + + +## Add to Create Project + + + + You have two options: + 1. Prompt Create with "Let users sign in" + 2. Enable User Accounts from the logo menu + + + + 1. Click the 3-dot menu at the top of the chat + 2. Select "Project Settings" + + + + + 1. Navigate to the Authentication section + 2. Find Facebook Login toggle + 3. Turn it on + + + + + 1. Paste in your App ID + 2. Paste in your App Secret + 3. Click Save + + + + + 1. Return to the chat + 2. Prompt Create with "Add Facebook Login as an option" + 3. Create will update your sign-in pages automatically + + + + + 1. Click the Publish button + 2. Review your changes + 3. Publish to make the Facebook Login feature live + + + +## Testing + +1. Publish your changes +2. Open your app in a new incognito window +3. Go to the sign in page +4. Try signing in with Facebook +5. Check the [auth_users table](/builder/databases) to see your new user + +## Troubleshooting + + + - Check if User Accounts is turned on + - Make sure Facebook Login is enabled in Project Settings + - Try publishing your changes again + - Clear your browser data and try in incognito mode + + + + - Double check your domain is exactly the same in Create and Facebook + - Make sure your callback URL is right: `www.your-domain.com/api/auth/callback/facebook` + - Check if your App ID and Secret are pasted correctly + - Verify your domain is set up in Facebook + - Make sure your app is live at your custom domain + + + + - Update the OAuth Redirect URIs in Facebook + - Update your App Domains in Facebook + - Re-publish your app on the new domain + + +## FAQ + + + By default: + - Email address + - Name + - Profile picture (if they have one) + + Additional information requires requesting extra permissions and may require Facebook app review. + + + + Yes! Just: + 1. Go back to chat + 2. Tell Create how you want it to look + 3. Create will help style it while following Facebook's rules + + + + - For basic login: No + - For extra features: Yes + - You'll need to submit your app to Facebook for approval + + +## See Also + +- [User Accounts](/builder/user-accounts) +- [Customizing Login Pages](/builder/user-accounts#customizing-auth-pages) diff --git a/auth/google.mdx b/auth/google.mdx new file mode 100644 index 0000000..b3f823a --- /dev/null +++ b/auth/google.mdx @@ -0,0 +1,306 @@ +--- +title: "Google Sign In" +description: "Let users sign in to your app with their Google account" +--- + +Let users sign in to your app with their Google accounts. They'll share their email, name, profile picture, and language settings. + +You'll need to set up a few things in Google first, then add those settings to Create. + +## Before You Start + +Make sure you have: + + + A Create project with [User Accounts](/builder/user-accounts) turned on + + + + Your app running on a custom domain through [Create's domain setup](/publish-and-share/custom-domains) + + + + Google Sign In needs a custom domain - you can't use the default `created.app` domains. You'll need: + - A domain you own + - [Create Pro subscription](https://create.xyz/pricing) + - DNS records properly configured + + +## Overview + + + + Set up OAuth in Google Cloud Console + + + Add Google Client ID/Secret in Create + + + Make the page look how you want + + + Make sure login works + + + +## Google Cloud Setup + + + + 1. Go to [Google Cloud OAuth Clients](https://console.cloud.google.com/auth/clients) + 2. Sign in with your Google account + + + + + 1. Click the project selector dropdown + 2. Choose to create a new project or select an existing one + + + + + 1. If creating new: Enter a recognizable project name (internal use only) + 2. Choose whether to add it to an existing Organization or "No organization" + 3. Click "Create" + + + + + 1. Once project is selected/created + 2. Click "Get Started" on the Google Auth Platform screen + + + + + 1. Enter your App Name (this will be public-facing) + 2. Add a support email address (this will be public-facing) + + + + + 1. Choose your app's audience + 2. Select "External" unless this is an internal app for your Google Workspace organization + + + + + 1. Enter developer contact email address + 2. This will be used by Google to contact you about your application + + + + + 1. Navigate to credentials section + 2. Click "Create OAuth Client" + + + + + 1. Select "Web Application" as the application type + 2. Name your client (e.g., "Production") + + + + + 1. Add `www.your-custom-domain.com` as an Authorized JavaScript Origin (replace with your actual domain) + 2. Add `www.your-custom-domain.com/api/auth/callback/google` as an Authorized redirect URI + + + + + Must include: + - `www` prefix in both fields + - Exact domain used for the app in Create's custom domain settings + - Valid CNAME record for `www` subdomain configured in DNS ([see Custom Domains guide](/publish-and-share/custom-domains#dns-configuration)) + + + + + 1. Create the OAuth Client + 2. Copy the generated Client ID + 3. Save it for adding to your Create project later + + + + + 1. Click the Edit button + 2. Copy the Client Secret + 3. Save it for adding to your Create project later + + + + + 1. Navigate to the Branding section + 2. Add your app domain, privacy policy, and terms + 3. These will appear on the Google Sign In page + + + + + 1. If your app needs additional permissions + 2. Request additional scopes as needed + + + + + + Before going live, submit your app for verification in the Verification Center. + This is required for external Google users to sign in to your app. + + + + +## Add to Create Project + + + + You have two options: + 1. Prompt Create with "Let users sign in" + 2. Enable User Accounts from the logo menu + + + User Accounts must be enabled before proceeding with Google Sign In setup + + + + + 1. Click the 3-dot menu at the top of the chat + 2. Select "Project Settings" + + + + + 1. Navigate to the Authentication section + 2. Find Google Sign In toggle + 3. Make sure it's turned on + + + + + 1. Paste in your Client ID from the previous section + 2. Paste in your Client Secret from the previous section + 3. Click Save to store your credentials + + + + + 1. Return to the chat + 2. Prompt Create with something like "Add Google Sign In as an option" + 3. Create will automatically update your sign-in pages with Google Sign In + 4. You can customize the UI further if you'd like. + + + + + 1. Click the Publish button + 2. Review your changes + 3. Publish to make the Google Sign In feature live + + + + 1. Open your published app in an incognito window + 2. Navigate to the sign-in page + 3. Click the Google Sign In button + 4. Complete the Google authentication flow + 5. Verify you're successfully logged in to your app + 6. Check the user is logged in by looking at the [auth_users table](/builder/databases) in your database + + + Always test the authentication flow in an incognito window to ensure it works for new users + + + + +## Testing + +1. Publish your changes +2. Open your app in a new incognito window +3. Go to the sign in page +4. Try signing in with Google +5. Check the [auth_users table](/builder/databases) to see your new user + +## Troubleshooting + + + - Check if User Accounts is turned on + - Make sure Google Sign In is enabled in Project Settings + - Try publishing your changes again + - Clear your browser data and try in incognito mode + + + + + + - Check that your Client ID and Client Secret are correctly pasted in Create + - Ensure your domain is added as an Authorized JavaScript Origin in Google Cloud + - Verify your app is published and accessible at your custom domain + + In Google Cloud, always use 'www.your-domain.com' not just 'your-domain.com'. Many login problems happen because people forget the 'www'. + + + + + + - Double check your domain is exactly the same in Create and Google Cloud + - Make sure your callback URL is right: `www.[your-domain].com/api/auth/callback/google` + - Check if your Client ID and Secret are pasted correctly + - Make sure your domain is set up in Google Cloud + - Make sure your app is live at your custom domain + + + + - This is normal during testing + - You can test with up to 100 users + - For a live app, you'll need Google to verify it + - Fill out all the info Google asks for + + + + - Update the Authorized JavaScript Origins in Google Cloud + - Update the Authorized redirect URIs in Google Cloud + - Update your domain in the OAuth consent screen + - Re-publish your app on the new domain + + +## FAQ + + + No, Google Sign In needs your own domain. You'll need: + - A domain you own + - Create Pro subscription + - Properly configured DNS records + + + + By default: + - Email address + - Name + - Profile picture (if they have one) + + Additional information requires requesting extra scopes in Google Cloud Console. + + + + Yes! Just: + 1. Go back to chat + 2. Tell Create how you want it to look + 3. Create will help style it while following Google's rules + + + + - For testing (up to 100 users): No + - For a live app: Yes + - Internal Google Workspace apps: No + + + + 1. Go to Google Cloud Console OAuth consent screen + 2. Add additional scopes in the "Scopes" section + 3. Provide justification for each scope + 4. Note: Additional scopes may require Google verification + + +## See Also + +- [User Accounts](/builder/user-accounts) +- [Customizing Login Pages](/builder/user-accounts#customizing-auth-pages) diff --git a/auth/password.mdx b/auth/password.mdx new file mode 100644 index 0000000..369cddb --- /dev/null +++ b/auth/password.mdx @@ -0,0 +1,142 @@ +--- +title: "Email/Password Sign In" +description: "Let users sign in to your app with their email and a password" +--- + +Let users sign in to your app with their email and password. This is Create's default authentication method and requires no external setup. + +## Before You Start + +Make sure you have: + + + A Create project with [User Accounts](/builder/user-accounts) turned on + + +## Overview + + + + Prompt Create to add users, or turn on from logo menu > Settings > User Accounts + + + By default, email/password is enabled. You can turn it off and prompt Create to remove it. + + + Make the login form look how you want + + + Make sure login works + + + +## Turn on / off + + + + 1. Click the 3-dot menu at the top of the chat + 2. Select "Project Settings" + + + + + 1. Navigate to the Authentication section + 2. Find Email/Password Sign In toggle + 3. Make sure it's turned on (or off if you want to remove it) + 4. Tap "Save" + + + + + 1. Return to the chat + 2. Prompt Create with "Add email/password sign in" or "Remove email/password sign in" + 3. Create will update your sign-in pages automatically + + + + 1. Click the Publish button + 2. Review your changes + 3. Publish to make the feature live + + + +## How It Works + +When users sign up with email/password: + +1. The password is securely hashed using bcrypt before storage + +2. The email and hashed password are stored in your database: + - Email in `auth_users.email` + - Hashed password in `auth_accounts.password` + - Account type set to "credentials" + +3. On sign in, Create: + - Hashes the provided password + - Compares it to the stored hash + - Creates a secure session if they match + + + +## Customizing the Form + +You can customize the email/password form through chat: + +``` +Make the sign in form match our brand colors +``` + +``` +Add password requirements text under the password field +``` + +Create will update the form while maintaining the secure authentication logic. + +## Testing + +1. Publish your changes +2. Open your app in a new incognito window +3. Go to the sign in page +4. Try signing up with email/password +5. Check the [auth_users table](/builder/databases) to see your new user + +## Troubleshooting + + + - Check if User Accounts is turned on + - Make sure Email/Password Sign In is enabled in Project Settings + - Try publishing your changes again + - Clear your browser data and try in incognito mode + + + + - Double check the email address is correct + - Make sure you're using the right password + - Try resetting your password (see FAQ below) + - Check the auth_users and auth_accounts tables + + +## FAQ + + + You can manually reset passwords in the database. We're adding support for automated workflows soon. For now: + - Delete the user from the database + - Ask them to sign up again + - Optionally update the new user's ID to match the old ID to maintain data connections + + + + Yes! Just prompt Create with your desired requirements like: + "Make passwords require at least 8 characters with one number" + + It will add validation to the password field. + + + + Yes! Prompt Create to add fields like name or phone number to the sign up form. + + +## See Also + +- [User Accounts](/builder/user-accounts) +- [Customizing Login Pages](/builder/user-accounts#customizing-auth-pages) diff --git a/auth/x.mdx b/auth/x.mdx new file mode 100644 index 0000000..edfb583 --- /dev/null +++ b/auth/x.mdx @@ -0,0 +1,367 @@ +--- +title: "Login with X (Twitter)" +description: "Let users sign in to your app with their X/Twitter account" +--- + +Let users sign in to your app with their X/Twitter accounts. They'll share their username, name, profile picture, and email. + +You'll need to set up a few things in X first, then add those settings to Create. + +## Before You Start + +Make sure you have: + + + A Create project with [User Accounts](/builder/user-accounts) turned on + + + + Your app running on a custom domain through [Create's domain setup](/publish-and-share/custom-domains) + + +## Overview + + + + Create an app in X + + + + Add your X App's Client ID/Secret in Create + + + + Make the page look how you want + + + + Make sure login works + + + +## X Setup + +## + +
+ + `/about` + ) + + * Tell Create what element should lead to the route (e.g. "When clicking the About button, go to the /about page") + + * Create will update the code + + * Publish your app to try it out live + + + + + +## Overview + + + + Sign up and configure your LINE Account Manager, LINE Official Account, and LINE Developer Account. + + + Create a LINE channel and obtain API keys + + + Turn on these settings to have the best experience with LINE + + + Add your credentials to Create's secrets + + + +## Account Setup + + + + Go to https://manager.line.biz/ and sign up with your account + + + + + + Click "Create LINE official account" to continue + + + + + + Once your account is created, you may now visit LINE Developer and click Log in to Console to link your LINE Official Account. + + + + + +## Generate API Credentials + + + + Click on "Create a new provider" to generate a provider for your Channel. + + + + + Now go back to your LINE Official Account Manager. In the top right corner, click on "Setting". Then, on the left panel, select "Messaging API" and "Enable Messaging API". Be sure to select the provider mentioned previously. + + + These credentials grant full access to your LINE channel - keep them private + + + + + Find your webhook URL path in the Page and Function Settings under the Publish button. Copy the URL of your Create project's live site and API path into the webhook URL. + + + + + Input your webhook URL in your LINE Official Account Manager. It should be in the format of https:// your-create-project-url.created.app/api/line-messaging. + + + The function path "api/line-messaging" may be changed as well. If so, you may need to update the function path in your LINE Developer Console to match the function path in your Create project. + + + + + You may copy your Channel Secret Token here as well. + + + + + Get your Channel Access Token by going to your LINE Developer Account > Provider Name > Messaging API > Scroll all the way down + + + + + Enter and save your API tokens in Create + + + + +## Verify Settings + + + + After publishing your project, you may verify your webhook URL by going to your LINE Developer Console > Provider > Channel > Messaging API

+ If you see a success message, your webhook URL is verified. Otherwise, you may need to check your webhook URL/function and try again. + +
+ + + Enable Chatbot Settings by going to your LINE Official Account Manager > Settings(Top Right) > Response Settings + + + + + Allow your chatbot to join group chats by going to your LINE Official Account Manager > Settings(Top Right) > Account Settings + + + +
+ +## Add to Create Project + + + + 1. In your Create project, type `/` in chat + 2. Select "Line" from the menu + + + + 1. Paste Channel Secret into "LINE_CHANNEL_SECRET" + 2. Paste Access Token into "LINE_ACCESS_TOKEN" + + + Need new credentials? Regenerate in LINE Developer Console. + + + + + Use prompts to implement LINE features: + + * `Send order confirmation via /Line` + * `Build a chatbot that uses /Line for customer support` + * `Create a broadcast system with /Line` + + + LINE API has rate limits - implement error handling for best reliability + + + + + + LINE integration complete! Use `/Line` in chat to access messaging capabilities. + + +## Frequently Asked Questions + + + + LINE Messaging API allows you to send messages, build chatbots, and interact with users through LINE's messaging platform. It's particularly popular in Asia and great for customer engagement. + + + + Yes, you need a LINE Business/Developer Account to access the Messaging API. The basic account is free and sufficient for testing and development. + + + + The webhook works by sending LINE encrypted messages to your Create project's function URL when a message is typed in the Line app. This message triggers Function(s) that can send messages back to the user. + + + + You can build: + - Customer service chatbots + - Order notification systems + - Broadcast messaging tools + - Interactive marketing campaigns + - Automated response systems + + + + Yes, LINE has API rate limits and message quotas. Free accounts have lower limits than paid business accounts. Check Line's official documentation for current limits. + + + + Yes, you can test your LINE integration by verifying your webhook URL returns a success message. Followed by talking to your bot on LINE to test the integration. + Additonally, you may test responses from your bot by asking the AI chat to print the response and using the Function test runner. + + diff --git a/integrations/logmeal.mdx b/integrations/logmeal.mdx new file mode 100644 index 0000000..23b7928 --- /dev/null +++ b/integrations/logmeal.mdx @@ -0,0 +1,96 @@ +--- +title: "LogMeal" +description: "Analyze food images with AI" +--- + +LogMeal uses advanced AI to identify and analyze food in images, providing detailed nutritional information. + +## Overview + + + + Sign up for a LogMeal account + + + Generate your LogMeal API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [logmeal.com/](https://logmeal.com/) and click "Sign Up" in the top right corner + + + + + + * Sign up with email/password + * Or continue with Google authentication + + + + + +## Generate API Key + + + + 1. Click on your profile in the top right + 2. Select "API Access" from the menu + + + + + + 1. Copy the generated API key + 2. Store it securely - you won't be able to see it again + + + Keep your API key secure - it grants access to your paid credits + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "LogMeal" from the menu + + + + 1. Paste your API key into the "LOGMEAL_API_KEY" field + + + Need a new key? Generate one in your LogMeal dashboard. + + + + + You can now use prompts with the integration to analyze food images. + + Example prompts: + * `Analyze this food photo with /LogMeal` + * `Get nutritional information for this meal using /LogMeal` + * `Create a food diary that uses /LogMeal for image analysis` + + + Each API call uses one credit - implement caching for frequently analyzed images. + + + Example prompt for optimization: + ``` + When using /LogMeal, cache the analysis results in my database + ``` + + + + + Your LogMeal integration is ready! Use `/LogMeal` in chat to analyze food images. + diff --git a/integrations/luma.mdx b/integrations/luma.mdx new file mode 100644 index 0000000..0a73839 --- /dev/null +++ b/integrations/luma.mdx @@ -0,0 +1,97 @@ +--- +title: "Luma" +description: "Add calendar and event management" +--- + +Luma API enables you to create and manage events, handle registrations, and embed calendar functionality in your app. + Luma requires a Luma Plus premium plan to use their API. Please refer to their pricing [here](https://lu.ma/pricing). + +## Overview + + + + Sign up for a Luma account + + + Generate your Luma API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [lu.ma](https://lu.ma) and click "Sign Up" in the top right corner + + + + + + * Sign up with email/password + * Or continue with Google authentication + + + + +## Generate API Key + + + + 1. Go to your Luma dashboard + 2. Create a Calendar + + + Free tier has rate limits - monitor your usage + + + + + 1. Navigate to "Options" > "API Keys" + 2. Click "Generate New API Key" + 3. Name your key (e.g., "Create Integration") + 4. Copy your API key + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "Luma" from the menu + + + + 1. Paste your API key into the "LUMA_API_KEY" field + + + Need a new key? Generate one in your Luma dashboard. + + + + + You can now use prompts with the integration to manage events and calendars. + + Example prompts: + * `Add a calendar view using /Luma` + * `Create an event registration form with /Luma` + * `Build an event management dashboard using /Luma` + + + API has rate limits - implement caching for frequently accessed events. + + + Example prompt for optimization: + ``` + When using /Luma, cache the event data in my database + ``` + + + + + Your Luma integration is ready! Use `/Luma` in chat to manage events and calendars. + diff --git a/integrations/minimax.mdx b/integrations/minimax.mdx new file mode 100644 index 0000000..d00d1f3 --- /dev/null +++ b/integrations/minimax.mdx @@ -0,0 +1,100 @@ +--- +title: "Minimax" +description: "Integrate Minimax video generation capabilities using Replicate's AI Model Database into your application" +--- + +Minimax provides advanced features for generating videos using AI models from Replicate. + + Replicate requires paid credits to use their API. Please refer to their pricing [here](https://replicate.com/pricing#public-models). + +## Overview + + + + Sign up for a Replicate account. + + + Generate your Replicate API key. + + + Add your credentials to Create's secrets. + + + +## Account Creation + + + + Go to [replicate.com](https://www.replicate.com/) and click "Sign Up" in the top right corner. + + + + + + * Sign up with email/password. + * Or continue with GitHub authentication. + + + + + +## Generate API Key + + + + 1. Click on your profile icon in the top right. + 2. Select "API" from the dropdown menu. + + + + + + 1. Click "Create API Key." + 2. Name your key (e.g., "Minimax Integration"). + 3. Click "Generate." + + + + + + 1. Copy the generated API key. + 2. Store it securely - you won't be able to see it again. + + + Keep your API key secure - it grants access to your paid credits. + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in chat. + 2. Select "Minimax" from the menu. + + + + 1. Paste your API key into "MINIMAX_API_KEY." + + + Need new credentials? Regenerate in the Replicate Developer Portal. + + + + + Use prompts to implement Minimax features: + + * `Generate videos using /Minimax` + * `Create personalized video content with /Minimax` + * `Analyze video data using /Minimax` + + + Minimax API has rate limits - implement error handling for best reliability. + + + + + + Minimax integration complete! Use `/Minimax` in chat to access video generation capabilities. + \ No newline at end of file diff --git a/integrations/moviesdb.mdx b/integrations/moviesdb.mdx new file mode 100644 index 0000000..4c699a0 --- /dev/null +++ b/integrations/moviesdb.mdx @@ -0,0 +1,99 @@ +⁸--- +title: "TMDB - The Movie Database" +description: "Access comprehensive movie and TV show data" +--- + +MovieDB provides detailed information about movies, TV shows, cast, and crew through its extensive entertainment database. + +## Overview + + + + Sign up for a MovieDB account + + + Generate your MovieDB API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [themoviedb.org](https://www.themoviedb.org/) and click "Join TMDb" + + + + + + * Choose username and password + * Verify your email address + + + + +## Generate API Key + + + + 1. Go to your account settings + 2. Navigate to "API" section + + + + + + 1. Click "Create New API Key" + 2. Accept the terms of service + 3. Generate API credential + + + + + + 1. Copy the API key (v3 auth) + 2. Store it securely + + + + Never expose this key in client-side code + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in chat + 2. Select "MovieDB" from the menu + + + + 1. Paste your MovieDB API key into "MOVIEDB_API_KEY" secret + + + Need a new key? Regenerate in your MovieDB API settings. + + + + + Use prompts to access entertainment data: + + * `Show details for The Dark Knight using /MovieDB` + * `Build a movie recommendation app with /MovieDB` + * `Create a TV show watchlist with /MovieDB` + * `Display cast photos for Stranger Things via /MovieDB` + + + API responses are live data - cache results for better performance + + + + + + MovieDB integration complete! Use `/TMDb` in chat to access entertainment data. + diff --git a/integrations/neverbounce.mdx b/integrations/neverbounce.mdx new file mode 100644 index 0000000..e898d57 --- /dev/null +++ b/integrations/neverbounce.mdx @@ -0,0 +1,86 @@ +--- +title: "NeverBounce" +description: "Verify email addresses in real-time" +--- + +NeverBounce helps you validate email addresses to improve deliverability and protect your sender reputation. + +## Overview + + + + Sign up for a NeverBounce account + + + Generate your NeverBounce API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [neverbounce.com](https://neverbounce.com/) and click "Register" in the top right corner + + + + + * Sign up with email/password + * Or continue with Google/GitHub authentication + + + +## Generate API Key + + + + 1. Click on "Integrations" in your navigation bar + 2. Select "Custom Integrations" from the menu + + + Keep your API key secure - it grants full access to your NeverBounce account + + + + + 1. Copy the generated key + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "NeverBounce" from the menu + + + + 1. Paste your NeverBounce API key into the "NEVERBOUNCE_API_KEY" field + + + Need a new key? Generate one in your NeverBounce dashboard. + + + + + You can now use prompts with the integration to validate emails. + + Example prompts: + * `Validate this email list using /NeverBounce` + * `Add email validation to my signup form with /NeverBounce` + * `Clean my contact database with /NeverBounce` + + + NeverBounce charges per validation - implement rate limiting and error handling for production use. + + + + + + Your NeverBounce integration is ready! Use `/NeverBounce` in chat to validate emails. + diff --git a/integrations/nutritionix.mdx b/integrations/nutritionix.mdx new file mode 100644 index 0000000..5a5d89e --- /dev/null +++ b/integrations/nutritionix.mdx @@ -0,0 +1,95 @@ +--- +title: "Nutritionix" +description: "Access nutrition data and food information" +--- + +Nutritionix API provides comprehensive access to nutrition data, food information, and calorie tracking capabilities. + +## Overview + + + + Sign up for a Nutritionix account + + + Generate your Nutritionix API keys + + + Add your API keys to Create's secrets + + + +## Account Creation + + + + Go to [developer.nutritionix.com](https://developer.nutritionix.com/) and click "Sign Up" + + + + + + * Sign up with email/password + * Fill in your developer information + + + + +## Generate API Keys + + + + 1. Go to your Nutritionix dashboard + 2. Navigate to "Applications" + + + Free tier has rate limits - monitor your usage + + + + + 1. Your Application ID and API Key will be displayed + 2. Copy both keys + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "Nutritionix" from the menu + + + + 1. Paste your Application ID into the "NUTRITIONIX_APP_ID" field + 2. Paste your API Key into the "NUTRITIONIX_API_KEY" field + + + Need new keys? Generate them in your Nutritionix dashboard. + + + + + You can now use prompts with the integration to access nutrition data. + + Example prompts: + * `Get nutrition info for an apple using /Nutritionix` + * `Track calories with /Nutritionix` + * `Create a meal planner using /Nutritionix` + + + API has rate limits - implement caching for frequently accessed foods. + + + Example prompt for optimization: + ``` + When using /Nutritionix, cache the nutrition data in my database + ``` + + + + + Your Nutritionix integration is ready! Use `/Nutritionix` in chat to access nutrition data. + diff --git a/integrations/openlibrary.mdx b/integrations/openlibrary.mdx new file mode 100644 index 0000000..c99b5ba --- /dev/null +++ b/integrations/openlibrary.mdx @@ -0,0 +1,65 @@ +--- +title: "OpenLibrary" +description: "Access books and library data" +--- + +OpenLibrary provides access to millions of books, their metadata, and library information. + + OpenLibrary does not require an API key. + + +## Overview + + + + Sign up for an OpenLibrary account + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [openlibrary.org](https://openlibrary.org/) and click "Sign Up" in the top right corner + + + + + + * Sign up with email/password + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "OpenLibrary" from the menu + + + + You can now use prompts with the integration to access book data. + + Example prompts: + * `Search for books about AI with /OpenLibrary` + * `Get details about this book using /OpenLibrary` + * `Create a reading list app with /OpenLibrary` + + + API has rate limits - implement caching for frequently accessed data. + + + Example prompt for optimization: + ``` + When using /OpenLibrary, cache the book details in my database + ``` + + + + + Your OpenLibrary integration is ready! Use `/OpenLibrary` in chat to access book data. + diff --git a/integrations/petfinder.mdx b/integrations/petfinder.mdx new file mode 100644 index 0000000..36a3383 --- /dev/null +++ b/integrations/petfinder.mdx @@ -0,0 +1,107 @@ +--- +title: "Petfinder" +description: "Access pet adoption data and information" +--- + +Petfinder provides access to a comprehensive database of adoptable pets, shelters, and rescue organizations. + +## Overview + + + + Sign up for a Petfinder account. + + + Generate your Petfinder API key. + + + Add your API key to Create's secrets. + + + +## Account Creation + + + + Go to [petfinder.com/developer](https://www.petfinder.com/developer) and click "Sign Up" in the top right corner. + + + + + + * Sign up with email/password. + * Or continue with social media authentication. + + + + If the website isn't logging you in properly, please click "Request Elevated Access". + + + + +## Generate API Key + + + + 1. Log in to your Petfinder account. + 2. Navigate to the Developer Settings section in your account settings. + + + + + + 1. Click "Create API Key." + 2. Name your key (e.g., "Create Integration"). + 3. Click "Generate." + + + + + + 1. Copy the generated API key. + 2. Store it securely - you won't be able to see it again. + + + Keep your API key secure - it grants access to your account data. + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in chat. + 2. Select "Petfinder" from the menu. + + + + 1. Paste your API key into "PETFINDER_API_KEY." + + + Need new credentials? Regenerate in the Petfinder dashboard. + + + + + You can now use prompts with the integration to access pet adoption data. + + Example prompts: + * `Find adoptable pets in my area using /Petfinder` + * `Get details about a specific pet using /Petfinder` + * `Create a pet adoption app with /Petfinder` + + + Petfinder API has rate limits - implement error handling for best reliability. + + + Example prompt for optimization: + ``` + When using /Petfinder, cache the pet details in my database + ``` + + + + + Your Petfinder integration is ready! Use `/Petfinder` in chat to access pet adoption data. + diff --git a/integrations/pexels.mdx b/integrations/pexels.mdx new file mode 100644 index 0000000..84ee5b0 --- /dev/null +++ b/integrations/pexels.mdx @@ -0,0 +1,100 @@ +--- +title: "Pexels" +description: "Add beautiful stock photos" +--- + +Pexels lets you find and use beautiful stock photos in your project. + +## Overview + + + + Sign up for a Pexels account + + + Generate your Pexels API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [pexels.com](https://www.pexels.com/) and click "Join" in the top right corner + + + + + + * Sign up with email/password + * Or continue with Google authentication + + + +## Generate API Key + + + + 1. Click the three-dot menu next to your profile avatar + 2. Select "Images & Video API" from the dropdown + + + + + + 1. Click "Your API Key" button + 2. Generate new token for Create integration + + + + + + + + 1. Copy the generated API key + 2. You can find this key again from your Pexels dashboard + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "Pexels" from the menu and send a messsage + + + + 1. Paste your Pexels API key into the "Pexels API Key" field + + + Need a new key? Contact [Pexels support](mailto:api@pexels.com). + + + + + You can now use prompts with the integration to add stock photos. + + Some examples: + * `Make the homepage banner a photo of a retailer with /Pexels` + * `Find me a photo of a dog playing fetch with /Pexels and add it` + * `Make a gallery of product images with /Pexels` + + + Pexels content is dynamically generated - save image URLs to your + database or component state to persist them between sessions. + + + Example prompt for saving: + ``` + When using /Pexels, save the image URLs to my database + ``` + + + + + Your Pexels integration is now ready! Use the `/Pexels` command in chat to add stock photos. + \ No newline at end of file diff --git a/integrations/pokeapi.mdx b/integrations/pokeapi.mdx new file mode 100644 index 0000000..116fafc --- /dev/null +++ b/integrations/pokeapi.mdx @@ -0,0 +1,51 @@ +--- +title: "PokéAPI" +description: "Access Pokémon data and information" +--- + +PokéAPI provides comprehensive data about Pokémon, including stats, abilities, and evolution chains. + + PokéAPI is free and does not require an API key. + + +## Overview + + + + No account needed + + + Ready to use immediately + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "PokéAPI" from the menu + + + + You can now use prompts with the integration to access Pokémon data. + + Example prompts: + * `Get details about Pikachu using /PokeAPI` + * `Create a Pokédex app with /PokeAPI` + * `List all fire-type Pokemon using /PokeAPI` + + + API has rate limits - implement caching for frequently accessed data. + + + Example prompt for optimization: + ``` + When using /PokeAPI, cache the Pokemon details in my database + ``` + + + + + Your PokéAPI integration is ready! Use `/PokeAPI` in chat to access Pokémon data. + diff --git a/integrations/rentcast.mdx b/integrations/rentcast.mdx new file mode 100644 index 0000000..cc174fe --- /dev/null +++ b/integrations/rentcast.mdx @@ -0,0 +1,97 @@ +--- +title: "Rentcast" +description: "Access real estate and rental market data" +--- + +Rentcast API provides comprehensive access to real estate data, rental market insights, and property analytics. + + Rentcast requires credit card signup for overage fees in the free tier access + +## Overview + + + + Sign up for a Rentcast account + + + Generate your Rentcast API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [rentcast.io/api](https://rentcast.io/api) and click "Start for Free" + + + + + + * Sign up with email/password + * Or continue with Google authentication + + + + +## Generate API Key + + + + 1. Go to your Rentcast dashboard + 2. Scroll down to the "API" section + + + + Free tier has rate limits - monitor your usage + + + + + 1. Click "Generate API Key" + 2. Name your key (e.g., "Create Integration") + 3. Copy your API key + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "Rentcast" from the menu + + + + 1. Paste your API key into the "RENTCAST_API_KEY" field + + + Need a new key? Generate one in your Rentcast dashboard. + + + + + You can now use prompts with the integration to access real estate data. + + Example prompts: + * `Get rental market data for San Francisco using /Rentcast` + * `Analyze property values with /Rentcast` + * `Create a real estate analytics dashboard using /Rentcast` + + + API has rate limits - implement caching for frequently accessed data. + + + Example prompt for optimization: + ``` + When using /Rentcast, cache the market data in my database + ``` + + + + + Your Rentcast integration is ready! Use `/Rentcast` in chat to access real estate data. + diff --git a/integrations/replicate-flux.mdx b/integrations/replicate-flux.mdx new file mode 100644 index 0000000..802a5e1 --- /dev/null +++ b/integrations/replicate-flux.mdx @@ -0,0 +1,91 @@ +--- +title: "Replicate Flux" +description: "Generate images with Replicate's Flux or Flux Pro model" +--- + +Flux is a state-of-the-art text-to-image model from Replicate that generates high-quality images from text descriptions. + + Replicate requires paid credits to use their API. Please refer to their pricing [here](https://replicate.com/pricing#public-models). +## Overview + + + + Sign up for a Replicate account + + + Generate your Replicate API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [replicate.com](https://replicate.com/) and click "Sign Up" + + + + * Sign up with email/password + * Or continue with GitHub authentication + + + + +## Generate API Key + + + + 1. Go to your Replicate dashboard + 2. Click on your profile and select "API Tokens" + + + + + 1. Click "New Token" + 2. Name your token (e.g., "Create Integration") + 3. Copy your API token + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "Replicate Flux" from the menu + + + + 1. Paste your API key into the "REPLICATE_API_KEY" field + + + Need a new key? Generate one in your Replicate dashboard. + + + + + You can now use prompts with the integration to generate images. + + Example prompts: + * `Generate a landscape painting using /ReplicateFlux` + * `Create product mockups with /ReplicateFlux` + * `Build an AI art gallery using /ReplicateFlux` + + + Each generation uses API credits - implement caching for frequently used prompts. + + + Example prompt for optimization: + ``` + When using /ReplicateFlux, cache the generated images in my database + ``` + + + + + Your Replicate Flux integration is ready! Use `/ReplicateFlux` in chat to generate images. + diff --git a/integrations/resend.mdx b/integrations/resend.mdx new file mode 100644 index 0000000..be90c2a --- /dev/null +++ b/integrations/resend.mdx @@ -0,0 +1,97 @@ +--- +title: "Resend" +description: "Add email sending capabilities to your application" +--- + +Resend provides reliable email delivery and tracking for your application's email needs. + + + To send emails from a registered domain, you must verify your domain in Resend.

+ Please follow the official Resend guide [here](https://resend.com/docs/dashboard/domains/introduction). +
+ +## Overview + + + + Sign up for a Resend account + + + Generate your Resend API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [resend.com](https://resend.com/) and click "Get Started" + + + + + + * Sign up with email/password + * Verify your email address + + + + +## Generate API Key + + + + If this is your first time generating an API key, this Get Started page will show.

+ Otherwise, navigate to the API Keys page.

+ 1. Click "Add an API Key" + + +
+ + + 1. Copy the API key + 2. Store it securely + 3. Test the key by sending a test email + + + + This key will only be shown once - save it immediately + + +
+ +## Add to Create Project + + + + 1. In your Create project, type `/` in chat + 2. Select "Resend" from the menu + + + + 1. Paste your Resend API key into "RESEND_API_KEY" secret + + + Need a new key? Regenerate in Resend dashboard. + + + + + Use prompts to implement email features: + + * `Send welcome email to new users with /Resend` + * `Build a password reset flow using /Resend` + * `Create a newsletter system with /Resend` + + + Resend has daily sending limits - monitor usage in their dashboard + + + + + + Resend integration complete! Use `/Resend` in chat to access email capabilities. + diff --git a/integrations/slack.mdx b/integrations/slack.mdx new file mode 100644 index 0000000..2305c90 --- /dev/null +++ b/integrations/slack.mdx @@ -0,0 +1,189 @@ +--- +title: "Slack" +description: "Integrate Slack messaging capabilities into your application" +--- + +Connect your app to Slack's API to send messages, manage channels, and interact with users. + +## Overview + + + + Sign up for a Slack account. + + + Generate your Slack API token. + + + Add your credentials to Create's secrets. + + + +## Account Setup + + + + Go to [api.slack.com](https://slack.com/) and click "Get Started" to create a new workspace. + + + + + + If you already have a workspace, click "Sign In" to access your account. + + + + + + 1. After signing, click "Your Apps" on the homepage. + 2. Click on "Create New App". + + 3. Name your App and choose which workspace you will be installing the slack bot. + + + + +## Slack Alert Bot Setup Guide + +This part will guide you in creating a bot that sends an alert to a specified channel. + + + + 1. Navigate to "Incoming Webhook" in the left sidebar. + 2. Enable "Activate Incoming Webhooks" + 3. Click "Add New Webhook to Workspace" + + + + + Select the channel in your workspace that your bot will send notifications to. + + + + + 1. Copy the generated Slack webhook URL at the bottom of the page. + 2. Paste the URL into your Create project's secrets as SLACK_WEBHOOK. + + + + +## Slack Slash Command Bot Setup Guide + +This part will guide you in creating a bot that uses slash commands. + + + + 1. Once your app is created, navigate to "Basic Information" in the left sidebar. + 2. Under "Signing Secret", copy the necessary key for your bot app. + + + The signing secret is used in the function to verify messages are coming from Slack. + + + +## Verify Settings + + + 1. Navigate to "Event Subscriptions" in the left sidebar, and enable Events. + 2. Enter your Create project's URL into the Request URL. It should follow the example in the picture below. + + 3. Scroll further to find "Subscribe to Bot Events" and add the "message.im" Bot User Event + + + + + 1. Navigate to "App Home" in the left sidebar. + 2. Enable "Show my Bot as Online" and "Allow Users to Send Slash Commands" + + + + + 1. Navigate to "Slash Commands" in the left sidebar. + 2. Click "Create New Command", and name it chatgpt as an example. + + + + + + If you plan on changing the name: + 1. Go into your Create project's code, find the conditional that mentions /chatgpt and change it to whatever slash command you plan to name. + + If you plan on changing the functionality as well, be sure to use the AI Builder to modify it for that slash command + + + + 1. After setting everything up, navigate to the "Install App" in the left sidebar. + 2. Click on "Install to Your Workspace" + + + + + + Try out your App by going into any available channels or DM and type in "/chatgpt" + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in chat. + 2. Select "Slack" from the menu. + + + + 1. Paste your Signing Secret into "SLACK_SIGNING_SECRET." + + + Need new credentials? Regenerate in the Slack API settings. + + + + + Use prompts to implement Slack features: + + * `Send a message to a channel using /Slack` + * `Post a reminder with /Slack` + * `Manage channels with /Slack` + + + Slack API has rate limits - implement error handling for best reliability. + + + + + + Slack integration complete! Use `/Slack` in chat to access messaging capabilities. + + +## Frequently Asked Questions + + + + Slack API allows you to interact with Slack's messaging platform, enabling features like sending messages, managing channels, and more. + + + + Yes, you need a Slack Developer Account to create an app and access the API. + + + + The API works by sending requests to Slack's servers, which process the requests and return the results based on your commands. + + + + You can build: + - Messaging bots + - Notification systems + - Channel management tools + + + + Yes, Slack has API rate limits. Free accounts have lower limits than paid accounts. Check Slack's official documentation for current limits. + + + + Yes, you can test your integration by sending requests to the API and monitoring the responses to ensure it functions as expected. + + diff --git a/integrations/spotify.mdx b/integrations/spotify.mdx new file mode 100644 index 0000000..faf4668 --- /dev/null +++ b/integrations/spotify.mdx @@ -0,0 +1,106 @@ +--- +title: "Spotify" +description: "Access music, playlists, and user data" +--- + +Spotify API provides access to millions of songs, playlists, and user listening data. + +Spotify API requires a Spotify premium account + +## Overview + + + + Sign up for a Spotify Developer account + + + Generate your Spotify API credentials + + + Add your API keys to Create's secrets + + + +## Account Creation + + + + Go to [developer.spotify.com](https://developer.spotify.com/) and click "Dashboard" + + + + + + * Log in with your Spotify account + + + + * Click "Create App" in the dashboard + + + + * Fill in app name and description + * The redirect uri will be your create project live site url + /api/callback + + + + +## Generate API Keys + + + + 1. Go to your app settings + 2. Find your Client ID and Client Secret + + + Keep your Client Secret secure and never share it + + + + + This step is only relevant if you use the Spotify User Info + 1. Be sure your project is published + 2. Ensure there is a callback path in your page and functions setting + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "Spotify" from the menu + + + + 1. Paste your Client ID into the "SPOTIFY_CLIENT_ID" field + 2. Paste your Client Secret into the "SPOTIFY_CLIENT_SECRET" field + + + Need new credentials? Generate them in your Spotify Developer dashboard. + + + + + You can now use prompts with the integration to access music data. + + Example prompts: + * `Get user's playlists using /Spotify` + * `Search for songs with /Spotify` + * `Create a music player using /Spotify` + + + API has rate limits - implement caching for frequently accessed data. + + + Example prompt for optimization: + ``` + When using /Spotify, cache the track data in my database + ``` + + + + + Your Spotify integration is ready! Use `/Spotify` in chat to access music data. + diff --git a/integrations/tavus.mdx b/integrations/tavus.mdx new file mode 100644 index 0000000..b510697 --- /dev/null +++ b/integrations/tavus.mdx @@ -0,0 +1,105 @@ +--- +title: "Tavus" +description: "Create personalized AI video content" +--- + +Tavus API enables creation of personalized AI-generated video content at scale. + +## Overview + + + + Sign up for a Tavus account + + + Generate your Tavus API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [tavus.io](https://tavus.io/) and click "Sign Up" + + + + + + * Sign up with email/password + * Or continue with Google authentication + + + + +## Generate API Key + + + + 1. Go to your Tavus dashboard + 2. Navigate to "API Settings" + + + Free tier has rate limits - monitor your usage + + + + + 1. Click "Create a New Key" + 2. Name your key (e.g., "Create Integration") + 3. Copy your API key + + + + + 1. Go to "Replica Library" in your left side dashboard + 2. Select the stock replica or personal replica you want to use as a template + 3. Click "Copy Replica ID" or find it in the video's URL + + + The Replica ID is needed to generate variations of your video template + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "Tavus" from the menu + + + + 1. Paste your API key into the "TAVUS_API_KEY" field + + + Need a new key? Generate one in your Tavus dashboard. + + + + + You can now use prompts with the integration to create AI videos. + + Example prompts: + * `Generate a personalized video using /Tavus` + * `Create video variations with /Tavus` + * `Build a video message system using /Tavus` + + + API has rate limits - implement caching for frequently used videos. + + + Example prompt for optimization: + ``` + When using /Tavus, cache the generated videos in my database + ``` + + + + + Your Tavus integration is ready! Use `/Tavus` in chat to create AI videos. + diff --git a/integrations/tenor.mdx b/integrations/tenor.mdx new file mode 100644 index 0000000..88e3642 --- /dev/null +++ b/integrations/tenor.mdx @@ -0,0 +1,89 @@ +--- +title: "Tenor" +description: "Access GIFs and animated content" +--- + +Tenor API provides access to millions of GIFs and animated content through their comprehensive search API. + +## Overview + + + + Sign up for a Google Cloud account + + + Generate your Tenor API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [https://tenor.com/gifapi](https://tenor.com/gifapi) and click "Documentation" + + + + + + * Scroll down to the Setup section + * Click "Sign In with Google Cloud" + + + + +## Generate API Key + + + + 1. Click "Get a Tenor API Key" + 2. Create a project or select an existing one + 3. Copy your API key + + + Keep your API key secure and set usage limits + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "Tenor" from the menu + + + + 1. Paste your API key into the "TENOR_API_KEY" field + + + Need a new key? Generate one in your Google Cloud Console. + + + + + You can now use prompts with the integration to access GIFs. + + Example prompts: + * `Find reaction GIFs using /Tenor` + * `Add animated stickers with /Tenor` + * `Create a GIF picker using /Tenor` + + + API has rate limits - implement caching for frequently accessed GIFs. + + + Example prompt for optimization: + ``` + When using /Tenor, cache the GIF URLs in my database + ``` + + + + + Your Tenor integration is ready! Use `/Tenor` in chat to access GIFs. + diff --git a/integrations/ticketmaster.mdx b/integrations/ticketmaster.mdx new file mode 100644 index 0000000..680ded6 --- /dev/null +++ b/integrations/ticketmaster.mdx @@ -0,0 +1,94 @@ +--- +title: "Ticketmaster" +description: "Access events and venue data" +--- + +Ticketmaster Discovery API provides comprehensive access to events, venues, and ticket information worldwide. + +## Overview + + + + Sign up for a Ticketmaster Developer account + + + Generate your API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [developer.ticketmaster.com](https://developer.ticketmaster.com/) and click "Create an Account" + + + + + + * Sign up with email/password + * Or continue with Google authentication + + + +## Generate API Key + + + + 1. Go to your Ticketmaster Developer dashboard + 2. Navigate to the "Applications" section + + + Free tier has rate limits - monitor your usage + + + + + 1. Name your application + 2. Select "Discovery API" access + 3. Copy your Consumer Key (API Key) + + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "Ticketmaster" from the menu + + + + 1. Paste your API key into the "TICKETMASTER_API_KEY" field + + + Need a new key? Generate one in your Ticketmaster Developer dashboard. + + + + + You can now use prompts with the integration to access event data. + + Example prompts: + * `Find upcoming concerts using /Ticketmaster` + * `Get venue details with /Ticketmaster` + * `Create an event discovery app using /Ticketmaster` + + + API has rate limits - implement caching for frequently accessed data. + + + Example prompt for optimization: + ``` + When using /Ticketmaster, cache the event details in my database + ``` + + + + + Your Ticketmaster integration is ready! Use `/Ticketmaster` in chat to access event data. + diff --git a/integrations/weather.mdx b/integrations/weather.mdx new file mode 100644 index 0000000..19e3b49 --- /dev/null +++ b/integrations/weather.mdx @@ -0,0 +1,93 @@ +--- +title: "Weather" +description: "Access real-time weather data and forecasts" +--- + +Get detailed weather information and forecasts for any location worldwide using OpenWeatherMap's API. + +## Overview + + + + Sign up for an OpenWeatherMap account + + + Generate your API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [openweathermap.org](https://openweathermap.org/) and click "Sign Up" in the top right corner + + + + + + * Sign up with email/password + * Or continue with Google authentication + + + +## Generate API Key + + + + 1. Go to your OpenWeatherMap dashboard + 2. Navigate to the "API keys" tab + + + New API keys may take a few hours to activate + + + + + 1. Name your key (e.g., "Create Integration") + 2. Click "Generate" + 3. Copy your API key + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "Weather" from the menu + + + + 1. Paste your API key into the "OPENWEATHERMAP_API_KEY" field + + + Need a new key? Generate one in your OpenWeatherMap dashboard. + + + + + You can now use prompts with the integration to access weather data. + + Example prompts: + * `Show the weather forecast using /Weather` + * `Build a travel planner with /Weather` + * `Create a sports event scheduler using /Weather` + + + API has rate limits - implement caching for frequently accessed locations. + + + Example prompt for optimization: + ``` + When using /Weather, cache the forecast data in my database + ``` + + + + + Your Weather integration is ready! Use `/Weather` in chat to access weather data. + diff --git a/integrations/yelp.mdx b/integrations/yelp.mdx new file mode 100644 index 0000000..316198c --- /dev/null +++ b/integrations/yelp.mdx @@ -0,0 +1,95 @@ +--- +title: "Yelp" +description: "Access business data and reviews" +--- + +Yelp provides access to millions of business listings, reviews, and ratings through their Fusion API. + +## Overview + + + + Sign up for a Yelp Developer account + + + Generate your Yelp API key + + + Add your API key to Create's secrets + + + +## Account Creation + + + + Go to [yelp.com/developers](https://www.yelp.com/developers) and click "Log In" + + + + + + * Sign up using the link sent to your email + + + + +## Generate API Key + + + + 1. Go to the Yelp Fusion dashboard + 2. Click "Create New App" + 3. Fill in your app details + + + + Keep your API key secure - it grants access to your Yelp API quota + + + + + + 1. Copy the generated API key + 2. Store it securely + + + +## Add to Create Project + + + + 1. In your Create project, type `/` in the chat + 2. Select "Yelp" from the menu + + + + 1. Paste your API key into the "YELP_API_KEY" field + + + Need a new key? Generate one in your Yelp Developers dashboard. + + + + + You can now use prompts with the integration to access business data. + + Example prompts: + * `Find restaurants near me using /Yelp` + * `Get business reviews with /Yelp` + * `Create a local business directory with /Yelp` + + + API has rate limits - implement caching for frequently accessed data. + + + Example prompt for optimization: + ``` + When using /Yelp, cache the business details in my database + ``` + + + + + Your Yelp integration is ready! Use `/Yelp` in chat to access business data. + diff --git a/mint.json b/mint.json index 6ff0fd1..de29ce2 100644 --- a/mint.json +++ b/mint.json @@ -69,7 +69,8 @@ "builder/functions", "builder/databases", "builder/user-accounts", - "builder/uploads" + "builder/uploads", + "stripe" ] }, { @@ -117,9 +118,6 @@ "thumbsRating": true, "suggestEdit": true }, - "metadata": { - "og:image": "/images/og.png" - }, "redirects": [ { "source": "/create/getting-started/builder-basics", @@ -173,6 +171,14 @@ "source": "/create/quick-tips/connect-to-external-apis", "destination": "/quick-tips/external-apis" }, + { + "source": "/builder/databases-v2", + "destination": "/builder/databases" + }, + { + "source": "/builder/user-accounts-v2", + "destination": "/builder/user-accounts" + }, { "source": "/create/builder-add-ons/:slug*", "destination": "/builder/:slug*" diff --git a/prompting.mdx b/prompting.mdx index 3c65a61..e8f64e0 100644 --- a/prompting.mdx +++ b/prompting.mdx @@ -137,6 +137,18 @@ When I hit the 'manage teachers' button [screenshot] it should take me back to [ If you see a error message, you can often just paste it back into the chat to give Create more context. +### Using previous versions + +When you generate something new, Create has knowledge of your previous versions. + +You can sometimes be specific on what you liked about previous versions to bring that functionality back. + +``` +In a previous version, the paste image when the page was selected worked. It's now not working. + +Figure out how to bring that back. +``` + ### Avoid "too long" → break into components As your project grows long, Create can sometimes have a harder time making changes. You can combat this by breaking your project into more elements ([components](/builder/components), [functions](/builder/functions), etc). diff --git a/publish-and-share/custom-domains.mdx b/publish-and-share/custom-domains.mdx index 09e7f7c..a439843 100644 --- a/publish-and-share/custom-domains.mdx +++ b/publish-and-share/custom-domains.mdx @@ -19,10 +19,13 @@ A custom domain lets you use your own web address (like `yourapp.com`) instead o * Have an app ready to publish -**Important timing notes:** -- DNS changes can take up to 48 hours to take effect -- During this time, your domain might not work or might show old content -- If it's been 48 hours since you'd added records and published your domain, reach out for support + **Important timing notes:** + + * DNS changes can take up to 48 hours to take effect + + * During this time, your domain might not work or might show old content + + * If it's been 48 hours since you'd added records and published your domain, reach out for support ## How it works @@ -33,9 +36,11 @@ When someone visits your domain: Your domain provider checks its DNS records + The records point visitors to Create's servers + Create routes visitors to your published app @@ -49,11 +54,13 @@ DNS records are like an address book for the internet. They tell browsers where [Publish](/publish-and-share/publish) your Create app + - Select "Publish to a custom domain" in the Publish modal + Select "Publish to a custom domain" in the Publish modal - - Add these DNS records at your domain provider: + + + Add these DNS records ***at your domain provide***r: ``` Type: A @@ -70,13 +77,13 @@ DNS records are like an address book for the internet. They tell browsers where -**Using a subdomain?** For addresses like `app.your-domain.com`, just add one record: + **Using a subdomain?** For addresses like `app.your-domain.com`, just add one record: -``` -Type: A -Name: subdomain-name (e.g., "app") -Value: 76.76.21.21 -``` + ``` + Type: A + Name: subdomain-name (e.g., "app") + Value: 76.76.21.21 + ``` ## Provider-specific setup @@ -91,18 +98,26 @@ Value: 76.76.21.21 + Select `A` for the record type and set `76.76.21.21` for the value. + + Create another record like in Step 1 + Create another record with: - - Type: `CNAME` - - Value: `cname.vercel-dns.com` - - Subdomain: `www` + + * Type: `CNAME` + + * Value: `cname.vercel-dns.com` + + * Subdomain: `www` + @@ -110,6 +125,7 @@ Value: 76.76.21.21 Your final configuration should look like this: + @@ -128,13 +144,16 @@ Value: 76.76.21.21 + + Add both the A and CNAME records as shown: + @@ -142,6 +161,7 @@ Value: 76.76.21.21 Your final configuration should look like this: + @@ -154,9 +174,11 @@ Value: 76.76.21.21 Access the Publish settings for your app + Click "Remove domain" next to your custom domain + Remove the DNS records from your domain provider @@ -164,4 +186,4 @@ Value: 76.76.21.21 ## Need help? -Email customers@create.xyz for support with domain setup. +Email [customers@create.xyz](mailto:customers@create.xyz) for support with domain setup. \ No newline at end of file diff --git a/stripe.mdx b/stripe.mdx index 04fd89e..67228a3 100644 --- a/stripe.mdx +++ b/stripe.mdx @@ -1,12 +1,8 @@ --- -title: "Stripe Subscriptions (Beta)" -description: "Set up subscription payments for your app" +title: "Payments" +description: "Set up subscription payments for your app with Stripe" --- - - This is a beta feature. We're improving it before general release. For now, it requires manual set up. Contact dhruv@create.xyz or join our [Discord](www.create.xyz/discord) for help. - - Stripe lets you set up payments for your app so you can charge users for access or features. Our new integration helps set it up in minutes. It lets you: @@ -38,7 +34,7 @@ Here's what your user flow will look like once set up: 2. User signs in with [User Accounts](/builder/user-accounts) 3. User sees: - Free tier app with your paid upgrade upsell OR - - Upsell required from start for access + - Payment required from start for access 4. User goes through upsell to buy a subscription: - Redirected to Stripe checkout - Fills in payment details in Stripe's UI @@ -184,6 +180,18 @@ This component gives you an upsell UI that will redirect users to Stripe to chec You can style this component and add it to the right places in your app. +Prompt examples + +In the component chat: +``` +Style this upsell to look like the rest of the app: [screenshot]. Call out that Pro is $10/month and say it gives you unlimited generations. +``` + +In another page: +``` +Use /[Subscription Upsell] in the dashboard if the user is not subscribed. +``` + #### Stripe Webhook This [function](/builder/functions) listens for successful payments and subscription updates. @@ -199,9 +207,9 @@ You won't need to modify this besides adding your STRIPE_WEBHOOK_SECRET as a sec Learn how to get your STRIPE_WEBHOOK_SECRET in the [Add Stripe Webhook and STRIPE_WEBHOOK_SECRET](#add-stripe-webhook-and-stripe_webhook_secret) section below. -#### Check Subscription Wrapper +#### useIsSubscribed -Component for gating premium content based on the user's subscription status. +Component that handles checking the signed in user's subscription status. You can use it gate features / access for paid members. - Shows/hides content based on subscription status - Checks subscription status for current user in your [users database](/builder/user-accounts) @@ -212,16 +220,17 @@ You can use this component when describing things you only want paid users to se Prompt examples ``` -Use /[Check Subscription Wrapper] to hide the generations remaining counter for users that are subscribed" +Use /[useIsSubscribed] to only show the /[Subscription Upsell] for free users. Hide it for paid users." ``` ``` -If the user is subscribed, show the extra content for pro members using /[Check Subscription Wrapper]" +If the user is subscribed, show the extra content for pro members with /[useIsSubscribed]" ``` ### Set up your Stripe product -You'll make a product and price in Stripe for your subscription. You'll copy the STRIPE_PRICE_ID from Stripe to use in your Create app. +You'll make a product and price in Stripe for your subscription. +You'll copy the STRIPE_PRICE_ID from Stripe to use in your Create app. #### Make product, price, and get STRIPE_PRICE_ID @@ -270,12 +279,15 @@ You'll make a product and price in Stripe for your subscription. You'll copy the - + + + Add STRIPE_PRICE_ID as the name. + Add the price ID you copied from Stripe as the value. @@ -347,7 +359,7 @@ You'll make a product and price in Stripe for your subscription. You'll copy the - Go to 3 dots > Secrets > Add a Secret + Go to [3 dots menu](/builder/controls#3-dot-menu) > Secrets > Add a Secret @@ -355,19 +367,54 @@ You'll make a product and price in Stripe for your subscription. You'll copy the -### Hooking Up the Elements to Your App +### Hooking up the payment flow + +You now can build: + +1. How your users pay you +2. What happens before they pay and after they pay -You now can build your flows. + + You can add the [Subscription Upsell](#subscription-upsell) and [useIsSubscribed](#useissubscribed) [components](/builder/components) to other parts of your app the same as other [components](/builder/components). + + Press / in the chat > Components > [name]. Then describe how you want to use it. + + + Tap on the Subscription Upsell component. + + Prompt Create to make it look how you want. + + Before styling: + + + + After styling with prompts: + + + + + - Add the Subscription Upsell component where you want the subscribe button + Add the Subscription Upsell component where you want to show users your upsell to pay. + + Use / to add it in the chat. + + - + Prompt Create to use this component when you want to control access to features based on the user's subscription status. + + Use / to add it in the chat. + + For example, "Use /[useIsSubscribed] If the user is free, then show them the [Subscription Upsell]. If they've paid, then show them the paid content" + + + When you publish, be sure to toggle your Stripe Checkout Link function & Stripe Webhook function to on. @@ -379,13 +426,31 @@ You now can build your flows. Run through your flow in your published app. - 1. Verify when you hit subscribe, you're redirected to Stripe + 1. Verify when you hit the button in the Subscription Upsell, you're redirected to Stripe 2. After paying, you should be redirected back to your app 3. Check in your users database to see that the signed in user is marked as subscribed - 4. After the user is subscribed, make sure the right content is shown to them + + + You can find your Users Database for your project quickly by: + + - Tap on the Sign In page in the builder > in the panel on the left > tap database + + + + - You should see that the user you signed in with is marked as "active" in the subscription status column + + + + + + 4. After the user is subscribed, make sure the right content is shown to them. + + + If you're not seeing the right content shown to free vs. paid users, use the [useIsSubscribed](#useissubscribed) component. + - You can use a real card to test the flow. If needed, you can easily refund the payment from your Stripe dashboard. + You can use a real card to test the flow. If needed, you can refund the payment from your Stripe dashboard.