PaletteForge

An iOS app built with Swift in Xcode that lets you create and save custom colour palettes and gradients. Whether you’re a designer, developer, or just love exploring new colour schemes, this app provides an easy and intuitive way to generate and store beautiful combinations.

Table of Contents

• Features
• Requirements
• Installation
• Usage
• Contributing
• Licence

Features

• Palette Generation: Quickly generate harmonious colour palettes using colour theory principles.
• Gradient Generation: Produce multi-colour gradients for backgrounds, buttons, and other UI elements.
• Favourites/Saved: Save your favourite palettes and gradients for later use.
• AI Generation: Experiment with AI-based colour suggestions (planned feature).
• Export: (Optionally describe how you can export these palettes, if supported.)

Requirements

• Xcode 16.1+ (recommended: the latest version)
• Swift 6.0.3+
• iOS 18.2.1+ (or adapt as needed)

Installation

1. Clone this repo
   bash git clone https://github.com/1995th/PaletteForge.git
   cd Colour-Tools

2. Open in Xcode

   • Double-click on `ColourTools.xcodeproj` (or `.xcworkspace` if you use Swift Package Manager or CocoaPods).
   • Wait for Xcode to index the project.

3. Build and Run

   • Select an iOS simulator or a connected device.
   • Click the Play button in Xcode’s toolbar or press `Cmd + R` to build and run the app.

Usage

1. Generating Palettes: Tap Generate under “Palettes” to create new sets of colours based on various colour theory principles.
2. Generating Gradients: Switch to the Gradients tab, then tap Generate to explore different gradient combinations.
3. Saving: You can save any palette or gradient you create by tapping the heart icon. Access your saved combinations under the Saved tab.

Contributing

Contributions are welcome! If you’d like to contribute, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix: ```bash git checkout -b feature/some-feature ```
3. Commit your changes: ```bash git commit -m 'Add some new feature' ```
4. Push to the branch: ```bash git push origin feature/some-feature ```
5. Create a Pull Request.

Please make sure your code follows best practices and is well-documented.

Licence

Distributed under the MIT Licence. See LICENCE for more information.

---

If you find it helpful, consider giving this repo a star ⭐. If you run into issues or have ideas for enhancements, feel free to open an issue.