Git Product home page Git Product logo

design-blocks's Introduction

Price npm CDNJS GitHub package version License: FOWDL v1.0

Over 170 responsive design blocks ready to be used in your web or mobile apps. All blocks are based on the Bootstrap Library, and they are the building blocks for beautiful websites.

Discuss it on Product Hunt 🦄

Design Blocks Builder »

WYSIWYG HTML Editor · Pages · Blog · Download

Design Blocks

Table of contents

Quick start

  1. Download Froala Design Blocks. There are several ways to start using the Froala Design Blocks depending on how you prefer:
  1. Design Blocks Skeleton. You can use the following code layout as a starting point.

    <!DOCTYPE html>
    <html>
      <head>
        <title>Froala Design Blocks - Skeleton</title>
        <meta name="viewport" content="width=device-width, height=device-height, initial-scale=1.0">
        <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-PsH8R72JQ3SOdhVi3uxftmaW6Vc51MKb0q5P2rRUpPvrszuE4W1povHYgTpBfshb" crossorigin="anonymous">
        <link href="https://fonts.googleapis.com/css?family=Roboto:100,100i,300,300i,400,400i,500,500i,700,700i,900,900i" rel="stylesheet">
        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.css">
        <link type="text/css" rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/froala-design-blocks/2.0.1/css/froala_blocks.min.css">
      </head>
    
      <body>
          <!-- Insert HTML for contents. -->
      </body>
    </html>    
  2. Add design blocks. Once you have the Froala Design Blocks basic HTML structure in place, start browsing the design blocks that you want to use and copy/paste the HTML for them.

Implementations

What's included

Within the download archive you'll find the following directories and files, logically grouping common assets and providing both compiled and minified variations. You'll see something like this:

design-blocks/
├── dist/
│   ├── css/
│   │   ├── froala_blocks.css
│   │   └── froala_blocks.min.css
│   └── imgs/
│   │── call_to_action.html
│   │── contacts.html
│   │── contents.html
│   │── features.html
│   │── footers.html
│   │── forms.html
│   │── headers.html
│   │── index.html
│   │── pricings.html
│   │── teams.html
│   └── testimonials.html
├── assets/
├── screenshots/
└── src/

We provide compiled CSS (froala_blocks.css), as well as compiled and minified CSS (froala_blocks.min.css). Also, in the downloaded archive you will find useful images and PSD files that you can use to create new backgrounds. In the screenshots folder, there are the screenshots of all design blocks.

Dependencies

  • Bootstrap. Froala Design Blocks is built on Bootstrap 4 library and fully supports it. It uses the Javascript files only for the header design blocks, so if you don't need them, we recommend not to include the Bootstrap JS files in order to reduce your bundle size.

  • Font Awesome. We're using the amazing Font Awesome library for the social network icons.

  • Google Fonts. By default, the Design Blocks toolkit is built using the Roboto font, however that can easily be changed to other fonts.

Categories

Browser Support

At the moment, we aim to support all major web browsers. Any issue in the browsers listed below should be reported as a bug:

  • Internet Explorer 10+
  • Microsoft Edge 14+
  • Safari 6+
  • Firefox (Current - 1) and Current versions
  • Chrome (Current - 1) and Current versions
  • Opera (Current - 1) and Current versions
  • Safari iOS 7.0+
  • Android 6.0+

(Current - 1) and Current means that we support the current stable version of the browser and the version that precedes it.

Bugs and feature requests

Have a bug or a feature request? Please first read the issue guidelines and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.

Community

Get updates on Froala Design Blocks' development and chat with the project maintainers and community members:

Contributing guidelines

All contributions are more than welcomed. Contributions may close an issue, fix a bug (reported or not reported), add new design blocks, improve the existing code, add new feature, and so on. In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation. Read the full Code of Conduct.

The dev branch is the default and base branch for the project. It is used for development and all Pull Requests should go there. Please make sure not to commit the dist folder in the dev branch.

Development

The project needs to be compiled, therefore the files in the src folder are those we'll be developing on. Don't make changes in the dist or demo folders as they will be overwritten when src is compiled.

  1. Get code
git clone [email protected]:froala/design-blocks.git
cd design-blocks
  1. Install dependencies and run project
npm install
npm run start

With the gulp server running, the project is available at the following address localhost:8001. The src files are automatically compiled when changes have been made.

Versioning

Through the development of new versions, we're going use the Semantic Versioning: https://docs.npmjs.com/getting-started/semantic-versioning. Example: 1.0.0.

  • Major release: increment the first digit and reset middle and last digits to zero. Introduces major changes that might break backward compatibility. E.g. 2.0.0
  • Minor release: increment the middle digit and reset last digit to zero. It would fix bugs and also add new features without breaking backward compatibility. E.g. 1.1.0
  • Patch release: increment the third digit. It would fix bugs and keep backward compatibility. E.g. 1.0.1

Contributors

Special thanks to everyone who contributed to getting the Froala Design Blocks to the current state. 🙏

Copyright and License

Code and documentation copyright 2018 Froala Labs. Code released under the Froala Open Web Design License.

Graphics license:

  • shapes: free to use by Creative Tim
  • photos: free under the creative license from Pexels
  • illustrations: free under the creative license from Undraw
  • icons: free under MIT license FeatherIcons

design-blocks's People

Contributors

abhijithvijayan avatar alexandru-paduraru avatar dakshshah96 avatar dianaprajescu avatar flowonyx avatar m5o avatar peppertom avatar postgetme avatar reckseidlerdesign avatar riyadhalnur avatar stefanneculai avatar zouxuoz avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

design-blocks's Issues

A11y Accessibility valid markup

Not a single form field has a label. These designs are not usable and the patterns presented should be discouraged.

I suggest adding a validation check like Nu Validator, aXe, lighthouse, etc. to show all the places this markup is invalid.

Relative path issue on my Mac

Hello folks,
I download the zip. From /dist I tried the HTML files. Everything was broken.

I went in the code and I saw:
<link type="text/css" rel="stylesheet" href="../css/froala_blocks.css">

I changed it to:
<link type="text/css" rel="stylesheet" href="./css/froala_blocks.css">

and it worked. I did the same thing for the img paths.

It's the first time I tried a bootstrap library that brakes like this.

What should be the standard? ../css/froala_blocks.css"> or ./css/froala_blocks.css">

Cheers!

New Block Types

A list of design blocks to be added shortly:

  • Blog Posts
  • Blog Feeds
  • Gallery
  • Portfolio
  • Sliders

License discussion

Hello,

I've noticed that this project uses a custom license.

Unfortunately, not only custom licenses can be a barrier to adoption in some places (such as corporate environments), but this particular license also doesn't follow the Free Software Definition and the Open Source Definition, since it restricts the permitted use cases (among other issues).

It could also be argued that commercial use is not necessarily unethical.

Would you please consider switching to an open source license?

Vue components

Create Vue components to ease the integration with Vue based apps.

License not compatible with GPL

Reading through the license it does not seem to be compatible with the GPL license - is this intentional and a correct assumption?

Any reason why the work was not released under the terms of GPL or a compatible license like MIT?

Build when installed with npm

In the quickstart, it says one of the options is to:

Install with npm: npm install froala-design-blocks

But it is not obvious how to then use it to build your project.

Overall, the documentation seems lacking; when trying it out with a fresh clone, the best I could figure to do was copy-paste from the various block files into the index.html file. Is that the intended use?

[Suggestion] Web Components

Hi, i suggest you to switch the entire library to web components... no dependencies, framework agnostic, maintainable, css encapsulation, native and responsive design blocks ready to be used in your web or mobile apps for real.

Document "Unexpected token" error caused in node versions < 7

While running the code for the first time after clone and npm install, I got the following error

/home/neo/open-source-dev/design-blocks/utils/index.js:23
async function makeScreenshotsByName(name, selector) {
      ^^^^^^^^

SyntaxError: Unexpected token function
    at createScript (vm.js:56:10)
    at Object.runInThisContext (vm.js:97:10)
    at Module._compile (module.js:542:28)
    at Object.Module._extensions..js (module.js:579:10)
    at Module.load (module.js:487:32)
    at tryModuleLoad (module.js:446:12)
    at Function.Module._load (module.js:438:3)
    at Module.require (module.js:497:17)
    at require (internal/module.js:20:19)
    at Object.<anonymous> (/home/neo/open-source-dev/design-blocks/gulpfile.js:8:13)

This was being caused as I have node 6.11.5, which does not support async.

I feel like this must be documented and alternatives such as transpiling the code using babel must be noted in the readme.

Install not working

Hello all, I am new to Github and this is my first time installing a software using it. I followed ll the steps and I dont see to get it to install on my mac. I run the install on Terminal and I get this:

npm WARN enoent ENOENT: no such file or directory, open '/Users/PixarMediaMac/package.json'
npm WARN PixarMediaMac No description
npm WARN PixarMediaMac No repository field.
npm WARN PixarMediaMac No README data
npm WARN PixarMediaMac No license field.

I see a "Node_modules" folder on my mac but that does not open a software.

Thank you all.

Gulp Error

Got this error after following instructions:

design-blocks/utils/index.js:23
async function makeScreenshotsByName(name, selector) {
^^^^^^^^

SyntaxError: Unexpected token function
at createScript (vm.js:56:10)
at Object.runInThisContext (vm.js:97:10)
at Module._compile (module.js:542:28)
at Object.Module._extensions..js (module.js:579:10)
at Module.load (module.js:487:32)
at tryModuleLoad (module.js:446:12)
at Function.Module._load (module.js:438:3)
at Module.require (module.js:497:17)
at require (internal/module.js:20:19)
at Object. (/Users/victorramirez/Desktop/Thinkful-2017/design-blocks/gulpfile.js:8:13)

Not displaying properly?

So I downloaded the latest release, and when I open any .html file from the dist folder it displays like this - is it normal? Seems like it isn't:

screenshot_1

screenshot_2

I use Google Chrome.

Angular components

Create Angular components to ease the integration with React based apps.

minify version

Hi,
In the readme, we can see:

design-blocks/
├── dist/
│   ├── css/
│   │   ├── froala_blocks.css
│   │   └── froala_blocks.min.css

But in the zip file, I downloaded froala_blocks.min.css is not there. I don't mind creating the min.css myself but the readme is not representing the tree.

Cheers!

[Suggestion] PUG

You should move each component into a .pug file and import / compile everything into a single .html document. That way people can install from NPM and require in the .pug components they want. This would be cleaner and upgradable with versions as you move forward.

Also side note this would satisfy the Vue community who use vue-loader

Automate screenshot taking process

Currently, there is a script which can be used to take screenshots, however the process is quite painful because each file should be saved manually. We're using the dom-to-image library to take the screenshots, but Font Awesome and Google Maps do not render correctly.

Ideally, we'd have a script which used PhantomJS or JSDom to make the screenshots without opening the browser.

Some design blocks need review

  • problem with icons on mobile in content with “works in every browser”
  • problem with client logos in CTA on mobile
  • content with col-fill-left has a problem on mobile
  • problem with footer 3 on xs
  • problem with some headers on small screens

RTL Support

(Please excuse my poor English as I'm not a native speaker :) )

So I opened this issue to sort of explain what I'm working on in a Pull Request I'm going to push soon.

RTL support is already at a great level on the CSS level which is awesome! However the framework depends on Bootstrap which is famously known for ditching RTL support despite continuous efforts from the community to add it. So there are many additional Bootstrap plugins adding RTL which is nice, however most maintainers get tired and those plugins get outdated fast.

So the solution I came up with was to ditch horizontal gravity classes that are coming from bootstrap and replace them with dynamic classes.

Let me explain:

Basically horizontal gravity classes are the ones ending with -left and -right, and their job in bootstrap is solely add text-align:left and its counterpart. They come in different sizes and shapes like text-left, text-sm-left, text-lg-left, etc...
I am not sure why do they have multiple names since their job is to add the one same line of code that is of text-align.

So, I removed those from the HTML and replaced them with the dynamic gravity classes. Those are ones that has start and end keywords. The idea is inspired from CSS3 spec that advises to use start and end keywords instead of left and right because they add better RTL support. How?

Well, left will always be left in LTR and RTL contexts, however the keyword start in LTR refers to the left side of the screen, while refers to the right side in case of RTL (since RTL is a right-to-left script language). and vice versa with the end keyword.

There's a little more to it so I'll update this issue as I make progress and when ultimately pushing a PR.

Thanks

React components

Create React components to ease the integration with React based apps.

Froala CDN

I have started using this project today and I absolutely love it. I would like to suggest to support for Froala on CDN, it will be nice if we can just add the CDN to a project and copy and paste the code and see everything working well.

Create templates

It would be very useful to have some templates built based on the design blocks. The templates would a very good starting point for those using the Froala Design Blocks.

npm run gulp not working

npm ERR! Windows_NT 10.0.17025
npm ERR! argv "C:\Program Files\nodejs\node.exe" "C:\Program Files\nodejs\node_modules\npm\bin\npm-cli.js" "run" "gulp"
npm ERR! node v6.11.0
npm ERR! npm v3.10.10
npm ERR! code ELIFECYCLE
npm ERR! [email protected] gulp: gulp
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the [email protected] gulp script 'gulp'.
npm ERR! Make sure you have the latest version of node.js and npm installed.
npm ERR! If you do, this is most likely a problem with the froala-design-blocks package,
npm ERR! not with npm itself.
npm ERR! Tell the author that this fails on your system:
npm ERR! gulp
npm ERR! You can get information on how to open an issue for this project with:
npm ERR! npm bugs froala-design-blocks
npm ERR! Or if that isn't available, you can get their info via:
npm ERR! npm owner ls froala-design-blocks
npm ERR! There is likely additional logging output above.

npm ERR! Please include the following file with any support request:
npm ERR! C:\Users...\Desktop...\Free Templates\design-blocks\npm-debug.log

Help?

Make Froala available to the "rest of the world"

I do development and use a public hosting company---as do the majority of developers. I don't have---and don't know how to use "npm". Would you consider making a simple zip of Froala that can be used by us "unwashed?"

Thanks for your consideration

Integration with bootstrap by using their variables

I've had a look at this project for a bit and it looks really great, but one thing I don't quite understand.

While everything is built on top of bootstrap, it doesn't look like it's integrated into bootstrap.

If I use a bootstrap plugin that uses default buttons like btn-primary and btn-warning I'll have a different style on those buttons. Why not import the bootstrap scss and use their variables?

What's your idea about using the design blocks with other bootstrap components to achieve a consistent look'n'feel?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.