Skip to content

ChristopherBarroso/flowchart-fun

 
 

Repository files navigation

Flowchart Fun

Flowchart Fun is a webapp for quickly generating flowcharts from text. With a fast and intuitive workflow, you can visualize your ideas and plans in minutes.

screenshot

Features

Flowchart Fun is actively working on implementing new and innovative features! Some of are features include: -Editing with AI -Importing Data -Variety of Templates -Importing Data -Different Themes -10 Layout Designs -Different Background Colors -Different Node Shapes and Colors -Log In to Save Your Charts! Creating An Account is Quick and Easy! -Try Out FlowChart Fun Pro For a Variety of Premium Features!

📝 Example

For an example of how Flowchart Fun works, take the following input:

Node A
  goes to: Node B
  and: Node C
    goes back to: (Node A)

You can generate this flowchart with just a few clicks:

example flowchart

🛠️ Development

Before making a contribution to Flowchart Fun, you should know a little bit about the technologies we're using. After that, you should be ready to help out!

Flowchart Fun is built with React and cytoscape.js.

-React: A JavaScript library for building dynamic user interfaces based on components. -Want to familiarize yourself with React? Read the official React documentation (https://reactjs.org/docs/getting-started.html) to learn more. -Cytoscape: CytoScape is a Graph theory (network) library for visualisation and analysis. -Learn more about Cytoscape on its offical website (https://js.cytoscape.org/#introduction/factsheet).

💡 Prerequisites

If you plan on developing the premium features, you will need accounts on Vercel, Supabase, Stripe and Sendgrid.

🚀 Getting Started

  1. Clone the repository
  2. Copy .env.example to .env and add env variables
  3. pnpm install and vercel dev

🔒 To run with login features:

vercel dev

Note: You will need to create a Vercel account and install the CLI to run the app locally. To deploy the app, you will need a Pro Vercel account because it uses more than 12 serverless functions.

⚙️ To run without login features:

pnpm dev

🌐 Translations

Flowchart Fun is available in a variety of languages: -Deutsch -English -Español -Fançais -हिन्दी -한국어 -Português -中文

We welcome anyone interested in helping us add translations to Flowchart Fun. Translations can be added to the .po files located in /app/src/locales/[language]/messages.po. After adding translations, please run pnpm -F app compile. We would appreciate your help in making Flowchart Fun accessible in even more languages!

💬 Interested in Adding a Language?

Let us know about your plans in the Discord, and we'd be glad to lend a helping hand.

🧪 Tests

To ensure quality and accuracy, Flowchart Fun employs Jest for unit testing and Playwright for e2e testing.

Unit Tests

pnpm -F app test

E2E Tests

pnpm -F app e2e

🔍 Analyzing the Bundle

pnpm -F app build && pnpm -F app analyze

🤝 Contributing

If you're interested in contributing, we'd love to have your help with the underlying syntax parser - Graph Selector. Our community welcomes all contributions, big or small!

To get started, please fork the dev branch and start developing and testing your feature. If you have any questions, don't hesitate to join the discussion on Discord. We're always happy to help and answer any questions you may have.

About

Easily generate flowcharts and diagrams from text ⿻

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 88.5%
  • CSS 9.5%
  • JavaScript 1.5%
  • Other 0.5%